ملاحظات إصدار "مبادرة حماية الخصوصية" على Android

توفّر "مبادرة حماية الخصوصية" على Android برنامجَي "معاينة المطور" و"الإصدار التجريبي". وسنطرح واجهات برمجة تطبيقات وميزات جديدة في معاينة المطوّر بمرور الوقت وسنروِّج لواجهات برمجة التطبيقات الثابتة في البرنامج التجريبي. نشجّعك على تقديم ملاحظات.

إذا كنت مبتدئًا في استخدام "مبادرة حماية الخصوصية" على Android، ابدأ بالاطّلاع على نظرة عامة حول البرنامج. للبدء في إنشاء "مبادرة حماية الخصوصية" في مشروعك، عليك ضبط بيئة التطوير والحصول على "مبادرة حماية الخصوصية" على Android على جهازك الاختباري أو المحاكي.

الإصدارات الحالية

معاينة Android VanillaIceCream

Protected Audience API

  • تمت إضافة إمكانية تمرير الإعلانات السياقية التي تمت مصادقتها إلى "مزاد محمي". ويشمل ذلك أيضًا الفلترة السالبة للتطبيقات المثبّتة بالفعل على الجهاز، وكذلك تحديد عدد مرات الظهور لعدد النقرات أو مرّات الظهور أو المشاهدات أو عمليات الفوز. يختلف التنفيذ عن التكرارات السابقة، إذ يجب أن توقِّع تكنولوجيا الإعلان على الإعلانات السياقية. يمكنك الاطّلاع على مزيد من المعلومات حول كيفية تنفيذ ذلك في دليل المطوّر.
  • تمت إعادة تسمية ContentAds إلى SignedContentAds بالإضافة إلى مَعلمة getter وsetter ذات الصلة في AdSelectionConfig وgetPerBuySignedContentAds وsetPerدروسSignedAds
  • في حال ضبط تطبيق سياقي لم تتم مصادقته، ستتم إزالته من المزاد.

Attribution Reporting API

تحديث الإصدار التجريبي من "مبادرة حماية الخصوصية" على Android لشهر تشرين الثاني (نوفمبر) 2023

يتضمّن هذا الإصدار من الإصدار التجريبي من "مبادرة حماية الخصوصية" على Android تحديثات لواجهات برمجة تطبيقات "مبادرة حماية الخصوصية" على أجهزة Android 14 العامة. يمكن تنزيل صور حزمة تطوير البرامج (SDK) وصور الجهاز باستخدام مدير SDK في "استوديو Android" مثل الإصدار 34 من واجهة برمجة تطبيقات Android، والمستوى 10 من الإضافة، وهي تشبه من الناحية الوظيفية [معاينة المطوِّر 9][b25]، مع بعض التعديلات الأساسية.

Protected Audience API

  • يمكن لتكنولوجيا الإعلانات الآن استخدام [تفويض الجمهور المخصّص][b26] للانضمام إلى جمهور مخصّص نيابةً عن مشترٍ لا يتوفّر لديه على الأجهزة.
  • يتيح Android الآن إجراء مزاد على خدمتَي "عروض الأسعار" و"المزادات".
  • تتوافق مزادات الجمهور المحمي مع فوترة تكلفة النقرة.
  • تتوافق الآن مزادات الجمهور المحمي وإعداد التقارير مع عناوين إصدارات البيانات لإشارات عروض الأسعار الموثوق بها.
  • تتيح مزادات الجمهور المحمي فلترة عدد مرات الظهور في أحداث WIN.
  • أصبحت ميزة Protected Audience متوافقة الآن مع [الدمج مع Attribution Reporting API][b27].

Attribution Reporting API

  • Attribution Reporting API الآن: [الدمج مع Protected Audience][b28]

وقت تشغيل حزمة تطوير البرامج (SDK)

  • قدرة حزمة SDK على تحميل حِزم تطوير برامج (SDK) أخرى ضمن وقت تشغيل SDK لدعم حالات استخدام التوسّط

الإصدارات السابقة

معاينة المطوّر 10

تاريخ الإصدار: 19 كانون الأول (ديسمبر) 2023

القيود المعروفة

  • هناك مشكلة تؤدي إلى تعطُّل "خدمات Google Play" في الخلفية وإبلاغ المستخدم بشكل متكرّر بما يلي:
    • قد تؤدي إعادة تشغيل الجهاز إلى الحد من هذه المشكلة.
    • أثناء الاختبار، إذا كنت تواجه مشكلات بشأن انتهاء مهلة الاتصالات غير المتزامنة، فحاول إضافة أمر Adb التالي لإطالة الحد الأدنى حتى انتهاء المهلة:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • جهاز فعلي فقط: إضافة حساب Google غير متاحة. اتّبِع هذه الخطوات لعرض الجهاز على الشاشة الرئيسية:
    • ثبِّت صورة المعاينة على الهاتف.
    • انتقِل إلى معالج الإعداد بدون الاتصال بشبكة Wi-Fi أو بيانات الجوّال.
    • بعد فتح الشاشة الرئيسية، عليك الاتصال بشبكة Wi-Fi أو بيانات الجوّال.
    • يُرجى إعادة تشغيل الجهاز.

Protected Audience API

  • نقدِّم إمكانات جديدة، وهي [Protected App Signals][dp98]، لدعم عرض الإعلانات ذات الصلة لتثبيت التطبيقات. من خلال نقطة البيانات هذه، سنطلق واجهات برمجة تطبيقات لتمكين تكنولوجيا الإعلان من إجراء ما يلي:
    • تنظيم الإشارات عن طريق تخزين أحداث التطبيق في مساحة تخزين محمية على الجهاز والتي يتم استخدامها لعرض الإعلانات الملائمة لتثبيت التطبيقات.
    • إجراء مزاد محمي

