توفِّر Protected Audience سلسلة من واجهات برمجة التطبيقات لدمج شرائح الجمهور المخصَّصة وتركها كجزء من حزمة android.adservices.customaudience. ولأغراض تصحيح الأخطاء، تتوفّر أوامر واجهة سطر الأوامر (CLI) لإدراج الجماهير المخصّصة وعرضها. يوضّح هذا الدليل الخطوات التي يجب أن يتّبعها مطوّرو تكنولوجيا الإعلان لفحص حالة شرائح الجمهور المخصَّصة التي انضمّت إليها.
ضبط إعدادات الجهاز
لأسباب تتعلّق بالأمان والخصوصية، لا تكون شرائح الجمهور المخصَّصة مرئية تلقائيًا ويمكن فحصها مباشرةً فقط لأغراض تصحيح الأخطاء. فهي مرئية فقط باستخدام هذه الأوامر في حال استيفاء المتطلبات التالية:
- تم تفعيل خيارات المطوّرين على مستوى النظام.
- يتم تعريف
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.
وتتطابق بنية العناصر داخل هذا الصفيف مع ناتج أمر 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.