Protected Audience มีชุด API สำหรับการเข้าร่วมและการออกจากกลุ่มเป้าหมายที่กำหนดเอง ซึ่งเป็นส่วนหนึ่งของแพ็กเกจ android.adservices.customaudience เพื่อจุดประสงค์ในการแก้ไขข้อบกพร่อง เรามีคำสั่ง CLI สำหรับการแสดงและดูกลุ่มเป้าหมายที่กำหนดเอง คู่มือนี้สรุปขั้นตอนที่นักพัฒนาเทคโนโลยีโฆษณาต้องปฏิบัติตามเพื่อตรวจสอบสถานะของกลุ่มเป้าหมายที่กำหนดเองที่ผนวกมาใช้
ตั้งค่า
เนื่องด้วยเหตุผลด้านความปลอดภัยและความเป็นส่วนตัว กลุ่มเป้าหมายที่กำหนดเองจะไม่ปรากฏโดยค่าเริ่มต้น และสามารถตรวจสอบได้โดยตรงเพื่อจุดประสงค์ในการแก้ไขข้อบกพร่องเท่านั้น โดยจะใช้คำสั่งเหล่านี้ได้ต่อเมื่อข้อกำหนดต่อไปนี้เป็นจริงเท่านั้น
- เปิดใช้ตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ทั้งระบบ
- มีการประกาศ
android:debuggable="true"ในไฟล์ AndroidManifest.xml ของแอปที่มีการเข้าร่วมCustomAudience(โดยใช้joinCustomAudienceหรือfetchAndJoinCustomAudience) - เปิดใช้ความยินยอมสำหรับโฆษณาที่แอปแนะนำอยู่
เปิดใช้คำสั่ง Shell ของ adservices
- รีสตาร์ทอุปกรณ์เพื่อสิ้นสุดกระบวนการ
adservices - ยืนยันว่า
adservicesไม่ได้ทำงานอยู่ ต้องการเอาต์พุตที่ว่างเปล่าสำหรับคำสั่งต่อไปนี้
adb shell ps -A | grep adservices
จากนั้นหากต้องการเปิดใช้คำสั่ง Shell 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
โครงสร้างขององค์ประกอบภายในอาร์เรย์นี้ตรงกับเอาต์พุตของคำสั่งกลุ่มเป้าหมายที่กำหนดเองสำหรับดูที่อธิบายในลำดับถัดไป
ดูกลุ่มเป้าหมายที่กำหนดเองที่เจาะจง
หากต้องการดูกลุ่มเป้าหมายที่กำหนดเองที่เจาะจง ให้เรียกใช้คำสั่งต่อไปนี้โดยระบุ 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.