Attribution Reporting API

  • هذا الإصدار من Attribution Reporting API:
    • تتم إضافة دمج "الجمهور المحمي"، ما يؤدي إلى تفعيل سمات الجمهور المخصّصة في التقارير التلخيصية المجمّعة.
    • دعم مقدّم خدمة Google Cloud كمنصة تنفيذية (TEE) لخدمة التجميع
    • لإضافة الحقل Shared_debug_key لإتاحة تصحيح الأخطاء للإحالة الناجحة على جميع الشبكات بدون عمليات إعادة توجيه.
    • تضيف عناوين الإصدارات في طلبات تقارير تصحيح الأخطاء المطوّلة.

التخصيص على الجهاز

  • الإصدار الأولي للباحثين والتطوير المبكر.
  • يقدّم خيار "التخصيص على الجهاز" طريقة مبتكرة لتخصيص المنتجات والخدمات وتوفير حماية محسَّنة لخصوصية المستخدم في الوقت نفسه. على الجهاز يوفّر التخصيص مجموعة من الخدمات والخوارزميات كوحدات أساسية لتحقيق ذلك، بما في ذلك على سبيل المثال لا الحصر:
    • الحوسبة الموحّدة (FC) التي تتيح التدريب وتقييم وتخصيص النماذج باستخدام تقنية التعلّم الموحّد سيستند استخدام "الحوسبة الموحّدة" على الجهاز إلى تدريب النموذج والاستنتاج (اختياريًا إذا لزم الأمر).
    • الوقواقع المستندة إلى المطابقة والمطابقة المتبادلة بين البيانات الموجودة في أماكن مختلفة.
    • التدريب الخاص التفاضلي (DP) للنماذج المتفرقة باستخدام أساليب جديدة مثل تضييق نطاق الإدارة البديل لـ DP (للتدريب على البيانات ذات الموقع المتباين) وتخصيص النماذج ضمن لوحة الإعلانات DP. ### معاينة المطوّر 9

تاريخ الإصدار: 15 آب (أغسطس) 2023

القيود المعروفة

  • لا يتم تلقائيًا حذف بيانات المزاد التي يتم إنشاؤها من خلال طلب بيانات من "واجهة برمجة التطبيقات" و"عروض الأسعار" و"المزاد" في DP9.
  • يؤدي الاتصال بالرمزَين getAdSelectionData وpersistAdSelectionResult عند إبطال الموافقة إلى إيقاف العملية.
  • لا تعمل ميزة الفلترة السلبية مع getAdSelectionData وpersistAdSelectionResult.

Protected Audience API

Attribution Reporting API

  • يحسِّن هذا الإصدار تقارير تصحيح الأخطاء في Attribution Reporting API من خلال:
    • إتاحة تقارير تصحيح الأخطاء المطوّلة المتوافقة مع الويب
    • تفعيل تقارير تصحيح أخطاء الإحالة على المواقع الإلكترونية والتطبيقات (يتطلّب ذلك المعرِّف الإعلاني على كلٍّ من المواقع الإلكترونية والتطبيقات)
  • يمكن لتكنولوجيا الإعلانات ضبط معلَمات التشويش لسيناريوهات إعداد التقارير المختلفة.
  • ينتقل هذا الإصدار إلى الإحالة المستندة إلى المصدر، ما يعني:
    • يتم استخدام المصدر للتسجيل.
    • يتم قبول مصادر متعددة ضمن موقع إلكتروني واحد.
    • حدّ أقصى جديد لمعدّل الزحف لكل تطبيق مصدر أو عملية تسجيل.
  • يمكن لتكنولوجيا الإعلانات الآن إيقاف التسجيل لاختبار استخدام ميزة "تقارير تحديد المصدر" على الجهاز.

وقت تشغيل حزمة تطوير البرامج (SDK)

  • لا يمكن لحزمة تطوير البرامج (SDK) إلا بدء قائمة مسموح بها من الخدمات أو ربطها بها.
  • لا يمكن لحزمة تطوير البرامج (SDK) الوصول إلى مجموعة فرعية من نظام ContentProvider (مثل com.android.providers.settings.SettingsProvider)، حيث لا تحتوي البيانات التي تم الحصول عليها على المعرّفات ولا يمكن استخدامها لإنشاء بصمة رقمية للمستخدم. تنطبق عمليات التحقّق هذه أيضًا للوصول إلى ContentProvider باستخدام ContentResolver.
  • لا يمكن لحزمة تطوير البرامج (SDK) الوصول إلا إلى مجموعة فرعية من أجهزة استقبال البث المحمية (مثل android.intent.action.AIRPLANE_MODE).
  • ويمكن لحزمة تطوير البرامج (SDK) تشغيل نشاط ينتمي إلى تطبيق آخر ولكن مع فرض قيود على ما يمكن إرساله في Intent.

تحديث الإصدار التجريبي من "مبادرة حماية الخصوصية" على Android لشهر آذار (مارس) 2023

يتضمّن الإصدار التجريبي من "مبادرة حماية الخصوصية" على Android في آذار (مارس) 2023 تحديثات على واجهات برمجة تطبيقات "مبادرة حماية الخصوصية" على أجهزة Android 13 العامة. يتضمّن هذا الإصدار واجهات برمجة تطبيقات إضافات الخدمات الإعلانية 5 ويشبه عمليًا إصدار معاينة المطوِّر 6، مع بعض التعديلات الأساسية.

