مخاطبان سفارشی را در خط فرمان بررسی کنید

مخاطب محافظت‌شده مجموعه‌ای از APIها را برای پیوستن و ترک مخاطبان سفارشی به عنوان بخشی از بسته android.adservices.customaudience ارائه می‌دهد. برای اهداف اشکال‌زدایی، دستورات CLI برای فهرست کردن و مشاهده مخاطبان سفارشی در دسترس هستند. این راهنما مراحلی را که توسعه‌دهندگان فناوری تبلیغات باید برای بررسی وضعیت مخاطبان سفارشی ملحق‌شده خود دنبال کنند، تشریح می‌کند.

راه‌اندازی

به دلایل امنیتی و حفظ حریم خصوصی، مخاطبان سفارشی به طور پیش‌فرض قابل مشاهده نیستند و فقط می‌توان آنها را مستقیماً برای اهداف اشکال‌زدایی بررسی کرد. آنها فقط در صورت صحیح بودن الزامات زیر با استفاده از این دستورات قابل مشاهده هستند:

  • گزینه‌های توسعه‌دهنده در سطح سیستم فعال هستند
  • android:debuggable="true" در فایل AndroidManifest.xml برنامه‌ای که CustomAudience از آنجا به آن ملحق شده است (با استفاده از joinCustomAudience یا fetchAndJoinCustomAudience ) اعلان شده است.
  • گزینه «رضایت برای تبلیغات پیشنهادی برنامه» فعال است.

فعال کردن دستورات پوسته adservices

  1. برای خاتمه دادن به فرآیند adservices دستگاه خود را مجدداً راه‌اندازی کنید.
  2. تأیید کنید که 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.