سرفصل‌ها درس 113 از 156 · برنامه‌ها و دستگاه‌ها
برنامه‌ها و دستگاه‌ها

پروژهٔ مرحلهٔ 5: گزارش دستگاه

چرا مهم است این کار کامل است، از آغاز تا پایان: ضبطی از خانه‌ای با یک تلفن و یک تلویزیون هوشمند، و گزارشی کوتاه که برای هر دستگاه می‌گوید با چه کسی حرف می‌زند، چه شناسه‌ها و نوع‌هایی از داده می‌فرستد، و آیا دو دستگاه را می‌توان به یک شخص پیوند داد. دقیقاً همان گزارشی است که دربارهٔ خانهٔ خودتان می‌خواستید.

ضبط

hidden_capture() ضبطی با دو دستگاه در یک شبکهٔ خانگی به شما می‌دهد:

from watched.leg5b_apps import hidden_capture, SDK_OWNERS

cap = hidden_capture()
print(cap["first_party"])     # {'phone': 'StepBee', 'tv': 'ScreenMaker'}
print(len(cap["entries"]))
print(cap["entries"][0]["device"])   # 'phone' or 'tv'

first_party می‌گوید کدام شرکت نرم‌افزار هر دستگاه را ساخت (سازندهٔ برنامهٔ تلفن، و سازندهٔ تلویزیون). هر ورودی همان شکل قبل را دارد، به‌علاوهٔ "device". ارزیاب کد شما را روی ضبط‌های پنهان دیگری هم اجرا می‌کند (hidden_capture(seed) با بذرهایی که نمی‌بینید)، پس هیچ چیزی دربارهٔ این یکی را در کد ثابت ننویسید.

گزارش

گزارش شما یک dict با دو کلید است. "devices" نام هر دستگاه در first_party را به یک dict با این‌ها نگاشت می‌کند:

کلیدمقدار
"destinations"فهرست مرتب‌شدهٔ هر مالکی که آن دستگاه با آن تماس گرفت (از owner_of خودتان استفاده کنید؛ سازندهٔ خود دستگاه و "Unknown" را اگر ظاهر شدند شامل کنید)
"identifiers"فهرست مرتب‌شده، بدون تکرار، از نام‌های فیلد شناسه که با یک مقدار واقعی فرستاده شدند
"zeroed_ad_id"True اگر هر فیلدی در AD_ID_NAMES با مقدار ZERO_AD_ID فرستاده شد
"location"True اگر هر فیلدی از نوع location فرستاده شد
"acr"True اگر هر فیلدی از نوع viewing فرستاده شد
"score"امتیاز اشتراک‌گذاری ورودی‌های آن دستگاه، با مالک first_party دستگاه به‌عنوان مالک برنامه

"linked_ids" یک فهرست مرتب‌شده از مقدارهای شناسه (فقط واقعی‌ها) است که بیش از یک دستگاه فرستاد. اگر همان مقدار هم از تلفن و هم از تلویزیون بیرون برود، هر کسی که هر دو را دریافت کند می‌تواند بفهمد به یک خانوار، یا یک شخص، تعلق دارند.

پیوند میان‌دستگاهی (cross-device linking): تشخیص اینکه دو دستگاه به یک شخص تعلق دارند، معمولاً چون هر دو همان شناسهٔ حساب یا ایمیل هش‌شده را می‌فرستند. این راهی است که یک آگهی تلویزیونی و یک خرید با تلفن در یک نمایه به هم پیوند می‌خورند.