القيود المعروفة

  • تؤدي مهمة الاسترجاع في الخلفية التي يتم تشغيلها بشكل دوري لتحديث الجماهير المخصّصة في FLEDGE إلى تعطُّل العملية. بسبب هذه المشكلة، يتم إيقاف FLEDGE تلقائيًا.

الإعدادات العامة

  • يمكنك استخدام Attribution Reporting API اعتبارًا من هذا الإصدار. تم إيقاف واجهة برمجة التطبيقات في السابق. إذا كنت تستخدم Attribution Reporting API في الإصدار التجريبي السابق، عليك محو بيانات التطبيق أو الجهاز قبل استخدام هذا الإصدار التجريبي، وذلك باتّباع إحدى الخطوات التالية:
    • على جهاز أو محاكي، انتقِل إلى "الإعدادات" ومحو مساحة التخزين الخاصة بالتطبيقات (وليس ذاكرة التخزين المؤقت فقط) لأي تطبيقات تُستخدم للاختبار.
    • أعِد ضبط الجهاز على الإعدادات الأصلية على الجهاز الفعلي أو الذي في وضع المحاكاة.
    • وبالنسبة إلى الجهاز الذي تمت محاكاته، يمكنك تنفيذ وظيفة حجب البيانات.
  • أصبحت ميزة "تقارير تحديد المصدر" متوافقة الآن مع مفاتيح تصحيح الأخطاء، والتي تتيح للمطوّرين تلقّي تقارير لم يطرأ عليها أي تغيير في ما يتعلّق بالخصوصية من خلال Attribution واجهة برمجة التطبيقات. توفّر مفاتيح تصحيح الأخطاء فرصةً للتعرّف بشكل أكبر على كيفية هيكلة التقارير أثناء الانتقال إلى "مبادرة حماية الخصوصية".
  • واجهت ميزة إعداد تقارير الإحالة مؤخرًا خطأً في "خدمات الإعلانات" فشل registerSource وregisterTrigger مع بعض الاستثناءات. إذا واجهت هذه المشكلات أثناء التطوير، فقد تم طرح إصلاح ومن المفترض أن يتم حل هذه المشكلات بمرور الوقت.
  • أصبحت وظيفة معاينة Topics API الآن متكافئة مع ميزة "مبادرة حماية الخصوصية" على برنامج "معاينة المطوِّرين على Android". يمكن لمتصل Topics API معاينة المواضيع بدون تضمين طلب استرداد المواضيع في الحساب الأسبوعي للحقبة أو التأثير على قائمة المواضيع المرصودة للمتصل. راجِع الحقل shouldRecordObservation للاطّلاع على التفاصيل.

  • لتفعيل الاختبار في FLEDGE على Android، يمكنك التسجيل في البرنامج التجريبي واستخدام حساب Google نفسه لتسجيل الدخول إلى أجهزتك الاختبارية. وإذا لم تفعل ذلك، تؤدي محاولات استدعاء واجهات برمجة التطبيقات إلى ظهور IllegalStateException برسالة "الخدمة غير متاحة". يجب إعادة FLEDGE في الإصدار التجريبي التالي.

    إلى ذلك الحين، يمكن أن يستمر الاختبار باستخدام "معاينة المطوِّر" ويمكن تشجيعه على هذا الاختبار، ويمكن تفعيل FLEDGE يدويًا على الأجهزة التي تتضمّن المحاذير التالية:

    يمكنك تفعيل FLEDGE باستخدام أوامر adb التالية. ومع ذلك، يؤدي ذلك إلى تعطُّل عملية الجلب في الخلفية، ما يؤثر سلبًا في مقاييس سلامة النظام. هذا ليس حلاً نهائيًا، إذ يمكن إعادة ضبط هذه القيم من خلال المنصة.

    adb shell device_config set_sync_disabled_for_tests persistent
adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
adb shell device_config put adservices fledge_background_fetch_enabled true

الإصدارات السابقة

معاينة المطوّر 8

تاريخ الإصدار: 23 أيار (مايو) 2023

القيود المعروفة

  • في حين يمكن إضافة فلاتر تحديد عدد مرات الظهور المكتوبة WIN إلى إعلانات الجمهور المحمي، فإن النوع WIN غير متاح حتى الآن، ويتم تجاهل الفلاتر من هذا النوع.
  • من أجل الإبلاغ عن مرات الظهور الفائزة للمشترين الفائزين في "مزادات الجمهور المحمي"، يجب أن يكون المشترون مسجَّلين في "مبادرة حماية الخصوصية". لا يمكن تجاوز هذا المطلب.
  • للوصول إلى إعدادات "مبادرة حماية الخصوصية" على جهاز تتوفّر فيه "مبادرة حماية الخصوصية"، انتقِل إلى الإعدادات > Google > الإعلانات > مبادرة حماية الخصوصية.
  • يتعذّر نشر المشاريع باستخدام المحاكيات على أداة Giraffe من "استوديو Android". من المفترض أن تعمل الإصدارات الأخرى من استوديو Android بشكل جيد. سيتم طرح إصلاح في أداة Giraffe من "استوديو Android" في 26 أيار (مايو) 2023.

Protected Audience API

