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

bookmark_border קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

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

ארגז החול לפרטיות ב-Android מאפשר למשתמשי המכשיר לקבוע אם ממשקי ה-API לשמירה על פרטיות (PPAPI) וזמן הריצה ל-SDK מופעלים במכשירים שלהם או לא. החל מגרסה 5 של Developer Preview, ההגדרה להצגת ממשק המשתמש של אמצעי הבקרה מושבתת כברירת מחדל. למטרות פיתוח ובדיקה, מומלץ להפעיל את ממשק המשתמש של אמצעי הבקרה. כדי להפעיל את ממשק המשתמש של אמצעי הבקרה, משתמשים בפקודות 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

כברירת מחדל, אמצעי הבקרה של המשתמש מושבתים במכשיר. כדי להפעיל את Privacy Sandbox API ו-SDK Runtime במכשיר, מקישים על המתג.

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

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

   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 אמורה להתבצע.

השבתת ההרשמה

במהדורות של Developer Preview, אפשר לגשת לממשקי ה-API של Protected Audience ו-Topics בלי להירשם. לשם כך, מריצים את פקודות ההשבתה של ההרשמה 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"