پیش از کدنویسی برنامه‌ریزی کنید

  1. owner_of، sharing_graph و sharing_score را از تمرین قبل کپی کنید.
  2. برای هر دستگاه ورودی‌هایش را فیلتر کنید: [e for e in cap["entries"] if e["device"] == device].
  3. هر فیلد را یک بار بپیمایید، با fields_of و DATA_KINDS، پرچم‌ها را تنظیم کنید و نام‌های شناسه را جمع کنید. در همین حال، ثبت کنید کدام دستگاه‌ها هر مقدار شناسهٔ واقعی را فرستادند، در یک dict از مقدار -> مجموعهٔ دستگاه‌ها.
  4. گراف را برای ورودی‌های دستگاه بسازید؛ کلیدهایش، مرتب‌شده، مقصدها هستند، و امتیاز را به شما می‌دهد.
  5. پس از همهٔ دستگاه‌ها، مقدارهایی را نگه دارید که مجموعه‌شان بیش از یک دستگاه دارد.

در پایان، گام «ارسال»: گزارش را با json.dumps(report, sort_keys=True) به متن JSON تبدیل کنید. JSON قالب متن ساده‌ای است که تقریباً هر ابزاری می‌تواند بخواند، و به همین دلیل گزارش‌ها و APIها از آن استفاده می‌کنند.

خواندن نتیجهٔ خودتان

وقتی گزارشتان را چاپ می‌کنید، به سه چیز توجه کنید. آیا تلفن zeroed_ad_id را نشان می‌دهد و همچنان شناسه‌های دیگری می‌فرستد؟ آیا تلویزیون دادهٔ viewing می‌فرستد، و به چه کسی؟ و آیا یک مقدار پیوندخورده هست؟ در این ضبط هست: ایمیل هش‌شده. یک بار ورود در هر دستگاه برای پیوند دادن آن‌ها کافی است.

دفاع

هر خط گزارش راه‌حلی پیشنهاد می‌کند: ACR را در تلویزیون خاموش کنید، در تلفن به ردیابی «نه» بگویید، فقط اگر لازم است وارد تلویزیون شوید (یا با ایمیلی دیگر)، و مکان را به «while using» محدود کنید. گزارش را دوباره روی ضبطی پس از این تغییرها اجرا کنید و امتیاز پایین می‌آید؛ آن پیش و پس، شاهد است.

در زبان‌های دیگر

JavaScript: گام پیونددادن، با یک Map از Setها.

const seen = new Map();
for (const e of cap.entries) {
  for (const [name, value] of fieldsOf(e)) {
    if (DATA_KINDS[name] === "identifier" && value !== ZERO_AD_ID && value.trim()) {
      if (!seen.has(value)) seen.set(value, new Set());
      seen.get(value).add(e.device);
    }
  }
}
const linked = [...seen].filter(([, d]) => d.size > 1).map(([v]) => v).sort();
const reportJson = JSON.stringify(report);

PHP: json_encode($report) گام ارسال را انجام می‌دهد.

خلاصه

  • یک گزارش دستگاه برای هر دستگاه مالکان تماس‌گرفته‌شده، شناسه‌های فرستاده‌شده، پرچم‌های مکان و تماشا، و یک امتیاز را فهرست می‌کند.
  • همان مقدار شناسهٔ واقعی که از دو دستگاه بیرون برود آن‌ها را به یک شخص پیوند می‌دهد.
  • JSON قالب متن ساده برای تحویل یک گزارش به ابزارهای دیگر است.
  • اجرای دوبارهٔ گزارش پس از تغییر تنظیمات به شما شاهدی می‌دهد که تنظیمات کار کردند.
نوبت شما

device_report(capture, owners) را بنویسید که گزارش توصیف‌شده در بالا را برمی‌گرداند: یک dict با "devices" (یک ورودی برای هر دستگاه در capture["first_party"]، هر کدام با destinations، identifiers، zeroed_ad_id، location، acr و score) و "linked_ids". به owner_of، sharing_graph و sharing_score از تمرین قبل هم نیاز دارید؛ آن‌ها را در این برنامه تعریف کنید. از fields_of، DATA_KINDS، AD_ID_NAMES و ZERO_AD_ID از دنیای تمرینی استفاده کنید.
سپس report = device_report(hidden_capture(), SDK_OWNERS) و report_json = json.dumps(report, sort_keys=True) را تنظیم کنید، و report_json را چاپ کنید.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.