Attribution Reporting API

  • تمت إضافة فلاتر "أو" المشغِّل. هذا يعني أن عوامل التصفية تتكون الآن من مجموعة فلاتر، وهي قائمة بخرائط عوامل التصفية. وإذا لم يتطابق أي من تعيينات الفلاتر في المجموعة مع بيانات فلتر المصدر، يتم تجاهل الكائن event_trigger_data.
  • تم فصل فترة انتهاء صلاحية مرّات الظهور وفترة إعداد التقارير الخاصة بواجهات برمجة التطبيقات للتجميع وعلى مستوى الحدث.
  • تمت إتاحة استخدام مفاتيح إزالة التكرار في التقارير القابلة للتجميع.
  • تمت إضافة scheduled_report_time إلى تقارير الفعاليات لتحقيق التكافؤ مع مبادرة حماية الخصوصية للويب.
  • تم تنفيذ تحديد المصدر على جميع الشبكات بدون عمليات إعادة توجيه.

وقت تشغيل حزمة تطوير البرامج (SDK)

معاينة المطوّر 7

تاريخ الإصدار: 26 كانون الثاني (يناير) 2023

FLEDGE في واجهة برمجة تطبيقات Android

  • تمت إعادة تسمية المعلَمة custom_audience_signals في طرق JavaScript التالية:
    • تم تغيير اسم generateBid() إلى custom_audience_bidding_signals.
    • تم تغيير اسم scoreAd() إلى custom_audience_scoring_signals.
    • تم تغيير اسم reportWin() إلى custom_audience_reporting_signals.
  • يضيف هذا الإصدار عنصر إلغاء selectAds جديدًا يأخذ AdSelectionFromOutcomeConfig لمقارنة نتائج selectAds. يتيح ذلك لحِزم تطوير البرامج (SDK) لتكنولوجيا الإعلانات التي تستفيد من واجهة برمجة التطبيقات هذه تنفيذ توسّط العرض الإعلاني بدون انقطاع. ويمكنك الاطّلاع على مزيد من التفاصيل في دليل المطوِّر.
  • تتيح واجهة برمجة تطبيقات selectAds() الآن التخزين المؤقت لعروض الأسعار ومنطق النتائج التي يتم جلبها من خلال JavaScript أثناء عملية اختيار الإعلان.
    • يمكن التحكّم في ذاكرة التخزين المؤقت من خلال عناوين Cache-Control التي تعرضها الخوادم أثناء طلب استرجاع JavaScript. يمكنك استخدام no-cache أو no-store لمنع التخزين المؤقت لردود JavaScript، وضبط الحد الأقصى للعمر للتحكم في مدة ذاكرة التخزين المؤقت.
    • تم ضبط الإدخال الحالي لذاكرة التخزين المؤقت max-age على يومين تلقائيًا.

Attribution Reporting on Android API

  • يتيح هذا الإصدار استخدام عمليات إعادة توجيه سلسلة العلامات المتتالية لكل من registerSource() وregisterTrigger(). يمكن لمستهلك واجهة برمجة التطبيقات الآن استخدام إعادة توجيه HTTP كاستجابة للخادم.

الإصدار التجريبي الأوّلي، كانون الثاني (يناير) 2023

تاريخ الإصدار: 9 كانون الثاني (يناير) 2023

تمثّل "مبادرة حماية الخصوصية" على الإصدار التجريبي 1 من Android أوّل مدى توفّر لواجهات برمجة تطبيقات "مبادرة حماية الخصوصية" على الأجهزة العامة، وتضيف تحسينات إلى المناطق المدرَجة بعد ذلك.

الإعدادات العامة

  • إنّ "مبادرة حماية الخصوصية" على الإصدار التجريبي 1 من Android تعادل من الناحية العملية معاينة المطوّر 5، مع بعض الميزات والقيود الإضافية المُدرَجة أدناه.
  • على المطوّرين إكمال عملية التسجيل لاستخدام واجهات برمجة التطبيقات المرتبطة بالإعلانات (بما في ذلك Topics وFLEDGE وإعداد تقارير تحديد المصدر). تتحقّق عملية التسجيل من هوية المطوّر وتجمع البيانات الخاصة بالمطوّر التي تحتاجها واجهات برمجة التطبيقات.
  • من خلال الإصدار التجريبي 1 من "مبادرة حماية الخصوصية" على Android، يمكن للمطوّرين الذين سجّلوا تفاصيلهم وأرسلوها إلى القائمة المسموح بها أن تتاح لهم فرصة الاختبار على أجهزتهم الفعلية. للتطوير مقارنةً بواجهات برمجة التطبيقات الثابتة في الإصدار، نزِّل إضافات خدمات حزمة تطوير البرامج (SDK) الإعلانية 4 الجديدة.

Topics API

Attribution Reporting API

  • تم إيقاف ميزة إعداد تقارير تحديد المصدر ولن تكون متاحة للاستخدام في هذا الإصدار. ويجب إعادة تفعيل إمكانية الوصول إلى واجهة برمجة التطبيقات هذه في الإصدار التجريبي التالي. ننصحك بمواصلة إجراء الاختبارات باستخدام ميزة "معاينة المطوِّر".

وقت تشغيل حزمة تطوير البرامج (SDK)

من المتوقع إصلاح القيود التالية في الإصدار الرئيسي التالي لنظام Android الأساسي:

  • في الوقت الحالي، لا يعمل عرض الإعلانات بشكل صحيح ضمن طريقة عرض قابلة للتمرير مثل RecyclerView. قد يتم تعطيل البيانات في حال تغيير حجم العنصر. لا يتم تمرير أحداث التمرير باللمس للمستخدم إلى وقت التشغيل بشكل صحيح.
  • لا يتوفّر عرض WebView في عملية "وقت تشغيل SDK".
  • لا تتوفر مساحة تخزين لكل حزمة SDK.
  • لم يتم تفعيل دعم واجهتَي برمجة التطبيقات getAdId وgetAppSetId بعد.

