Protected Audience یک سری API برای پیوستن و ترک مخاطبان سفارشی به عنوان بخشی از بسته android.adservices.customaudience ارائه می دهد. برای اهداف اشکال زدایی، دستورات CLI برای فهرست کردن و مشاهده مخاطبان سفارشی در دسترس هستند. این راهنما مراحلی را که توسعه‌دهندگان فناوری تبلیغات باید برای بررسی وضعیت مخاطبان سفارشی خود دنبال کنند، تشریح می‌کند.
راه اندازی
به دلایل امنیتی و حفظ حریم خصوصی، مخاطبان سفارشی به طور پیش‌فرض قابل مشاهده نیستند و فقط می‌توانند مستقیماً برای اهداف اشکال‌زدایی بازرسی شوند. آنها فقط با استفاده از این دستورات قابل مشاهده هستند که الزامات زیر درست باشد:
- گزینه های توسعه دهنده در سراسر سیستم فعال هستند
-
android:debuggable="true"در فایل AndroidManifest.xml برنامه ای کهCustomAudienceاز آنجا ملحق شده است (با استفاده ازjoinCustomAudienceیاfetchAndJoinCustomAudience) اعلام شده است. - رضایت برای تبلیغات پیشنهادی برنامه روشن است
دستورات پوسته خدمات تبلیغاتی را فعال کنید
- دستگاه خود را مجددا راه اندازی کنید تا فرآیند
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.