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

bookmark_border تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

هناك عدد من الإعدادات التي يمكنك تفعيلها أو إيقافها للأجهزة التي تعمل بمبادرة حماية الخصوصية على 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)" على الجهاز، انقر على مفتاح التبديل.

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

في حين أنّ القسم السابق سمح لمستخدم الجهاز باختيار ما إذا كان يريد تفعيل "مبادرة حماية الخصوصية" على جهازه، يوضّح هذا القسم كيفية تفعيل IDE المطوّر على جهاز باستخدام أوامر 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

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

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

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

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.

Protected Audience

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"