Protected Audience มีชุด API สำหรับการเข้าร่วมและออกจากกลุ่มเป้าหมายที่กำหนดเองซึ่งเป็นส่วนหนึ่งของแพ็กเกจ android.adservices.customaudience เพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่อง มีคำสั่ง CLI สำหรับการแสดงและการดู กลุ่มเป้าหมายที่กำหนดเอง คู่มือนี้จะอธิบายขั้นตอนที่นักพัฒนาเทคโนโลยีโฆษณาต้องทำตามเพื่อตรวจสอบสถานะของกลุ่มเป้าหมายที่กำหนดเองที่เข้าร่วม
ตั้งค่า
กลุ่มเป้าหมายที่กำหนดเองจะมองไม่เห็นโดยค่าเริ่มต้นเนื่องด้วยเหตุผลด้านความปลอดภัยและความเป็นส่วนตัว และจะตรวจสอบได้โดยตรงเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่องเท่านั้น โดยจะมองเห็นได้ เมื่อใช้คำสั่งเหล่านี้ก็ต่อเมื่อตรงตามข้อกำหนดต่อไปนี้
- เปิดใช้ตัวเลือกสำหรับนักพัฒนาแอปทั้งระบบแล้ว
android:debuggable="true"ประกาศไว้ในไฟล์ AndroidManifest.xml ของแอปที่CustomAudienceเข้าร่วม (ใช้joinCustomAudienceหรือfetchAndJoinCustomAudience)- สลับความยินยอมสำหรับโฆษณาที่แอปแนะนำเป็นเปิด
เปิดใช้คำสั่งเชลล์ adservices
- รีสตาร์ทอุปกรณ์เพื่อสิ้นสุดกระบวนการ
adservices - ตรวจสอบว่า
adservicesไม่ได้ทำงานอยู่ คาดว่าคำสั่งต่อไปนี้จะไม่มีเอาต์พุต
adb shell ps -A | grep adservices
จากนั้นเรียกใช้คำสั่งต่อไปนี้เพื่อเปิดใช้คำสั่งเชลล์ adservices
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
แสดงกลุ่มเป้าหมายที่กำหนดเอง
หากต้องการดูกลุ่มเป้าหมายที่กำหนดเองที่เฉพาะเจาะจง ให้เรียกใช้คำสั่งต่อไปนี้โดยระบุ
ownerเป็นแพ็กเกจที่สร้างกลุ่มเป้าหมาย และbuyerเป็น
ตัวระบุสำหรับเครือข่ายโฆษณาที่จัดการกลุ่มเป้าหมาย
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
เอาต์พุตจะเป็นออบเจ็กต์ JSON ที่มีอาร์เรย์ custom_audiences
โครงสร้างขององค์ประกอบภายในอาร์เรย์นี้ตรงกับเอาต์พุตของคำสั่ง view
custom audience ที่อธิบายไว้ถัดไป
ดูกลุ่มเป้าหมายที่กำหนดเองที่เฉพาะเจาะจง
หากต้องการดูกลุ่มเป้าหมายที่กำหนดเองที่เฉพาะเจาะจง ให้เรียกใช้คำสั่งต่อไปนี้โดยระบุ
ownerเป็นแพ็กเกจที่สร้างกลุ่มเป้าหมาย buyer เป็น
ตัวระบุสำหรับเครือข่ายโฆษณาที่จัดการกลุ่มเป้าหมาย และ name เป็น
ชื่อของกลุ่มเป้าหมาย
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
รีเฟรชกลุ่มเป้าหมายที่กำหนดเองที่เฉพาะเจาะจง
หากต้องการดูการอัปเดตรายวันด้วยตนเองสำหรับกลุ่มเป้าหมายที่กำหนดเองที่เฉพาะเจาะจง ให้เรียกใช้คำสั่งต่อไปนี้โดยระบุ owner เป็นแพ็กเกจที่สร้างกลุ่มเป้าหมาย buyer เป็นตัวระบุสำหรับเครือข่ายโฆษณาที่จัดการกลุ่มเป้าหมาย และ name เป็นชื่อของกลุ่มเป้าหมาย
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.