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.
،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.