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

bookmark_border จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

Privacy Sandbox ใน Android ช่วยให้ผู้ใช้อุปกรณ์ควบคุมได้ว่าต้องการเปิดใช้ Privacy-Preserving APIs (PPAPI) และ SDK Runtime ในอุปกรณ์ของตนเองหรือไม่ ในเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ 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 ในอุปกรณ์ ให้แตะสวิตช์เปิด/ปิด

เปิดใช้ 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

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

เมื่อลงทะเบียนเสร็จแล้ว คุณต้องทำตามขั้นตอนเพิ่มเติมอีก 2-3 ขั้นตอนเพื่อเตรียมอุปกรณ์ให้พร้อมใช้งาน 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 จาก Privacy Preserving 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. ตอนนี้คุณเริ่มเรียกใช้ Privacy Preserving 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"