معاينة المطوّر 6

تاريخ الإصدار: 31 تشرين الأول (أكتوبر) 2022

تضيف "مبادرة حماية الخصوصية" في الإصدار 6 من "معاينة المطوِّر" من Android تحسينات إلى الجوانب التالية:

الإعدادات العامة

  • استعدادًا لطرح الإصدار العلني، طرح الإصدار 6 من "معاينة المطوِّر" علامة لإيقاف الوصول تلقائيًا إلى واجهة برمجة التطبيقات التي تحافظ على الخصوصية. لأغراض الاختبار، يمكنك تفعيل الوصول إلى واجهة برمجة التطبيقات Privacy-Preserve API في معاينة المطوّر من خلال تنفيذ الأمر التالي:

    adb shell device_config put adservices global_kill_switch false

  • تتطلّب واجهتا برمجة التطبيقات AdIdManager وAppSetIdManager استخدام الإصدار 22.36.16 أو الإصدارات الأحدث من خدمات Google Play.

    • على الجهاز الذي يعمل بنظام التشغيل Android، تحقق من أن الإصدار الصحيح مدرج ضمن الإعدادات > التطبيقات > خدمات Google Play.
    • إذا كنت بحاجة إلى تحديث "خدمات Google Play" إلى الإصدار المناسب، سجِّل الدخول على جهاز اختبار Android أو محاكيه باستخدام حساب Google. بعد ذلك، انتقِل إلى متجر Google Play > رمز الملف الشخصي > الإعدادات > لمحة. انقر على تحديث "متجر Play" ضمن العنوان إصدار "متجر Play".
    • لا تنطبق هذه الخطوة إلا على عمليات التطوير والاختبار، ولن تكون مطلوبة بعد طرح "مبادرة حماية الخصوصية" للمستخدمين بشكل علني.

Topics API

  • تمت إضافة Preview API لتحديد ما إذا كان سيتم تسجيل getTopics كمراقب أو لا.
  • تم إجراء تغييرات طفيفة على رمز الإعداد لصف واحد (GetTopicsRequest).
  • تم إصدار دليل دمج المواضيع.

FLEDGE في واجهة برمجة تطبيقات Android

  • في حال إجراء اختبار على خوادم حقيقية، يتم الآن فرض تفعيل واجهة برمجة التطبيقات. يُرجى اتّباع هذه الخطوات لضبط إعدادات جهازك. هذه الخطوات غير مطلوبة إذا كنت تستخدم عمليات الإلغاء عن بُعد المتوفّرة في نموذج التطبيق.
  • التغييرات التي قد تؤدي إلى :
    • تم استبدال Url في المعلَمات بـ Uri. ينطبق ذلك على جميع واجهات برمجة تطبيقات FLEDGE وJavaScript المخصّص لعرض الأسعار ومنطق النتائج.
    • تمت إزالة الحقل owner من إدخالات Custom Audience API.
  • أصبحت الجماهير المخصّصة غير المكتملة الآن مؤهَّلة على الفور لإعادة تحميل الخلفية.
  • تم الآن ضبط حد ذاكرة JavaScript على 10 ميغابايت. ينطبق هذا على منطق عروض الأسعار والنتائج.

Attribution Reporting API

  • يجب أن تتسجّل تكنولوجيا الإعلان قبل أن تتمكّن من استخدام Attribution Reporting API في Developer Preview 6. يُرجى الاطّلاع على مقالة التسجيل في حساب "مبادرة حماية الخصوصية" لمزيد من المعلومات.
  • يقدّم هذا الإصدار مفاتيح تصحيح الأخطاء التي تتيح للمطوّرين تلقّي تقارير غير معدَّلة، بالإضافة إلى التقارير المحسّنة بالخصوصية من Attribution Reporting API. توفّر مفاتيح تصحيح الأخطاء فرصةً لزيادة مستوى الاطّلاع على كيفية تنظيم التقارير أثناء الانتقال باستخدام "مبادرة حماية الخصوصية".

معاينة المطوّر 5

الإعدادات العامة

  • قبل أن تتمكّن من الوصول إلى واجهات برمجة تطبيقات "مبادرة حماية الخصوصية" في الإصدار 5 من "معاينة المطوِّر"، عليك أولاً تفعيل واجهات برمجة التطبيقات وإعداد الأذونات الخاصة بواجهة برمجة التطبيقات.
    • تسمح تصاميم "مبادرة حماية الخصوصية" على Android للمستخدمين بالتحكّم في تفعيل واجهات برمجة التطبيقات التي تحافظ على الخصوصية و"وقت تشغيل SDK" على أجهزتهم. يتم ضبط هذه الإعدادات على خيار الإيقاف تلقائيًا في الإصدار 5 من "معاينة المطوِّر". يمكنك تفعيل الوصول إلى واجهة برمجة التطبيقات باستخدام أمر adb.
    • يجب أن يحدّد تطبيق المتصل الأذونات الخاصة بواجهة برمجة التطبيقات في ملف البيان وإعدادات AdServices ذات الصلة التي تتحكّم في الوصول إلى حِزم تطوير البرامج (SDK) المضمّنة.
  • يجب أن تستدعي التطبيقات واجهات برمجة التطبيقات التي تحافظ على الخصوصية عند تشغيلها في المقدّمة.
  • AdIdManager وAppSetIdManager غير متاحين حاليًا. وسيتم تفعيلها في إصدار لاحق.

