توفّر Protected Audience سلسلة من واجهات برمجة التطبيقات لدمج شريحة الجمهور المخصّصة وتجاهلها شرائح الجمهور كجزء من حزمة android.adservices.customaudience. بالنسبة لأغراض تصحيح الأخطاء، تتوفّر أوامر واجهة سطر الأوامر لإدراجها وعرضها شرائح الجمهور المخصَّصة. يوضِّح هذا الدليل الخطوات التي يجب أن يتّخذها مطوّرو تكنولوجيا الإعلان. اتّباعه لفحص حالة شرائح الجمهور المخصّصة التي انضمّت إليها
ضبط إعدادات الجهاز
لأسباب تتعلّق بالأمان والخصوصية، لا تظهر شرائح الجمهور المخصّصة تلقائيًا. ويمكن فحصها مباشرةً فقط لأغراض تصحيح الأخطاء. وهي مرئية فقط باستخدام هذين الأمرين في حال استيفاء المتطلبات التالية:
- تم تفعيل خيارات المطوّرين على مستوى النظام.
- تم تعريف
android:debuggable="true"في ملف AndroidManifest.xml التطبيق الذي تم انضمامCustomAudienceمنه (باستخدامjoinCustomAudienceأوfetchAndJoinCustomAudience) - تم تفعيل خيار الموافقة على الإعلانات المقترَحة من التطبيقات.
تفعيل أوامر واجهة مستخدم Adservices
- عليك إعادة تشغيل جهازك لإنهاء عملية
adservices. - تأكَّد من أنّ الحقل "
adservices" لا يعمل. يُتوقَّع وجود ناتج فارغ في الأمر التالي.
adb shell ps -A | grep adservices
لتفعيل أوامر واجهة الأوامر adservices، شغِّل الأوامر التالية:
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.
تتطابق بنية العناصر في هذا الصفيف مع ناتج طريقة العرض
المخصص لأمر الجمهور المخصص الموضح فيما يلي.
عرض جمهور مخصص محدد
لعرض جمهور مخصص معيّن، شغِّل الأمر التالي لتحديد
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.