يتم إيقاف بعض تكنولوجيات "مبادرة حماية الخصوصية" تدريجيًا.

اطّلِع على آخر الأخبار حول خطط تكنولوجيات "مبادرة حماية الخصوصية". تقدّم

حالة ميزة "مبادرة حماية الخصوصية" مزيدًا من المعلومات حول حالة كل واجهة من واجهات برمجة التطبيقات وميزات النظام الأساسي.

فحص شرائح الجمهور المخصّصة في سطر الأوامر

توفّر Protected Audience مجموعة من واجهات برمجة التطبيقات للانضمام إلى شرائح الجمهور المخصّصة ومغادرتها كجزء من حزمة android.adservices.customaudience. لأغراض تصحيح الأخطاء، تتوفّر أوامر واجهة سطر الأوامر (CLI) لعرض شرائح الجمهور المخصّصة. يوضّح هذا الدليل الخطوات التي يجب أن يتّبعها مطوّرو تكنولوجيات الإعلان لفحص حالة شرائح الجمهور المخصّصة المشترَكة.

الإعداد

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

تفعيل خيارات المطوّرين على مستوى النظام
يتم تعريف android:debuggable="true" في ملف AndroidManifest.xml الخاص بالتطبيق الذي تم الانضمام إلى CustomAudience منه (باستخدام joinCustomAudience أو fetchAndJoinCustomAudience)
تم تفعيل الموافقة على "الإعلانات المقترَحة من التطبيقات"

تفعيل أوامر shell الخاصة بخدمات الإعلانات

أعِد تشغيل جهازك لإنهاء عملية adservices.
تأكَّد من أنّ adservices غير قيد التشغيل. من المتوقّع أن يكون الناتج فارغًا للأمر التالي.

adb shell ps -A | grep adservices

بعد ذلك، لتفعيل أوامر adservices shell، شغِّل الأوامر التالية:

adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true

قائمة شرائح الجمهور المخصّصة

لعرض جمهور مخصّص معيّن، نفِّذ الأمر التالي مع تحديد owner كحزمة أنشأت الجمهور وbuyer كمعرّف لشبكة الإعلانات التي تدير الجمهور:

adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>

سيكون الناتج عبارة عن عنصر JSON يحتوي على مصفوفة custom_audiences. يتطابق هيكل العناصر ضِمن هذه المصفوفة مع ناتج الأمر view custom audience الموضّح أدناه.

عرض شريحة جمهور مخصّصة معيّنة

لعرض جمهور مخصّص معيّن، نفِّذ الأمر التالي مع تحديد owner كحزمة أنشأت الجمهور، وbuyer كمعرّف لشبكة الإعلانات التي تدير الجمهور، وname كاسم الجمهور:

adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>

إعادة تحميل شريحة جمهور مخصّصة معيّنة

لعرض التحديث اليومي للمشغّل يدويًا لجمهور مخصّص معيّن، نفِّذ الأمر التالي مع تحديد owner كحزمة أنشأت الجمهور، وbuyer كمعرّف لشبكة الإعلانات التي تدير الجمهور، وname كاسم الجمهور:

adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.