وقت تشغيل حزمة تطوير البرامج (SDK)

  • سيتم إيقاف sendData() نهائيًا في إصدار مستقبلي.
  • تعرض "loadSdk()" الآن عنصر Ilider لتسهيل الاتصال الثنائي بين حزمة تطوير البرامج (SDK) التي يتم تفعيلها في وقت التشغيل والتطبيقات المحدّدة في AIDL.
  • يمكن للتطبيقات الوصول إلى المزيد من أحداث مراحل نشاط حزمة تطوير البرامج (SDK) التي يتم تفعيلها في وقت التشغيل، مثلاً عند إنهاء عملية حزمة تطوير البرامج (SDK).

Attribution Reporting API

يقدّم هذا الإصدار ميزات إضافية في Attribution Reporting API، بما في ذلك:

  • إتاحة تقرير التجميع المشفر.
  • إتاحة القياس على الويب والتطبيقات على مستوى التطبيقات:
  • العناوين المدمجة في المصدر واستجابات التسجيل:
    • المصدر: "Attribution-Reporting-Register-Aggregatable-Source" أصبح الآن جزءًا من "Attribution-Reporting-Register-Source"
    • عامل التشغيل: تم دمج Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data وAttribution-Reporting-Register-Aggregatable-Values في عنوان واحد باسم Attribution-Reporting-Register-Event-Trigger
    • لا يزال Attribution-Reporting-Redirects عنوانًا منفصلاً

FLEDGE في واجهة برمجة تطبيقات Android

يتضمّن هذا الإصدار عدّة ميزات وتحسينات جديدة، بالإضافة إلى تغييرات قد تؤدي إلى عطل:

  • التغييرات التي قد تؤدي إلى :
    • تمت إعادة تسمية runAdSelection() إلى selectAds().
    • تم استبدال معلَمة AdSelectionConfig.Builder.setAdSelectionSignals() بـ AdSelectionSignals، الذي يمثّل كائن JSON.
    • تم استبدال استخدام String لتمثيل بائع أو مشتري تكنولوجيا الإعلان باستخدام العنصر AdTechIdentifier.
    • تمت إضافة صفَي TestCustomAudienceManager وTestAdSelectionManager لإلغاء جلب JavaScript عن بُعد.
    • ويجب أن يكون مالك الجمهور المخصّص هو اسم حزمة تطبيق الاتصال.
  • تعمل واجهات FLEDGE API الآن على التحقّق من صحة تطبيق المتصل بالاستناد إلى مجموعة من القيود والقيود الموضّحة في دليل المطوِّر. فيما يلي بعض الأمثلة البارزة.
    • أصبح لدى selectAds وreportImpression الآن حدود زمنية للتنفيذ، وسيتم بعدها إنهاء المكالمة.
    • الحد الأقصى للذاكرة المستخدمة حاليًا في الترميزَين selectAds وreportImpression أثناء تنفيذ JavaScript. ستعرض واجهات برمجة التطبيقات رسالة خطأ إذا تجاوز استهلاك الذاكرة الحدود التي تم إعدادها.
    • selectAds وreportImpression يتحققان الآن من صحة الكائن AdSelectionConfig للتأكد من أنّ الحقول صالحة من ناحية البنية وأنّ عناوين URL تقع ضمن eTLD+1 المستخدَم في حقل البائع.
    • يعمل AdServices الآن على التحقّق من صحة الجماهير المخصّصة في وقت الإنشاء. وتشمل بعض مراحل عملية التحقّق هذه التأكّد من صلاحية وقت انتهاء الصلاحية وتطبيق حدًا أقصى لعدد الجماهير المخصّصة التي يمكن للتطبيق إنشاؤها والحجم الإجمالي للإعلانات المقدَّمة في طلب joinCustomAudience. تضمن عملية التحقق أيضًا أنّ معرّفات الموارد المنتظمة (URI) للإشارات واسترداد منطق عروض الأسعار والجلب في الخلفية تندرج جميعها ضمن نطاق المشتري.
  • يتم تعديل البيانات الوصفية للجمهور المخصّص يوميًا من خلال عملية جلب في الخلفية.
  • تتم إزالة الجماهير المخصّصة عند إلغاء تثبيت تطبيق "المالك".
  • تمت إضافة الدعم لتحديد إشارات النتائج الموثوق بها وبيانات عروض الأسعار الموثوق بها أثناء اختيار الإعلانات. اطّلِع على نموذج الرمز لتنسيق الردّ.
  • يعتمد FLEDGE لواجهات برمجة تطبيقات Android على الإصدار 105.0.5195.58 أو إصدار أحدث من WebView. لمزيد من التفاصيل، يُرجى مراجعة معلومات الإعداد في دليل المطوِّرين.

  • المشاكل المعروفة:

    • عند الانضمام إلى جمهور مخصّص، لا تُجري المنصة حاليًا أي تعديلات في الخلفية على الفور، إذا كانت أي من البيانات الوصفية أو قيم AdData فارغة أو null. لن يكون الجمهور المخصّص مؤهَّلاً لاختيارات الإعلانات إلى أن يتمّ تعديله بعد يوم واحد. وسيؤدي الإصدار المستقبلي إلى جعل الجماهير المخصّصة غير المكتملة مؤهَّلة فورًا للحصول على تحديثات الجلب في الخلفية. إنّ الحد الأقصى التلقائي الحالي للذاكرة لتنفيذ JavaScript منخفض جدًا وقد يؤدي إلى تعطُّل أعباء العمل العادية في JavascriptEngine على الأجهزة. قد تنتهي عملية تنفيذ JavaScript بشكل غير متوقّع مع ظهور رسالة الخطأ "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      يمكنك حلّ هذه المشكلة يدويًا من خلال ضبط الحدّ الأدنى المناسب للذاكرة باستخدام الأمر التالي:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • ويتم تحديث إعلانات الجمهور المخصّص التي لا تتطابق مع بنية JSON المطلوبة أثناء الجلب في الخلفية.

