إعداد الأجهزة لاستخدام "مبادرة حماية الخصوصية" على Android

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

عرض واجهة المستخدم الخاصة بالتحكّم في "مبادرة حماية الخصوصية"

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

للإصدارات التجريبية وإصدارات الإنتاج:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity

بالنسبة إلى المعاينة الخاصة بالمطوّرين:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity

ويتم تلقائيًا إيقاف عناصر تحكّم المستخدم على الجهاز. لتفعيل واجهة برمجة التطبيقات Privacy Sandbox API وميزة تشغيل SDK على الجهاز، انقر على مفتاح التبديل.

واجهة المستخدم للتحكّم في "مبادرة حماية الخصوصية" على جهاز Android

تفعيل "مبادرة حماية الخصوصية" على الجهاز

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

تفعيل PPAPI على الجهاز

تفعيل PPAPI

adb shell device_config put adservices ppapi_app_allow_list \"\*\"
adb shell device_config put adservices ppapi_app_signature_allow_list \"\*\"
adb shell device_config put adservices msmt_api_app_allow_list \"\*\" // for attribution
adb shell device_config put adservices adservice_system_service_enabled true
adb shell device_config put adservices adservice_enabled true
adb shell device_config put adservices adservice_enable_status true

إيقاف PPAPI

لأغراض التطوير والاختبار، يمكنك تنشيط أو إلغاء تنشيط وصول PPAPI على الجهاز عن طريق تشغيل الأوامر التالية:

اضبط النوع على false لتفعيل:

adb shell device_config put adservices global_kill_switch false

اضبط السمة على true لإيقافها:

adb shell device_config put adservices global_kill_switch true

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

adb shell device_config put adservices disable_sdk_sandbox false

بعد خطوات التسجيل

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

تحتاج إلى فرض تنزيل ملف التسجيل على جهازك من خلال تنفيذ الخطوات التالية:

1. من المفترَض أن تتلقّى رسالة إلكترونية من فريق دعم "مبادرة حماية الخصوصية" تتضمّن رقم تعريف حساب التسجيل وعنوان URL يشير إلى ملف التسجيل.

2. على الجهاز الذي يستخدم إصدار "معاينة المطوِّر"، يمكنك إلغاء قائمة التسجيل باستخدام هذا الأمر.

   adb shell device_config put adservices mdd_measurement_manifest_file_url
   "<insert URL provided>"
   

3. (اختياري ولكن يُنصح به) يؤدي التحقّق من الإلغاء إلى إرجاع المسار المحدّد في الخطوة السابقة.

   adb shell device_config get adservices mdd_measurement_manifest_file_url
   

4. تشغيل طلب بيانات من واجهة برمجة التطبيقات من إحدى واجهات برمجة التطبيقات المخصصة للحفاظ على الخصوصية (على سبيل المثال، registerSource() من Attribution Reporting API، أو getTopics() من Topics API، أو joinCustomAudience() من Protected Audience API) من المتوقع أن تفشل هذه المكالمة.

5. فرض مهمة التنزيل

   adb shell cmd jobscheduler run -f com.google.android.adservices.api  14
   

6. يمكنك الآن بدء طلب البيانات من واجهات برمجة التطبيقات للحفاظ على الخصوصية في معاينة المطوّر. من المفترض أن تنجح الآن المكالمة التي أجريتها في الخطوة 4.

إيقاف التسجيل

في إصدارات "معاينة المطوِّر"، يمكنك الوصول إلى Protected Audience API وTopics API بدون التسجيل من خلال تنفيذ أمرَي "adb" التاليَين لإيقاف التسجيل.

الجمهور المحمي

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

المواضيع

adb shell setprop debug.adservices.disable_topics_enrollment_check true

إعداد تقارير الإحالة

adb shell device_config put adservices disable_measurement_enrollment_check "true"