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