Topics API

تعديلات على الأدوات

يتيح Android Studio Canary إمكانية إنشاء حِزم APK باستخدام حزمة تطوير برامج (SDK) باستخدام نوع جديد من الوحدات. تم تعديل دليل المطوّر لوقت تشغيل حزمة تطوير البرامج (SDK)، ويعكس هذا التعديل نموذج تطبيقات "مبادرة حماية الخصوصية" على GitHub.

معاينة المطوّر 4

تاريخ الإصدار: 14 تموز (يوليو) 2022

تضيف "مبادرة حماية الخصوصية" في الإصدار 4 من "معاينة المطوِّر" من Android تحسينات إلى الجوانب التالية:

وقت تشغيل حزمة تطوير البرامج (SDK)

  • يمكن للتطبيقات الآن التواصل مع حِزم تطوير البرامج (SDK) المفعّلة في وقت التشغيل من خلال إضافة sendData().
  • تتوفّر الآن مساحة التخزين المحلية في عملية "وقت تشغيل SDK".
  • يمكن لحزمة تطوير البرامج (SDK) أيضًا عرض إعلانات أو محتوى مستقلّ تستند إلى فيديو في "وقت تشغيل SDK".
  • تمت إضافة توضيحات حول استخدام الانعكاس لتضمين إمكانية استخدام الانعكاس بشرط ألّا يكون المحتوى مدرَجًا في حزمة RE-SDK أخرى.

Attribution Reporting API

يقدّم هذا الإصدار تغييرات لزيادة الوضوح بشأن استخدام Attribution Reporting API، مثل:

  • تغييرات في تنسيق التقرير المجمّع لتحسين إمكانية القراءة
  • تم تعديل حقول العناوين لميزات "فلترة الإحالات الناجحة" و"إمكانية تقديم عروض الأسعار".
  • تمت إضافة توضيحات في مرجع واجهة برمجة التطبيقات WebApp API لشرح تسجيل المصدر والعامل المشغِّل، وكذلك مدى توفّر واجهة برمجة التطبيقات المتعلّقة بالخصوصية والموافقة.

FLEDGE في واجهة برمجة تطبيقات Android

يتضمّن هذا الإصدار ميزات جديدة للمساعدة في الاختبار وتصحيح الأخطاء، بالإضافة إلى تحسينات داخلية:

  • تمت إضافة إمكانية تجاوز عناوين URL البعيدة لاسترداد منطق JavaScript أثناء التطوير.
  • تم تحسين ميزة إعداد تقارير الأخطاء أثناء اختيار الإعلانات.
  • تتم الآن فلترة الجماهير المخصّصة غير النشطة أثناء اختيار الإعلان.

Topics API

يتضمّن هذا الإصدار عدّة تغييرات مهمة على Topics API، والأهم من ذلك:

  • تم تغيير نوع إرجاع واجهة برمجة التطبيقات getTopics() إلى نوع العنصر الجديد Topic الذي يحتوي على أرقام تعريف أعداد صحيحة تتوافق مع المواضيع في التصنيف، ومعلومات حول المصنِّف وإصدارات التصنيف. يجب تحديث أي تطبيقات حالية باستخدام واجهة برمجة التطبيقات هذه.
  • تتطلّب Topics API الآن إذنًا عاديًا جديدًا.
  • مقدمة عن نظام "المصنِّف على الجهاز" لتعيين المواضيع ديناميكيًا بناءً على معلومات التطبيق المتاحة للجميع.

المشاكل المعروفة

  • لم يتم تحميل الإصدار الأولي من صور الجهاز هذه (النسخة 6) على الإصدار 31.2.10 من محاكي Android. تم توفير صور الأجهزة المحدَّثة التي تعالج المشكلة اعتبارًا من 27 تموز (يوليو) 2022.

معاينة المطوّر 3

تاريخ الإصدار: 9 حزيران (يونيو) 2022

تضيف "مبادرة حماية الخصوصية" في الإصدار 3 من "معاينة المطوِّر" من Android وظائف لواجهة برمجة التطبيقات Attribution Reporting API وFLEDGE على Android.

Attribution Reporting API

تعمل Attribution Reporting API على تحسين خصوصية المستخدمين عن طريق إلغاء الاعتماد على معرِّفات المستخدمين من جهات خارجية مختلفة، وتوفِّر حالات الاستخدام الرئيسية لتحديد المصدر وقياس الإحالات الناجحة في جميع التطبيقات.

يتضمّن هذا الإصدار موارد المطوّرين لمساعدتك في اختبار ميزات Attribution Reporting API التالية:

  • تسجيل مصدر الإحالة وأحداث التشغيل
  • تحديد أولوية المصادر وعملية تحديد المصدر بعد التثبيت
  • تلقّي تقارير الأحداث
  • تلقّي تقارير مجمّعة غير مشفّرة في هذا الإصدار

يتم توفير نموذج تطبيق وخادم مرجعي لتكنولوجيا الإعلان للمساعدة في إجراء الاختبار.

المشاكل المعروفة:

FLEDGE على نظام التشغيل Android

