Protected Audience API מספק סדרה של ממשקי API להצטרפות לקהלים בהתאמה אישית וליציאה מהם כחלק מandroid.adservices.customaudience package. למטרות ניפוי באגים, יש פקודות CLI שזמינות לרישום ולהצגה של קהלים בהתאמה אישית. במדריך הזה מפורטים השלבים שמפתחי טכנולוגיות פרסום צריכים לבצע כדי לבדוק את מצב הקהלים המותאמים אישית שהצטרפו אליהם.
הגדרה
מטעמי אבטחה ופרטיות, קהלים בהתאמה אישית לא מוצגים כברירת מחדל ואפשר לבדוק אותם ישירות למטרות ניפוי באגים. אפשר לראות אותן באמצעות הפקודות האלו רק אם הדרישות הבאות מתקיימות:
- האפשרויות למפתחים ברמת המערכת מופעלות
android:debuggable="true"
מוצהר בקובץ AndroidManifest.xml של האפליקציה שממנה צורףCustomAudience
(באמצעותjoinCustomAudience
אוfetchAndJoinCustomAudience
)- התכונה 'הסכמה למודעות שאפליקציות מציעות' מופעלת
הפעלת פקודות מעטפת של adservices
- צריך להפעיל מחדש את המכשיר כדי לסיים את התהליך של
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 מותאמת אישית של קהלים שמתוארת בהמשך.
הצגה של קהל ספציפי בהתאמה אישית
כדי להציג קהל ספציפי בהתאמה אישית, מריצים את הפקודה הבאה לציון 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.