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.