กำหนดค่าอุปกรณ์เพื่อใช้ Privacy Sandbox ใน Android

มีการตั้งค่ามากมายที่คุณสามารถเปิดหรือปิดใช้งานสำหรับอุปกรณ์ต่างๆ ที่ใช้ Privacy Sandbox ใน Android

แสดง UI การควบคุมผู้ใช้ของ Privacy Sandbox

Privacy Sandbox ใน Android ช่วยให้ผู้ใช้อุปกรณ์ควบคุมได้ว่าจะ เปิดใช้ API การรักษาความเป็นส่วนตัว (PPAPI) และรันไทม์ของ SDK ใน อุปกรณ์ของตัวเองหรือไม่ ใน Developer Preview 5 การตั้งค่าที่จะแสดงฟังก์ชัน UI ตัวควบคุมของผู้ใช้จะถูกปิดใช้งานโดยค่าเริ่มต้น เพื่อการพัฒนาและทดสอบ คุณอาจต้องเปิดใช้ UI การควบคุมผู้ใช้ หากต้องการเปิดใช้งาน UI ตัวควบคุมของผู้ใช้ ให้ใช้ คำสั่ง adb ต่อไปนี้

สำหรับบิลด์เบต้าและเวอร์ชันที่ใช้งานจริง

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 ในอุปกรณ์ ให้แตะสวิตช์เปิด/ปิด

วันที่ แผนภาพ
UI การควบคุมของผู้ใช้ Privacy Sandbox ในอุปกรณ์ Android

เปิดใช้ Privacy Sandbox ในอุปกรณ์

ในขณะที่ส่วนก่อนหน้านี้ให้ผู้ใช้อุปกรณ์เลือกได้ว่าต้องการ Privacy Sandbox ทำงานอยู่ในอุปกรณ์ ส่วนนี้จะอธิบายวิธีการที่นักพัฒนาแอป สามารถเปิดใช้ 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

ขั้นตอนหลังการลงทะเบียน

เมื่อลงทะเบียนเรียบร้อยแล้ว คุณจะต้องทำตามขั้นตอนเพิ่มเติมอีกเล็กน้อยเพื่อ เพื่อเตรียมอุปกรณ์ของคุณให้ใช้ Privacy Sandbox API

คุณต้องบังคับให้ดาวน์โหลดไฟล์การลงทะเบียนลงในอุปกรณ์ด้วย ขั้นตอน:

  1. คุณควรได้รับอีเมลเกี่ยวกับการลงทะเบียนจากทีมสนับสนุนของ Privacy Sandbox รหัสบัญชีและ 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 ควรดำเนินการสำเร็จ

ปิดใช้งานการลงทะเบียน

ในรุ่นตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ คุณจะเข้าถึง 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

การรายงานการระบุแหล่งที่มา

adb shell device_config put adservices disable_measurement_enrollment_check "true"