הגדרת מכשירים לשימוש בארגז החול לפרטיות ב-Android

יש כמה הגדרות שאפשר להפעיל או להשבית במכשירים הפעלת ארגז החול לפרטיות ב-Android.

הצגת ממשק המשתמש לבקרת המשתמשים של ארגז החול לפרטיות

ארגז החול לפרטיות ב-Android מאפשר למשתמשי המכשירים לקבוע אם ממשקי API לשמירה על פרטיות (PPAPI) וזמן הריצה ל-SDK מופעלים ב- במכשירים שלהם, או לא. החל מגרסה 'תצוגה מקדימה למפתחים 5', ההגדרה להציג ממשק המשתמש לבקרת משתמשים מושבת כברירת מחדל. למטרות פיתוח ובדיקה, מומלץ להפעיל את ממשק המשתמש של שליטת משתמשים. כדי להפעיל את ממשק המשתמש של פקדי המשתמשים, פקודות adb הבאות:

לגרסאות build בגרסת בטא ובגרסת ייצור:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity

לתצוגה מקדימה למפתחים:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity

כברירת מחדל, שליטת המשתמש מושבתת במכשיר. כדי להפעיל את האפשרות צריך להקיש על המתג כדי להפעיל את ה-API של ארגז החול לפרטיות ואת זמן הריצה ל-SDK במכשיר.

תרשים
ממשק המשתמש לבקרת משתמשים בארגז החול לפרטיות במכשיר Android.

הפעלת ארגז החול לפרטיות במכשיר

אמנם הקטע הקודם אפשר למשתמשים במכשיר לבחור אם הם רוצים ארגז החול לפרטיות פועל במכשיר שלו. בקטע הזה מוסבר איך המפתחים יכול להפעיל את ממשקי ה-API במכשיר באמצעות פקודות adb.

הפעלת ה-PPAPI במכשיר

הפעלת ה-PPAPI

adb shell device_config put adservices ppapi_app_allow_list \"\*\"
adb shell device_config put adservices ppapi_app_signature_allow_list \"\*\"
adb shell device_config put adservices msmt_api_app_allow_list \"\*\" // for attribution
adb shell device_config put adservices adservice_system_service_enabled true
adb shell device_config put adservices adservice_enabled true
adb shell device_config put adservices adservice_enable_status true

השבתה של ה-PPAPI

אפשר להפעיל או להשבית גישה ל-PPAPI למטרות פיתוח ובדיקה במכשיר על ידי הרצת הפקודות הבאות:

מגדירים לפרמטר false כדי להפעיל:

adb shell device_config put adservices global_kill_switch false

כדי להשבית צריך להגדיר ל-true:

adb shell device_config put adservices global_kill_switch true

הפעלת זמן הריצה של ה-SDK במכשיר

adb shell device_config put adservices disable_sdk_sandbox false

שלבים אחרי ההרשמה

אחרי שמסיימים את תהליך ההרשמה, צריך לבצע כמה פעולות נוספות צריך להכין את המכשיר לשימוש בממשקי ה-API של ארגז החול לפרטיות.

צריך לאלץ את ההורדה של קובץ הרישום למכשיר באמצעות שלבים:

  1. יישלח אליך אימייל מהתמיכה של ארגז החול לפרטיות אימייל לגבי ההרשמה מספר חשבון וכתובת URL שמפנה אל קובץ הרישום.

  2. משנים את פרטי הרישום במכשיר שבו פועלת גרסת התצוגה המקדימה למפתחים. באמצעות הפקודה הזו.

    adb shell device_config put adservices mdd_measurement_manifest_file_url
"<insert URL provided>"

  3. (אופציונלי אבל מומלץ) 'שינוי מברירת המחדל' מחזיר את הנתיב שהוגדר לשלב הקודם.

    adb shell device_config get adservices mdd_measurement_manifest_file_url

  4. הפעלת קריאה ל-API מאחד מממשקי ה-API לשמירה על פרטיות. (למשל registerSource() מ-Attribution Reporting API, getTopics() Topics API או joinCustomAudience() מ-Protected Audience API). הזה צפוי שהשיחה תיכשל.

  5. אילוץ הפעלה של משימת ההורדה.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14

  6. עכשיו אפשר להפעיל את ממשקי ה-API לשמירה על הפרטיות בתצוגה המקדימה למפתחים. השיחה שביצעתם בשלב 4 אמורה להסתיים בהצלחה.

השבתת ההרשמה

בגרסאות טרום-השקה למפתחים, אפשר לגשת לממשק ה-API של Protected Audience ו-Topics API בלי להירשם, צריך להפעיל את השבתת ההרשמה הבאה adb פקודות.

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

נושאים

adb shell setprop debug.adservices.disable_topics_enrollment_check true

דוחות שיוך (Attribution)

adb shell device_config put adservices disable_measurement_enrollment_check "true"