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

‫Protected Audience מספקת סדרה של ממשקי API להצטרפות לקהלים בהתאמה אישית וליציאה מהם כחלק מחבילת android.adservices.customaudience. למטרות ניפוי באגים, יש פקודות CLI שמאפשרות להציג קהלים בהתאמה אישית. במדריך הזה מפורטים השלבים שאנשי פיתוח של טכנולוגיות פרסום צריכים לבצע כדי לבדוק את הסטטוס של קהלים בהתאמה אישית שהם הצטרפו אליהם.

הגדרה

מטעמי אבטחה ופרטיות, קהלים בהתאמה אישית לא מוצגים כברירת מחדל, ואפשר לבדוק אותם ישירות רק למטרות ניפוי באגים. הן יוצגו רק באמצעות הפקודות האלה אם מתקיימות הדרישות הבאות:

  • האפשרויות למפתחים הופעלו בכל המערכת
  • ההרשאה android:debuggable="true" מוצהרת בקובץ AndroidManifest.xml של האפליקציה שממנה הצטרפתם אל CustomAudience (באמצעות joinCustomAudience או fetchAndJoinCustomAudience)
  • ההסכמה להצגת מודעות שאפליקציות מציעות מופעלת

הפעלת פקודות מעטפת של adservices

  1. מפעילים מחדש את המכשיר כדי להפסיק את התהליך adservices.
  2. מוודאים ש-adservices לא פועל. הפלט של הפקודה הבאה אמור להיות ריק.
adb shell ps -A | grep adservices

לאחר מכן, כדי להפעיל את פקודות ה-Shell של 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.