المنهج الدراسي الدرس 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 يحتوي على:

KeyValue
"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" هي قائمة مرتبة من قيم values (القيم الحقيقية فقط) التي أُرسلت من أكثر من جهاز. إذا خرجت القيمة نفسها من كل من الهاتف والتلفاز، يمكن لأي شخص يستقبل كليهما معرفة أنهما ينتميان إلى منزل واحد، أو شخص واحد.

الربط عبر الأجهزة: إدراك أن جهازين ينتميان لنفس الشخص، عادة بسبب إرسال كليهما لنفس account ID أو hashed email. هذه هي الطريقة التي يتم بها ربط إعلان تلفزيوني وعملية شراء عبر الهاتف في ملف تعريف واحد.

خطط قبل أن تكتب الكود

  1. انسخ owner_of و sharing_graph و sharing_score من التمرين السابق.
  2. لكل جهاز، قم بتصفية مدخلاته: [e for e in cap["entries"] if e["device"] == device].
  3. مرّ على كل حقل مرة واحدة، باستخدام fields_of وDATA_KINDS، مع ضبط العلامات وجمع أسماء المعرّفات. وأثناء ذلك، سجّل الأجهزة التي أرسلت كل قيمة معرّف حقيقية، في قاموس قيمة -> مجموعة الأجهزة.
  4. قم ببناء الرسم البياني لإدخالات الجهاز؛ مفاتيحها مرتبة هي الوجهات، وهي تعطيك النتيجة.
  5. بعد جميع الأجهزة، احتفظ بالقيم التي تحتوي مجموعتها على أكثر من جهاز واحد.

أخيرا، خطوة "submit": حول التقرير إلى نص JSON باستخدام json.dumps(report, sort_keys=True). تنسيق JSON هو تنسيق النص البسيط الذي يمكن لجميع الأدوات تقريبًا قراءته، وهذا هو سبب استخدام التقارير و APIs له.

قراءة نتيجتك الخاصة

عندما تطبع تقريرك، لاحظ ثلاثة أشياء. هل يظهر الهاتف zeroed_ad_id ولا يزال يرسل معرفات أخرى؟ هل يرسل التلفاز بيانات viewing، وإلى من؟ وهل هناك قيمة مرتبطة؟ في هذا الالتقاط يوجد: البريد الإلكتروني المشفر. تسجيل دخول واحد على كل جهاز كافٍ لربطهم.

الدفاع

كل سطر في التقرير يقترح حلاً: أوقف ACR على التلفاز، ارفض التتبع على الهاتف، سجل الدخول إلى التلفاز فقط إذا كنت بحاجة لذلك (أو ببريد إلكتروني مختلف)، وحدد الموقع إلى "أثناء الاستخدام". قم بتشغيل التقرير مرة أخرى على capture بعد تلك التغييرات وسينخفض score؛ هذا الفرق قبل وبعد هو الدليل.

في لغات أخرى

JavaScript: خطوة الربط، مع Map من Sets.

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) بخطوة الإرسال.

ملخص

    تدرج قائمة تقرير
  • A، لكل جهاز، المالكين الذين تم الاتصال بهم، والمعرفات المرسلة، ومواقع وعلامات العرض، ودرجة.
  • قيمة ID حقيقية واحدة تترك جهازين يربطانهما بشخص واحد.
  • 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.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.