يقدّم FLEDGE على Android طريقة جديدة لعرض الإعلانات استنادًا إلى شرائح الجمهور المخصّصة التي يحدّدها مطوّرو التطبيقات والتفاعلات داخل تطبيقاتهم. ويعمل هذا الحل على تخزين المعلومات والإعلانات المرتبطة بها محليًا، كما يوفّر إطارًا لتنسيق عمليات اختيار الإعلانات.

يتضمّن هذا الإصدار موارد المطوّرين لمساعدتك في اختبار FLEDGE التالي على ميزات Android:

  • ضم جمهورًا مخصّصًا أو تركه وملاحظة كيفية تأثير قيم المَعلمات في نتائج المزاد
  • استرجاع رمز مزاد JavaScript من نقاط النهاية البعيدة
  • ضبط وبدء مزادات الإعلانات على الجهاز فقط
  • التعامل مع إعداد تقارير مرات الظهور
  • يتم تقديم نموذج ضبط للتطبيق وخادم وهمي للمساعدة في الاختبار

المشاكل المعروفة:

  • يمكن لجمهور مخصّص أن يشارك في اختيار الإعلانات حتى قبل "وقت تفعيله".

معاينة المطوّر 2

تاريخ الإصدار: 17 أيار (مايو) 2022

تتضمن معاينة المطوّرين 2 معاينات مبكرة لواجهات برمجة تطبيقات إعداد تقارير الإحالة في MeasurementManager.

  • يمكنك الاتصال بالرمزَين registerSource() وregisterTrigger() لتسجيل أحداث إعلانات التطبيقات وتلقّي بيانات إعداد التقارير على مستوى الحدث من أجل تحديد مصدر الإحالات الناجحة من تطبيق إلى تطبيق. وتستخدِم عملية التنفيذ الحالية إحالة النقرة الأخيرة. تمّت جدولة إرسال التقارير على النحو المحدّد في نوافذ إعداد التقارير. يمكنك الرجوع إلى مرجع واجهة برمجة التطبيقات MeasurementManager للاطّلاع على مزيد من المعلومات.

  • يتم تحميل التقرير الفعلي في نهاية فواصل زمنية ثابتة، بدلاً من الوقت المحدد في الوقت المحدد. إنّ الفاصل الزمني لتحميل التقارير هو 4 ساعات تلقائيًا، ولكن يمكن تجاوزه باستخدام أمر adb التالي:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • وسيتم نشر نموذج تطبيق وخادم مرجعي لتكنولوجيا الإعلان لاختبار واجهات برمجة التطبيقات في إصدار مستقبلي.

  • ستتوفر في إصدار لاحق ميزات أخرى في واجهة برمجة التطبيقات لإعداد تقارير تحديد المصدر في MeasurementManager، مثل إعداد التقارير المجمّعة وتحديد المصدر بعد التثبيت وعمليات إعادة التوجيه.

معاينة المطوّر 1

تاريخ الإصدار: 28 نيسان (أبريل) 2022

تتضمّن معاينة المطوّرين 1 معاينات مبكرة لواجهة Topics API ووقت تشغيل حزمة تطوير البرامج (SDK). ستصبح وظائف FLEDGE على Android وAttribution Reporting API متاحةً في إصدار مستقبلي.

  • Topics API
    • تعرض واجهة برمجة التطبيقات getTopics() حاليًا قيم الاختبار استنادًا إلى التصنيف بلا اتصال بالإنترنت لمجموعة محدودة من التطبيقات. لم يتم تنفيذ التصنيفات على الجهاز بعد.
    • يمكنك استخدام أوامر adb لتجاوز فواصل الفترة وحساب بدء فرض الفرض.
    • لمعرفة التفاصيل، يمكنك قراءة دليل مطوّري المواضيع.
  • وقت تشغيل حزمة تطوير البرامج (SDK)
    • يمكنك إنشاء حزمة وإنشاء حِزم تطوير برامج (SDK) (RE SDK) يتم تفعيلها في وقت التشغيل باستخدام عنصر <sdk-library> الجديد في ملف البيان الخاص بتطبيق SDK. ثبِّت حزم RE SDK على جهاز اختباري أو محاكي متوافقَين كما تفعل عادةً عند تثبيت التطبيق أثناء تطويره.
    • يمكنك دمج تطبيق مع حِزم تطوير البرامج (SDK) الخاصة بـ RE، وتحميلها في "وقت تشغيل SDK" واختبار تأثير الوصول المشروط إلى رمز SDK، أي الأذونات والذاكرة ومراسلات التطبيق إلى حزمة SDK. لم يتم بعد تنفيذ واجهات برمجة تطبيقات التخزين لحزم RE SDK، وستصبح متوفرة في إصدار مستقبلي.
    • يمكن لحزمة تطوير البرامج (SDK) عرض إعلانات بانر المستندة إلى WebView أو محتوى في "وقت تشغيل SDK".
    • يُرجى الاطّلاع على دليل مطوّري برامج وقت تشغيل حزمة تطوير البرامج (SDK) للحصول على مزيد من المعلومات.
  • عمليات فحص Android Lint
    • قد تعرض عمليات فحص Android Lit بشكل غير صحيح تحذيرات في المشاريع المجمّعة بمستوى واجهة برمجة التطبيقات TiramisuPrivacySandbox. على سبيل المثال، قد تظهر لك رسالة التحذير: "يتطلّب الاتصال المستوى 33 من واجهة برمجة التطبيقات". يمكنك حلّ هذه المشكلة مؤقتًا باستخدام تعليق @SuppressLint("NewApi") التوضيحي.