בדיקת קהלים בהתאמה אישית בשורת הפקודה

Protected Audience API מספק סדרה של ממשקי API להצטרפות וליציאה מהתאמה אישית קהלים כחלק מandroid.adservices.customaudience package. עבור למטרות ניפוי באגים יש פקודות 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. מבנה הרכיבים במערך הזה תואם לפלט של התצוגה הפקודה 'קהל בהתאמה אישית' שמתוארת בהמשך.

הצגה של קהל ספציפי בהתאמה אישית

כדי להציג קהל ספציפי בהתאמה אישית, מריצים את הפקודה הבאה שמציינת 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.