הגדרת מכשירים לשימוש בארגז החול לפרטיות ב-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.

קהל מוגן

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"