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

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

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

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

معاينة Android VanillaIceCream

Protected Audience API

  • لقد أصبحت إمكانية تمرير الإعلانات السياقية التي تمت مصادقتها في مزاد محمي تمت إضافتها. يشمل ذلك أيضًا الفلترة السلبية للتطبيقات المثبّتة على الجهاز، بالإضافة إلى تحديد عدد مرات الظهور على مستوى عدد النقرات ومرات الظهور والمشاهدات أو الفوز. يختلف التنفيذ عن التكرارات السابقة باعتبارها يجب أن يتم توقيع الإعلانات بواسطة تكنولوجيا الإعلان. الاطّلاع على كيفية تنفيذ ذلك في دليل المطوِّر.
  • تمت إعادة تسمية HeadlineAds إلى Signed “Ads” مع عبارة getter ذات الصلة setter في AdSelectionConfig getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • وفي حال تمرير تطبيق سياقي لم تتم مصادقته، ستتم إزالته من مزاد

Attribution Reporting API

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

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

Protected Audience API

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

Attribution Reporting API

وقت تشغيل حزمة تطوير البرامج (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

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

Attribution Reporting API

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

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

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

معاينة المطوّر 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.

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

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

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

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

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

  • يمكنك استخدام Attribution Reporting API اعتبارًا من هذا الإصدار. واجهة برمجة التطبيقات كانت تم إيقافها مسبقًا. إذا استخدمت Attribution Reporting API في التقرير السابق إصدار تجريبي، وعليك محو بيانات التطبيق أو الجهاز قبل استخدام هذا الإصدار التجريبي باتّباع إحدى الخطوات التالية:
    • على أحد الأجهزة أو المحاكيات، انتقِل إلى "الإعدادات" ومحو محتوى التطبيق مساحة التخزين (وليس ذاكرة التخزين المؤقت فقط) لأي تطبيقات تُستخدم في الاختبار.
    • أعِد ضبط الجهاز على الإعدادات الأصلية أو الجهاز في وضع المحاكاة.
    • بالنسبة إلى الجهاز الذي تمت محاكاته، نفِّذ وظيفة حجب البيانات.
  • تتيح تقارير تحديد المصدر الآن استخدام مفاتيح تصحيح الأخطاء التي تسمح للمطوّرين تلقّي تقارير غير معدَّلة وتقارير محسّنة للخصوصية من "تحديد المصدر" واجهة برمجة التطبيقات. توفر مفاتيح تصحيح الأخطاء فرصة لاكتساب رؤية أكبر حول كيفية يتم تنظيم التقارير أثناء انتقالك إلى "مبادرة حماية الخصوصية"
  • تعرّضت تقارير تحديد المصدر مؤخرًا لخطأ في الإعلان الخدمات التي يتعذّر فيها استخدام 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 إلى Protected Audience. الإعلانات، والنوع WIN غير متاح حتى الآن، وهناك فلاتر من هذا النوع وتجاهل.
  • لإعداد تقرير بمرّات الظهور الفائزة إلى المشترين الفائزين من Protected Audience من المزادات، يجب تسجيل المشترين في "مبادرة حماية الخصوصية". هذا الشرط لا يمكن تجاوزه.
  • للوصول إلى إعدادات "مبادرة حماية الخصوصية" على جهاز يتضمّن "مبادرة حماية الخصوصية" متاح، انتقل إلى الإعدادات > Google > الإعلانات > مبادرة حماية الخصوصية
  • لا يمكن نشر المشاريع باستخدام المحاكيات في Android Studio Giraffe. الإصدارات الأخرى في Android Studio تعمل بشكل جيد. سيتم طرح إصلاح في "استوديو 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 على واجهة برمجة تطبيقات Android

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

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

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

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

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

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

Topics API

  • تسمح خدمة Android Topics Classifier Colab للمطوّرين بتنفيذ ما يلي: لتكوين فهم أفضل لكيفية عمل نموذج المُصنِّف.

Attribution Reporting API

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

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

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

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

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

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

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

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

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

    adb shell device_config put adservices global_kill_switch false

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

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

Topics API

FLEDGE على واجهة برمجة تطبيقات Android

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

Attribution Reporting API

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

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

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

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

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

  • سيتم إيقاف sendData() نهائيًا في إصدار مستقبلي.
  • يعرض تطبيق "loadSdk()" الآن كائن IBinder لتسهيل الاتصال ثنائي الاتجاه. بين حزمة 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 الآن على التحقّق من صحة "تطبيق المتصل" وفقًا لمجموعة من القيود القيود الموضّحة في دليل المطوِّر. فيما يلي بعض الأمثلة البارزة.
    • يتم تحديد مدة التنفيذ في 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) ومبادرة حماية الخصوصية". تعكس نماذج التطبيقات على GitHub هذا التحديث.

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

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

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

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

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

Attribution Reporting API

يقدِّم هذا الإصدار تغييرات لتحسين الوضوح بشأن استخدام نموذج "تحديد المصدر" 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 ستصبح واجهات برمجة التطبيقات لإعداد التقارير متوفّرة في الإصدار المستقبلي.

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