יש כמה הגדרות שאפשר להפעיל או להשבית במכשירים עם ארגז חול לפרטיות ב-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 במכשיר, מקישים על המתג.
הפעלת ארגז החול לפרטיות במכשיר
בחלק הקודם המשתמשים יכלו לבחור אם להפעיל במכשיר שלהם את ארגז החול לפרטיות, אבל בקטע הזה מוסבר איך המפתח יכול להפעיל את ממשקי ה-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 של ארגז החול לפרטיות.
כדי לאלץ הורדה של קובץ הרישום למכשיר:
- אתם אמורים לקבל אימייל מהתמיכה של ארגז החול לפרטיות אימייל עם מספר חשבון הרישום שלכם וכתובת URL שמפנה לקובץ ההרשמה.
במכשיר שבו פועלת גרסת 'תצוגה מקדימה למפתחים', מבטלים את רשימת ההרשמה באמצעות הפקודה הזו.
adb shell device_config put adservices mdd_measurement_manifest_file_url "<insert URL provided>"
(אופציונלי אבל מומלץ) אימות הביטול מחזיר את הנתיב שהוגדר בשלב הקודם.
adb shell device_config get adservices mdd_measurement_manifest_file_url
מפעילים קריאה ל-API מאחד מממשקי ה-API לשמירה על הפרטיות. (לדוגמה:
registerSource()
מ-Attribution Reporting API,getTopics()
מ-Topics API אוjoinCustomAudience()
מ-Protected Audience API). השיחה צפויה להיכשל.אילוץ הפעלה של משימת ההורדה.
adb shell cmd jobscheduler run -f com.google.android.adservices.api 14
עכשיו אפשר להתחיל לקרוא לממשקי ה-API לשמירה על הפרטיות בתצוגה המקדימה למפתחים. השיחה שביצעתם בשלב 4 אמורה להצליח.
השבתת ההרשמה
בגרסאות למפתחים של 'תצוגה מקדימה', אפשר לגשת לממשקי ה-API של Protected Audience ו-Topics API בלי להירשם, על ידי הרצת הפקודות הבאות להשבתת הרישום adb
.
קהל מוגן
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"