อัปเดตล่าสุด
- เพิ่มข้อมูลเกี่ยวกับการตั้งเวลาการอัปเดตกลุ่มเป้าหมายที่กำหนดเอง
- เพิ่มการผสานรวมการรายงานการระบุแหล่งที่มากับกลุ่มเป้าหมายที่มีการป้องกัน
- เผยแพร่ไทม์ไลน์ของฟีเจอร์ Protected Audience
- FLEDGE ได้เปลี่ยนชื่อเป็น Protected Audience API
- เพิ่มข้อเสนอสําหรับการมอบสิทธิ์กลุ่มเป้าหมายที่กําหนดเอง
- นำข้อกำหนด k-anonymity ออกสำหรับการอัปเดตรายวัน URL
Protected Audience อยู่ในเวอร์ชันเบต้าและพร้อมสำหรับการทดสอบในอุปกรณ์สาธารณะแล้ว
กลุ่มเป้าหมายที่มีการป้องกันช่วยให้คุณทําสิ่งต่อไปนี้ได้
- จัดการกลุ่มเป้าหมายที่กําหนดเองตามการกระทําก่อนหน้าของผู้ใช้
- เริ่มการประมูลในอุปกรณ์ด้วยการสนับสนุนผู้ขายรายเดียวหรือสื่อกลางตามลำดับขั้น
- รายงานการแสดงผลทดสอบหลังการเลือกโฆษณา
หากต้องการเริ่มต้นใช้งาน โปรดอ่านคู่มือนักพัฒนาซอฟต์แวร์สำหรับ Protected Audience บัญชี เราขอขอบคุณความคิดเห็นของเราในการพัฒนา Protected Audience อย่างต่อเนื่อง
ไทม์ไลน์
เราจะเปิดตัวฟีเจอร์ใหม่ๆ ในอีกไม่กี่เดือนข้างหน้า วันที่วางจำหน่ายที่แน่นอนจะ แตกต่างกันไปตามฟีเจอร์ และตารางนี้จะได้รับการอัปเดตโดยลิงก์ไปยัง เมื่อมีให้ใช้งานได้
ฟีเจอร์ | พร้อมใช้งานในเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ | พร้อมใช้งานในรุ่นเบต้า |
---|---|---|
การรายงานระดับเหตุการณ์ | ไตรมาส 1 ปี 2023 | ไตรมาส 3 ปี 2023 |
การแสดงโฆษณาสื่อกลางตามลำดับขั้น | ไตรมาส 1 ปี 2023 | ไตรมาส 4 ปี 2023 |
การกรองโฆษณาเพื่อการติดตั้งแอป | ไตรมาส 2 ปี 2023 | ไตรมาส 3 ปี 2023 |
การกรองความถี่สูงสุด | ไตรมาส 2 ปี 2023 | ไตรมาสที่ 3 ปี 2023 |
ส่งโฆษณาตามบริบทไปยังเวิร์กโฟลว์การเลือกโฆษณาสำหรับการกรอง | ไตรมาส 2 ปี 2023 | ไตรมาส 3 ปี 2023 |
การรายงานการโต้ตอบ | ไตรมาส 2 ปี 2023 | ไตรมาส 3 ปี 2023 |
เข้าร่วมการมอบสิทธิ์กลุ่มเป้าหมายที่กำหนดเอง | ไตรมาส 3 ปี 2023 | ไตรมาส 4 ปี 2023 |
การเรียกเก็บเงินที่ไม่ใช่ CPM | ไตรมาสที่ 3 ปี 2023 | ไตรมาส 4 ปี 2023 |
การผสานรวมบริการการเสนอราคาและการประมูล | ไตรมาสที่ 3 ปี 2023 | ไตรมาส 4 ปี 2023 |
การรายงานข้อบกพร่อง | ไตรมาส 3 ปี 2023 | ไตรมาส 4 ปี 2023 |
การผสานรวมการรายงานการระบุแหล่งที่มา | ไม่มี | ไตรมาส 4 ปี 2023 |
สื่อกลางในการเสนอราคาแบบเปิด | ไตรมาส 4 ปี 2023 | ไตรมาส 4 ปี 2023 |
การจัดการสกุลเงิน | Q1 '24 | ไตรมาส 2 ปี 2024 |
การผสานรวม K-anon | ไม่มี | ไตรมาส 2 ปี 2024 |
การผสานรวมการรายงานแบบรวม | ไตรมาส 3 ปี 2024 | ไตรมาส 4 ปี 2024 |
ภาพรวม
ในการโฆษณาบนอุปกรณ์เคลื่อนที่ ผู้ลงโฆษณามักจำเป็นต้องแสดงโฆษณาเพื่อ ผู้ใช้ที่อาจมีความสนใจโดยอิงจากการมีส่วนร่วมก่อนหน้านี้กับ แอปของผู้ลงโฆษณา ตัวอย่างเช่น นักพัฒนา SportingGoodsApp อาจต้องการ โฆษณาต่อผู้ใช้ที่มีสินค้าเหลืออยู่ในรถเข็นช็อปปิ้ง โดยแสดงโฆษณาต่อ ช่วยเตือนให้ผู้ใช้ทำการซื้อให้เสร็จสมบูรณ์ อุตสาหกรรมนี้มักอธิบายเกี่ยวกับเรื่องนี้ แนวคิดทั่วไปที่มีคำอย่างเช่น "รีมาร์เก็ตติ้ง" และ "การกำหนดกลุ่มเป้าหมายที่กำหนดเอง"
ปัจจุบัน Use Case เหล่านี้มักนำมาใช้ร่วมกันโดยแชร์บริบท ข้อมูลเกี่ยวกับวิธีการแสดงโฆษณา (เช่น ชื่อแอป) และข้อมูลส่วนตัว ข้อมูลต่างๆ เช่น รายการกลุ่มเป้าหมายกับแพลตฟอร์มเทคโนโลยีโฆษณา ผู้ลงโฆษณาสามารถใช้ข้อมูลนี้เพื่อเลือกโฆษณาที่เกี่ยวข้องในเซิร์ฟเวอร์ของตนเอง
Protected Audience API ใน Android (ก่อนหน้านี้เรียกว่า FLEDGE) ครอบคลุม API ต่อไปนี้สำหรับแพลตฟอร์มเทคโนโลยีโฆษณาและผู้ลงโฆษณาเพื่อรองรับ กรณีการใช้งานที่อิงตามการโต้ตอบในลักษณะที่จำกัดการแชร์ตัวระบุทั้ง 2 ตัว ในแอปต่างๆ และข้อมูลการโต้ตอบระหว่างแอปของผู้ใช้กับบุคคลที่สาม
- API กลุ่มเป้าหมายที่กำหนดเอง: โค้ดนี้อยู่ตรงกลาง "กลุ่มเป้าหมายที่กำหนดเอง" Abstraction ซึ่งแสดงถึงสิ่งที่ผู้ลงโฆษณากำหนดว่า ที่มีความตั้งใจเดียวกัน ระบบจะจัดเก็บข้อมูลกลุ่มเป้าหมายไว้ในอุปกรณ์และ สามารถเชื่อมโยงกับโฆษณาผู้สมัครที่เกี่ยวข้อง สำหรับผู้ชมได้อย่างไร ข้อมูลเมตา เช่น สัญญาณการเสนอราคา สามารถใช้ข้อมูลนี้เพื่อแจ้ง การเสนอราคาของผู้ลงโฆษณา การกรองโฆษณา และการแสดงโฆษณา
- Ad Selection API: เฟรมเวิร์กนี้ช่วยประสานเวิร์กโฟลว์ของแพลตฟอร์มเทคโนโลยีโฆษณาที่ใช้สัญญาณในอุปกรณ์เพื่อระบุโฆษณา "ที่มีประสิทธิภาพสูงสุด" โดยพิจารณาโฆษณาที่เป็นไปได้ซึ่งจัดเก็บไว้ในเครื่อง และดำเนินการประมวลผลเพิ่มเติมกับโฆษณาที่เป็นไปได้ซึ่งแพลตฟอร์มเทคโนโลยีโฆษณาแสดงผลไปยังอุปกรณ์
ในระดับสูง การผสานรวมจะทํางานดังนี้
SportingGoodsApp ต้องการช่วยเตือนผู้ใช้ให้ซื้อสินค้าคงคลังในรถเข็นหากยังไม่ได้ซื้อภายใน 2 วัน SportingGoodsApp ใช้ Custom Audience API เพื่อเพิ่มผู้ใช้ไปยังรายการกลุ่มเป้าหมาย "ผลิตภัณฑ์ในรถเข็น" แพลตฟอร์มจะจัดการและจัดเก็บรายการกลุ่มเป้าหมายนี้ไว้ในอุปกรณ์ ซึ่งจะจํากัดการแชร์กับบุคคลที่สาม SportingGoodsApp ร่วมมือกับแพลตฟอร์มเทคโนโลยีโฆษณาเพื่อแสดงโฆษณาต่อผู้ใช้ ในรายการกลุ่มเป้าหมาย แพลตฟอร์มเทคโนโลยีโฆษณาจะจัดการข้อมูลเมตาสำหรับรายการกลุ่มเป้าหมายและแสดงโฆษณาที่เป็นไปได้ ซึ่งจะพร้อมใช้งานในเวิร์กโฟลว์การเลือกโฆษณาเพื่อพิจารณา แพลตฟอร์มสามารถกําหนดค่าให้ดึงข้อมูลโฆษณาตามกลุ่มเป้าหมายที่อัปเดตเป็นประจําในเบื้องหลัง วิธีนี้ช่วยให้รายการโฆษณาที่อาจแสดงตามกลุ่มเป้าหมายมีความใหม่อยู่เสมอและไม่เกี่ยวข้องกับคําขอที่ส่งไปยังเซิร์ฟเวอร์โฆษณาบุคคลที่สามในระหว่างโอกาสในการโฆษณา (เช่น คําขอโฆษณาตามบริบท)
เมื่อผู้ใช้เล่น FrisbeeGame บนอุปกรณ์เดียวกัน ผู้ใช้อาจเห็นโฆษณา แจ้งเตือนให้ซื้อสินค้าที่เหลือใน SportingGoodsApp รถเข็นช็อปปิ้ง ซึ่งทําได้ด้วย FrisbeeGame (ด้วยโฆษณาที่ผสานรวม SDK) การเรียกใช้ API การเลือกโฆษณาเพื่อเลือกโฆษณาที่ชนะ สำหรับผู้ใช้โดยอิงจากรายการกลุ่มเป้าหมาย ที่ผู้ใช้อาจเป็นสมาชิกอยู่ (ใน ตัวอย่างเช่น "ผลิตภัณฑ์ในรถเข็น" กลุ่มเป้าหมายที่กำหนดเองที่สร้างโดย SportingGoodsApp) ตั้งค่าเวิร์กโฟลว์การเลือกโฆษณาให้พิจารณาโฆษณาที่ดึงมาจากโฆษณาได้ ของแพลตฟอร์มเทคโนโลยี เซิร์ฟเวอร์นอกเหนือจากโฆษณาในอุปกรณ์ที่เชื่อมโยงกับ รวมถึงสัญญาณอื่นๆ ในอุปกรณ์ เวิร์กโฟลว์ยังสามารถ ปรับแต่งตามแพลตฟอร์มเทคโนโลยีโฆษณาและ SDK โฆษณาด้วยการเสนอราคาที่กำหนดเอง ตรรกะในการให้คะแนนเพื่อบรรลุเป้าหมายการโฆษณาที่เหมาะสม วิธีนี้ทำให้ ข้อมูลความสนใจหรือการโต้ตอบในแอปของผู้ใช้เพื่อประกอบการเลือกโฆษณา จำกัดการแชร์ข้อมูลนี้กับบุคคลที่สาม
SDK ของแอปการแสดงโฆษณาหรือแพลตฟอร์มเทคโนโลยีโฆษณาจะแสดงโฆษณาที่เลือก
แพลตฟอร์มนี้ช่วยให้การรายงานการแสดงผลและผลลัพธ์การเลือกโฆษณาเป็นไปอย่างสะดวก ความสามารถในการรายงานนี้ช่วยเสริมAttribution Reporting API แพลตฟอร์มเทคโนโลยีโฆษณาอาจปรับแต่งตามความต้องการในการรายงาน
รับสิทธิ์เข้าถึง Protected Audience ใน Android API
แพลตฟอร์มเทคโนโลยีโฆษณาต้องลงทะเบียนเพื่อเข้าถึง Protected Audience API โปรดดู ลงทะเบียนบัญชี Privacy Sandbox เพื่อรับข้อมูลเพิ่มเติม
การจัดการกลุ่มเป้าหมายที่กำหนดเอง
กลุ่มเป้าหมายที่กำหนดเอง
กลุ่มเป้าหมายที่กําหนดเองแสดงถึงกลุ่มผู้ใช้ตามที่ผู้ลงโฆษณากําหนดซึ่งมีความตั้งใจหรือความสนใจร่วมกัน แอปหรือ SDK อาจใช้กลุ่มเป้าหมายที่กําหนดเองเพื่อบ่งบอกกลุ่มเป้าหมายที่เฉพาะเจาะจง เช่น ผู้ที่ "มีสินค้าในรถเข็นช็อปปิ้ง" หรือ "ผ่านด่านระดับเริ่มต้น" ของเกม แพลตฟอร์ม เก็บรักษาและจัดเก็บข้อมูลกลุ่มเป้าหมายไว้ในอุปกรณ์และไม่ แสดงว่าผู้ใช้อยู่ในกลุ่มเป้าหมายที่กำหนดเองกลุ่มใด กลุ่มเป้าหมายที่กำหนดเองแตกต่างจาก กลุ่มความสนใจของ Protected Audience ของ Chrome และไม่สามารถแชร์ได้ ทั้งในเว็บและแอป ซึ่งช่วยจํากัดการแชร์ข้อมูลผู้ใช้
แอปของผู้ลงโฆษณาหรือ SDK ที่ผสานรวมไว้อาจเข้าร่วม หรือ ปล่อยกลุ่มเป้าหมายที่กําหนดเองไว้โดยอิงตามผู้ใช้ เช่น การมีส่วนร่วมในแอป
ข้อมูลเมตากลุ่มเป้าหมายที่กําหนดเอง
กลุ่มเป้าหมายที่กําหนดเองแต่ละกลุ่มจะมีข้อมูลเมตาต่อไปนี้
- เจ้าของ: ชื่อแพ็กเกจของแอปเจ้าของ โดยเป็นการตั้งค่าโดยปริยาย ชื่อแพ็กเกจของแอปผู้โทร
- ผู้ซื้อ: เครือข่ายโฆษณาของผู้ซื้อซึ่งจัดการโฆษณาสำหรับกลุ่มเป้าหมายที่กำหนดเองนี้ ผู้ซื้อยังเป็นตัวแทนของผู้ที่อาจเข้าถึงกลุ่มเป้าหมายที่กำหนดเองและดึงข้อมูล ข้อมูลโฆษณาที่เกี่ยวข้อง มีการระบุผู้ซื้อตามรูปแบบ eTLD+1
- ชื่อ: ชื่อหรือตัวระบุที่กำหนดเองสำหรับกลุ่มเป้าหมายที่กำหนดเอง เช่น ผู้ใช้ที่มี "ผู้ละทิ้งรถเข็นช็อปปิ้ง" แอตทริบิวต์นี้ใช้เป็นเกณฑ์การกำหนดเป้าหมายได้ เช่น ในแคมเปญโฆษณาของผู้ลงโฆษณา หรือสตริงคําค้นหาใน URL สําหรับการดึงข้อมูล รหัสการเสนอราคา
- เวลาเปิดใช้งานและเวลาหมดอายุ: ช่องเหล่านี้กําหนดกรอบเวลาของกลุ่มเป้าหมายที่กําหนดเองนี้ แพลตฟอร์มจะใช้ เพื่อถอนการเป็นสมาชิกจากกลุ่มเป้าหมายที่กำหนดเอง เวลาหมดอายุ ต้องไม่เกินกรอบเวลาสูงสุดเพื่อจำกัดอายุการใช้งานของ กลุ่มเป้าหมาย
- URL การอัปเดตรายวัน: URL ที่แพลตฟอร์มใช้ดึงข้อมูลโฆษณาที่เป็นผู้สมัครและข้อมูลเมตาอื่นๆ ที่กําหนดไว้ในช่อง "สัญญาณการเสนอราคาของผู้ใช้" และ "สัญญาณการเสนอราคาที่เชื่อถือได้" เป็นประจํา ดูรายละเอียดเพิ่มเติมได้ที่ส่วนวิธีดึงข้อมูลโฆษณาที่มีโอกาสแสดงสําหรับกลุ่มเป้าหมายที่กําหนดเอง
- สัญญาณการเสนอราคาของผู้ใช้: สัญญาณเฉพาะแพลตฟอร์มเทคโนโลยีโฆษณาสำหรับ การเสนอราคาของโฆษณารีมาร์เก็ตติ้ง ตัวอย่างสัญญาณ ได้แก่ ตำแหน่งโดยคร่าวๆ ของผู้ใช้ ภาษาที่ต้องการ และอื่นๆ
- ข้อมูลการเสนอราคาที่เชื่อถือได้: แพลตฟอร์มเทคโนโลยีโฆษณาใช้ข้อมูลแบบเรียลไทม์ เพื่อแจ้งการดึงข้อมูลและการให้คะแนน เช่น โฆษณาอาจใช้งบประมาณหมดแล้วและต้องหยุดแสดงทันที เทคโนโลยีโฆษณาจะกำหนด URL ได้ อุปกรณ์ปลายทางที่สามารถดึงข้อมูลแบบเรียลไทม์และชุดคีย์สำหรับ ซึ่งต้องดำเนินการค้นหาแบบเรียลไทม์ เซิร์ฟเวอร์ที่จัดการคําขอนี้จะต้องเป็นเซิร์ฟเวอร์ที่เชื่อถือได้ซึ่งจัดการโดยแพลตฟอร์มเทคโนโลยีโฆษณา
- URL ของตรรกะการเสนอราคา: URL ที่แพลตฟอร์มใช้ดึงข้อมูลโค้ดการเสนอราคาจากแพลตฟอร์มฝั่งดีมานด์ แพลตฟอร์มจะดําเนินการขั้นตอนนี้เมื่อเริ่มการประมูลโฆษณา
- โฆษณา: รายการของโฆษณาที่เป็นผู้สมัครสำหรับกลุ่มเป้าหมายที่กำหนดเอง ซึ่งรวมถึง ข้อมูลเมตาของโฆษณาเฉพาะแพลตฟอร์มเทคโนโลยีโฆษณาและ URL ที่ใช้แสดงโฆษณา เมื่อเริ่มการประมูลสําหรับกลุ่มเป้าหมายที่กําหนดเอง ระบบจะพิจารณารายการข้อมูลเมตาของโฆษณานี้ ระบบจะรีเฟรชรายการโฆษณานี้โดยใช้ปลายทาง URL การอัปเดตรายวันเมื่อเป็นไปได้ เนื่องจากข้อจํากัดด้านทรัพยากรในอุปกรณ์เคลื่อนที่ ระบบจึงจํากัดจํานวนโฆษณาที่เก็บไว้ในกลุ่มเป้าหมายที่กําหนดเอง
การให้สิทธิ์กลุ่มเป้าหมายที่กำหนดเอง
การกำหนดและการกำหนดค่ากลุ่มเป้าหมายที่กำหนดเองแบบดั้งเดิมมักจะอาศัย เทคโนโลยีฝั่งเซิร์ฟเวอร์และการผสานรวมที่ขับเคลื่อนโดยเทคโนโลยีโฆษณาที่ร่วมมือกับ ลูกค้าและพาร์ทเนอร์เอเจนซีและผู้ลงโฆษณา Protected Audience API จะเปิดใช้ คำจำกัดความและการกำหนดค่ากลุ่มเป้าหมายที่กำหนดเองพร้อมปกป้องความเป็นส่วนตัวของผู้ใช้ไปพร้อมกัน ถึง เข้าร่วมกลุ่มเป้าหมายที่กำหนดเอง ซึ่งเป็นเทคโนโลยีโฆษณาของผู้ซื้อที่ไม่มี SDK ในแอป ต้องทำงานร่วมกับเทคโนโลยีโฆษณาที่มีตัวตนในอุปกรณ์ เช่น อุปกรณ์เคลื่อนที่ พาร์ทเนอร์การวัดผล (MMP) และแพลตฟอร์มฝั่งซัพพลาย (SSP) Protected Audience API มีจุดประสงค์เพื่อรองรับ SDK เหล่านี้ด้วยการจัดหาโซลูชันที่ยืดหยุ่นสําหรับการจัดการกลุ่มเป้าหมายที่กําหนดเอง โดยช่วยให้ผู้เรียกใช้ในอุปกรณ์เรียกใช้การสร้างกลุ่มเป้าหมายที่กําหนดเองในนามของผู้ซื้อได้ กระบวนการนี้เรียกว่ากลุ่มเป้าหมายที่กำหนดเอง การมอบสิทธิ์ กําหนดค่าการมอบสิทธิ์กลุ่มเป้าหมายที่กําหนดเองโดยทำตามขั้นตอนต่อไปนี้
เข้าร่วมกลุ่มเป้าหมายที่กำหนดเอง
การเข้าร่วมกลุ่มเป้าหมายที่กำหนดเองทำได้ 2 วิธีดังนี้
joinCustomAudience()
แอปหรือ SDK สามารถขอเข้าร่วมกลุ่มเป้าหมายที่กำหนดเองได้โดยการเรียกใช้
joinCustomAudience()
หลังจากสร้างอินสแตนซ์ CustomAudience
ด้วย
พารามิเตอร์ที่คาดไว้ ตัวอย่างข้อมูลโค้ดที่แสดงภาพมีดังนี้
CustomAudience audience = new CustomAudience(
Buyer = "example-dsp.com",
Name = "running-shoes",
ActivationTime = now(),
ExpirationTime = ActivationTime.plus(30 days),
DailyUpdateURL = Uri.parse("https://..."),
UserBiddingSignals = new JSONObject("{...}"),
TrustedBiddingURL = Uri.parse("https://..."),
TrustedBiddingKeys = {'key1","key2", ...,"key n"},
BiddingLogicURL = Uri.parse("https://..."),
Ads = [new AdData(renderUrl = Uri.parse("https://..."),
metadata = new JSONObject("{...}"), ...];
// Invoke ad services API to join a custom audience.
joinCustomAudience(audience);
fetchAndJoinCustomAudience()
แอปหรือ SDK สามารถขอเข้าร่วมกลุ่มเป้าหมายที่กําหนดเองในนามของเทคโนโลยีโฆษณาที่ไม่มีการแสดงในอุปกรณ์ได้โดยเรียกใช้ fetchAndJoinCustomAudience()
พร้อมพารามิเตอร์ที่คาดไว้ ดังตัวอย่างต่อไปนี้
FetchAndJoinCustomAudienceRequest fetchRequest = new FetchAndJoinCustomAudienceRequest(
// Example: Optional verification token passed inside the fetch URL
FetchURI = Uri.parse("https://example-dsp.com/...?mytoken=arbitrary1234"),
// All the following parameters are optional
Name = "running-shoes",
ActivationTime = now(),
ExpirationTime = ActivationTime.plus(30 days),
UserBiddingSignals = new JSONObject("{...}")
);
fetchAndJoinCustomAudience(fetchRequest);
ปลายทาง URL ที่ผู้ซื้อเป็นเจ้าของจะตอบกลับด้วยออบเจ็กต์ CustomAudience
JSON
ในเนื้อหาการตอบกลับ ช่องผู้ซื้อและเจ้าของของกลุ่มเป้าหมายที่กำหนดเองคือ
ถูกละเว้น (และถูกป้อนข้อความอัตโนมัติโดย API) นอกจากนี้ API ยังบังคับใช้
URL อัปเดตจะตรงกับ eTLD+1 ของผู้ซื้อด้วย
{
"name": "running-shoes",
"activation_time": 1680603133000,
"expiration_time": 1680803133000,
"user_bidding_signals" : {"signal1": "value"},
"trusted_bidding_data": {
"trusted_bidding_uri": "https://example-dsp.com/.."
"trusted_bidding_keys": ["k1", "k2"],
},
"bidding_logic_uri": "https://example-dsp.com/...",
"daily_update_uri": "https://example-dsp.com/...",
"ads": [
{
"render_uri": "https://example-dsp.com/...",
"metadata": {},
"ad_filters": {
"frequency_cap": {
"win": [
{
"ad_counter_key": 1,
"max_count": 2,
"interval_in_seconds": 60
},
],
"view": [
{
"ad_counter_key": 2,
"max_count": 10,
"interval_in_seconds": 3600
},
]
},
"app_install": {
"package_names": [
"package.name.one",
"package.name.two", ...
]
}
}
},
...
]
}
fetchAndJoinCustomAudience()
API จะระบุข้อมูลประจำตัวของผู้ซื้อจาก
eTLD+1 จาก fetchUri
ระบบจะใช้ข้อมูลประจำตัวของCustomAudience
ผู้ซื้อเพื่อดำเนินการตรวจสอบการลงทะเบียนและการให้สิทธิ์แอปเดียวกันกับที่joinCustomAudience()
ดำเนินการ และไม่สามารถเปลี่ยนแปลงโดยการตอบกลับการดึงข้อมูล เจ้าของ CustomAudience
คือชื่อแพ็กเกจของแอปพลิเคชันที่เรียกใช้ ไม่มีการตรวจสอบfetchUri
อื่นๆ นอกเหนือจากการตรวจสอบ eTLD+1 และโดยเฉพาะอย่างยิ่ง ไม่มีการตรวจสอบ k-anon fetchAndJoinCustomAudience()
API จะออกคำขอ HTTP GET ไปยัง
fetchUri
และคาดหวังว่าจะมีออบเจ็กต์ JSON ที่แสดงถึงกลุ่มเป้าหมายที่กำหนดเอง เรื่อง
ข้อจำกัดที่ไม่บังคับ ไม่บังคับ และค่าเริ่มต้นสำหรับกลุ่มเป้าหมายที่กำหนดเอง
ฟิลด์ออบเจ็กต์ที่จะนำไปใช้กับการตอบกลับ ดูข้อมูลเกี่ยวกับข้อกําหนดและข้อจํากัดปัจจุบันในคู่มือนักพัฒนาซอฟต์แวร์
การตอบกลับข้อผิดพลาด HTTP จากผู้ซื้อจะทำให้ fetchAndJoinCustomAudience
ดำเนินการไม่สำเร็จ โดยเฉพาะอย่างยิ่ง การตอบกลับสถานะ HTTP 429 (มีคำขอมากเกินไป) จะบล็อกคำขอจากแอปพลิเคชันปัจจุบันเป็นระยะเวลาที่กำหนด การเรียก API จะล้มเหลวเช่นกันหากการตอบกลับจากผู้ซื้อมีรูปแบบไม่ถูกต้อง ความล้มเหลวจะรายงานไปยัง
ผู้เรียก API ที่รับผิดชอบในการลองอีกครั้งเนื่องจากการทำงานล้มเหลวชั่วคราว (เช่น
เซิร์ฟเวอร์ไม่ตอบสนอง) หรือการจัดการกับการทำงานล้มเหลวอย่างต่อเนื่อง (เช่น การตรวจสอบข้อมูล
การทำงานล้มเหลวหรือข้อผิดพลาดที่ไม่ใช่แบบชั่วคราวอื่นๆ เมื่อสื่อสารกับเซิร์ฟเวอร์)
ออบเจ็กต์ CustomAudienceFetchRequest
ช่วยให้การเรียก API กำหนด
สำหรับกลุ่มเป้าหมายที่กำหนดเองโดยใช้พร็อพเพอร์ตี้ที่ไม่บังคับที่แสดงใน
ตัวอย่างข้างต้น หากตั้งค่าไว้ในคําขอ ระบบจะไม่เขียนทับค่าเหล่านี้ด้วยการตอบกลับจากผู้ซื้อที่ได้รับจากแพลตฟอร์ม โดย Protected Audience API จะละเว้นช่องในการตอบกลับ หากไม่ได้ตั้งค่าในคําขอ จะต้องตั้งค่าในคําตอบ เนื่องจากต้องใช้ช่องเหล่านี้ในการสร้างกลุ่มเป้าหมายที่กําหนดเอง การนำเสนอ JSON ของเนื้อหา CustomAudience
ตามที่ระบุไว้บางส่วนโดยผู้เรียก API จะรวมอยู่ในคำขอ GET ไปยัง fetchUri
ในส่วนหัวพิเศษ X-CUSTOM-AUDIENCE-DATA
ขนาดของรูปแบบที่แปลงเป็นอนุกรมของข้อมูลที่ระบุสําหรับกลุ่มเป้าหมายที่กําหนดเองจํากัดไว้ที่ 8 KB หากขนาดคือ
การเรียก API เกิน fetchAndJoinCustomAudience
ครั้งไม่สำเร็จ
การไม่มีการตรวจสอบแบบ k-anon ช่วยให้คุณใช้ fetchUri
สำหรับการยืนยันผู้ซื้อได้
และเพื่อเปิดใช้การแชร์ข้อมูลระหว่างผู้ซื้อกับ SDK เพื่ออำนวยความสะดวกที่กำหนดเอง
การยืนยันกลุ่มเป้าหมาย ผู้ซื้ออาจทำการยืนยันได้
โทเค็น SDK ในอุปกรณ์ควรใส่โทเค็นนี้ใน fetchUri
เพื่อให้ปลายทางที่โฮสต์โดยผู้ซื้อสามารถดึงข้อมูลเนื้อหาของกลุ่มเป้าหมายที่กําหนดเอง และใช้โทเค็นการยืนยันเพื่อยืนยันว่าการดำเนินการ fetchAndJoinCustomAudience()
สอดคล้องกับผู้ซื้อและมาจากพาร์ทเนอร์ในอุปกรณ์ที่เชื่อถือได้ ผู้ซื้อสามารถตกลงกับผู้โทรในอุปกรณ์เพื่อแชร์ข้อมูล
ข้อมูลบางส่วนที่จะนำมาใช้สร้างกลุ่มเป้าหมายที่กำหนดเองจะ
เพิ่มเป็นพารามิเตอร์การค้นหาลงใน fetchUri
แล้ว ซึ่งช่วยให้ผู้ซื้อตรวจสอบการเรียกใช้และตรวจจับได้ว่าเทคโนโลยีโฆษณาที่เป็นอันตรายใช้โทเค็นการตรวจสอบเพื่อสร้างกลุ่มเป้าหมายที่กําหนดเองหลายกลุ่มหรือไม่
หมายเหตุเกี่ยวกับการกำหนดโทเค็นการยืนยันและพื้นที่เก็บข้อมูล
Protected Audience API จะไม่ใช้โทเค็นการยืนยันเพื่อวัตถุประสงค์ใดๆ และคุณไม่จำเป็นต้องใช้โทเค็นดังกล่าว
- ผู้ซื้ออาจใช้โทเค็นการยืนยันเพื่อยืนยันว่าการสร้างกลุ่มเป้าหมายเกิดขึ้นในนามของตน
- โปรโพซาลของ Protected Audience API ไม่ได้ระบุรูปแบบของโทเค็นการยืนยันหรือวิธีที่ผู้ซื้อโอนโทเค็นการยืนยันไปยังผู้เรียก เช่น โทเค็นการยืนยันอาจโหลดไว้ล่วงหน้าใน SDK หรือแบ็กเอนด์ของเจ้าของคน หรือ SDK ของเจ้าของคนอาจดึงข้อมูลโทเค็นแบบเรียลไทม์จากเซิร์ฟเวอร์ของผู้ซื้อ
ออกจากกลุ่มเป้าหมายที่กำหนดเอง
เจ้าของกลุ่มเป้าหมายที่กําหนดเองอาจเลือกที่จะออกจากกลุ่มเป้าหมายโดยการโทร
leaveCustomAudience()
ดังที่แสดงในตัวอย่างข้อมูลโค้ดด้านล่าง
// Invoke ad services API to leave a custom audience.
leaveCustomAudience(buyer, name);
กลุ่มเป้าหมายที่กำหนดเองเพื่อช่วยประหยัดปริมาณการใช้พื้นที่เก็บข้อมูลและทรัพยากรอื่นๆ ของอุปกรณ์ หมดอายุและจะถูกนำออกจาก Store ในอุปกรณ์หลังจากระยะเวลาที่กำหนดไว้ล่วงหน้า ค่าเริ่มต้นจะกําหนด เจ้าของจะลบล้างค่าเริ่มต้นนี้ได้
การควบคุมของผู้ใช้
- ข้อเสนอนี้มีจุดประสงค์เพื่อให้ผู้ใช้ได้เห็นรายชื่อแอปที่ติดตั้ง ที่สร้างกลุ่มเป้าหมายที่กำหนดเองอย่างน้อย 1 กลุ่ม
- ผู้ใช้สามารถนำแอปออกจากรายการนี้ได้ การนําออกจะล้างกลุ่มเป้าหมายที่กําหนดเองทั้งหมดที่เชื่อมโยงกับแอป และป้องกันไม่ให้แอปเข้าร่วมกลุ่มเป้าหมายที่กําหนดเองใหม่
- ผู้ใช้จะรีเซ็ต Protected Audience API ได้ทั้งหมด วันและเวลา ระบบจะล้างกลุ่มเป้าหมายที่กำหนดเองที่มีอยู่ในอุปกรณ์
- ผู้ใช้สามารถเลือกไม่ใช้ Privacy Sandbox ใน Android ทั้งหมดได้ ซึ่งรวมถึง Protected Audience API หากผู้ใช้เลือกไม่ใช้ Privacy Sandbox ระบบจะไม่แสดงข้อความแจ้งว่า Protected Audience API ใช้งานไม่ได้
การออกแบบความสามารถนี้อยู่ระหว่างดำเนินการและรายละเอียดจะรวมอยู่ในการอัปเดตในภายหลัง
การอัปเดตตามกำหนดการ
โซลูชันที่อธิบายก่อนหน้านี้กําหนดให้ SDK ของแอปหรือเทคโนโลยีโฆษณาเรียกใช้ API ขณะที่แอปทํางานอยู่เบื้องหน้า และให้พร็อพเพอร์ตี้เต็มรูปแบบของ กลุ่มเป้าหมายที่กำหนดเองโดยตรงหรือใช้การมอบสิทธิ์ แต่ก็ไม่ได้เป็นเช่นนั้นเสมอไป ซึ่งผู้ลงโฆษณาและผู้ให้บริการเทคโนโลยีโฆษณาสามารถกําหนดกลุ่มเป้าหมายที่ผู้ใช้ อยู่ในแบบเรียลไทม์ขณะใช้แอป
เพื่อช่วยอำนวยความสะดวกในเรื่องนี้ เทคโนโลยีโฆษณาสามารถเรียกฟังก์ชัน
scheduleCustomAudienceUpdate()
API API นี้ช่วยให้ผู้เรียกใช้สามารถระบุ
ความล่าช้าในการเรียก API ดังนั้นการให้เวลาเพิ่มเติม
ให้เทคโนโลยีโฆษณาที่ใช้ตอบสนอง
สามารถประมวลผลเหตุการณ์ระดับแอปและระบุ
กลุ่มเป้าหมายที่มีการป้องกันที่ผู้ใช้ควรเข้าร่วมหรือถูกนำออก
/**
* API To schedule delayed update events for Custom Audience
*
* @param request Criteria that determine when and where to trigger a call to a
* DSP endpoint to update one or more Custom Audiences
*/
public void scheduleCustomAudienceUpdate(
@NonNull ScheduleCustomAudienceUpdateRequest request,
@NonNull @CallBackExecutor Executor executor,
@NonNull AdServicesOutcomeReceiver<Object, Exception> receiver)
ScheduleCustomAudienceUpdateRequest
public final class ScheduleCustomAudienceUpdateRequest {
// Required Field
@NonNull public Uri getUpdateUri() {
return mUpdateUri;
}
// Required Field
@NonNull public Duration getMinDelay() {
return mMinDelay;
}
// Required Field
@NonNull public List<PartialCustomAudience> getPartialCustomAudienceList() {
return mPartialCustomAudiences;
}
// Optional Field (default false)
public boolean shouldReplacePendingUpdates () {
return mShouldReplacePendingUpdates;
}
}
ScheduleCustomAudienceUpdateRequest
มีข้อมูลที่จำเป็นสำหรับ
ลงทะเบียนงานที่ล่าช้าเพื่อเรียกใช้ด้วยแพลตฟอร์ม หลังจากการเลื่อนเวลาตามที่ระบุแล้ว งานเบื้องหลังจะทํางานเป็นระยะๆ และส่งคําขอ
ScheduleCustomAudienceUpdateRequest
สามารถมีข้อมูลต่อไปนี้
- UpdateUri: อุปกรณ์ปลายทาง URI ที่จะส่งการเรียก GET เพื่อดึงข้อมูลการอัปเดต
ระบบจะอนุมานข้อมูลประจำตัวของผู้ซื้อจาก eTLD+1 โดยไม่จำเป็นต้องระบุอย่างชัดเจนและไม่สามารถแก้ไขโดยการตอบกลับการอัปเดต คำขอ GET คาดว่าจะได้รับออบเจ็กต์ JSON ที่มีรายการออบเจ็กต์
customAudience
ในการตอบกลับ - DelayTime: เวลาที่แสดงถึงความล่าช้าจากเวลาที่ทำ
scheduleCustomAudienceUpdate()
การเรียก API เพื่อกำหนดเวลาการอัปเดต
PartialCustomAudience: API นี้ยังอนุญาตให้ SDK บนอุปกรณ์ส่งรายการกลุ่มเป้าหมายที่กําหนดเองซึ่งสร้างขึ้นบางส่วนได้ด้วย วิธีนี้ช่วยให้ SDK ในแอปแสดง บทบาทคู่ ตั้งแต่การควบคุมอย่างสมบูรณ์ไปจนถึงการควบคุมการจัดการกลุ่มเป้าหมายที่กำหนดเองบางส่วน ตามการเป็นพาร์ทเนอร์กับ DSP
- นอกจากนี้ ยังช่วยให้ API นี้เข้ากันได้กับ
fetchAndJoinCustomAudience()
API ซึ่งช่วยให้แชร์ข้อมูลในลักษณะเดียวกันได้
- นอกจากนี้ ยังช่วยให้ API นี้เข้ากันได้กับ
ShouldReplacePendingUpdates: บูลีนที่ระบุว่ามีรอดำเนินการหรือไม่ การอัปเดตตามกำหนดเวลาควรถูกยกเลิกและแทนที่ด้วยการอัปเดตที่ให้รายละเอียดไว้ใน
ScheduleCustomAudienceUpdateRequest
ปัจจุบัน หากตั้งค่าเป็นfalse
และ มีการอัปเดตที่ขอก่อนหน้านี้ซึ่งยังคงรอดำเนินการสำหรับผู้ซื้อรายเดียวกันใน แอปเดียวกัน โทรหาscheduleCustomAudienceUpdate
ด้วยScheduleCustomAudienceUpdateRequest
จะล้มเหลว ค่าเริ่มต้นคือfalse
สิทธิ์และการควบคุมของแอป
ข้อเสนอนี้มีจุดประสงค์ให้แอปควบคุมกลุ่มเป้าหมายที่กำหนดเองของตน
- แอปสามารถจัดการการเชื่อมโยงกับกลุ่มเป้าหมายที่กำหนดเอง
- แอปสามารถให้สิทธิ์แพลตฟอร์มเทคโนโลยีโฆษณาของบุคคลที่สามเพื่อจัดการกลุ่มเป้าหมายที่กําหนดเองในนามของแอปได้
การออกแบบความสามารถนี้อยู่ระหว่างดำเนินการและรายละเอียดจะรวมอยู่ในการอัปเดตในภายหลัง
การควบคุมแพลตฟอร์มเทคโนโลยีโฆษณา
ข้อเสนอนี้ระบุวิธีที่เทคโนโลยีโฆษณาจะใช้ควบคุมกลุ่มเป้าหมายที่กำหนดเองได้ ดังนี้
- เทคโนโลยีโฆษณาลงทะเบียนด้วย Privacy Sandbox และระบุโดเมน eTLD+1 ที่ จับคู่ URL ทั้งหมดสำหรับกลุ่มเป้าหมายที่กำหนดเอง
- เทคโนโลยีโฆษณาสามารถเป็นพาร์ทเนอร์กับแอปหรือ SDK เพื่อมอบโทเค็นการยืนยันที่ ใช้เพื่อยืนยันการสร้างกลุ่มเป้าหมายที่กำหนดเอง เมื่อมีการมอบสิทธิ์กระบวนการนี้ให้กับ พาร์ทเนอร์, สามารถกำหนดค่าการสร้างกลุ่มเป้าหมายที่กำหนดเองให้ต้องมีการตอบรับ จากเทคโนโลยีโฆษณา
- เทคโนโลยีโฆษณาสามารถเลือกที่จะปิดใช้งานการโทร
joinCustomAudience
ในนามของตนเองได้ และอนุญาตเฉพาะ API ของfetchAndJoinCustomAudience
ในการเปิดใช้การเรียกที่กำหนดเองทั้งหมด กลุ่มเป้าหมาย คุณอัปเดตการควบคุมได้ในระหว่างการลงทะเบียน Privacy Sandbox โปรดทราบว่าการควบคุมจะอนุญาตเทคโนโลยีโฆษณาทั้งหมดหรือไม่อนุญาตเลย เนื่องจากข้อจำกัดแพลตฟอร์ม สิทธิ์การมอบอำนาจจะใช้ไม่ได้กับเทคโนโลยีโฆษณาแต่ละรายการ
ตัวเลือกโฆษณาและการตอบกลับข้อมูลเมตา
โฆษณาและข้อมูลเมตาที่เป็นผู้สมัครซึ่งแสดงผลจากแพลตฟอร์มฝั่งซื้อควรมีช่องต่อไปนี้
- ข้อมูลเมตา: ข้อมูลเมตาของโฆษณาเฉพาะด้านเทคโนโลยีฝั่งผู้ซื้อ ตัวอย่างเช่น อาจเป็น มีข้อมูลเกี่ยวกับแคมเปญโฆษณาและเกณฑ์การกำหนดเป้าหมาย เช่น ตำแหน่งที่ตั้งและภาษา
- URL การแสดงผล: ปลายทางสำหรับการแสดงครีเอทีฟโฆษณา
- ตัวกรอง: ข้อมูลที่ไม่บังคับที่จําเป็นสําหรับ Protected Audience API เพื่อกรองโฆษณาตามข้อมูลในอุปกรณ์ อ่านรายละเอียดเพิ่มเติมได้ที่ส่วนตรรกะการกรองฝั่งซื้อ
เวิร์กโฟลว์การเลือกโฆษณา
ข้อเสนอนี้มีวัตถุประสงค์เพื่อปรับปรุงความเป็นส่วนตัวโดยเปิดตัวตัวเลือกโฆษณา API ซึ่งจัดการการประมูลสำหรับแพลตฟอร์มเทคโนโลยีโฆษณา
ปัจจุบันแพลตฟอร์มเทคโนโลยีโฆษณามักจะทำการเสนอราคาและเลือกโฆษณาในเซิร์ฟเวอร์ของตนเอง ภายใต้ข้อเสนอนี้ กลุ่มเป้าหมายที่กําหนดเองและสัญญาณอื่นๆ ที่ละเอียดอ่อนของผู้ใช้ เช่น ข้อมูลแพ็กเกจที่ติดตั้งได้ จะเข้าถึงได้ผ่าน Ad Selection API เท่านั้น นอกจากนี้ สำหรับกรณีการใช้งานรีมาร์เก็ตติ้ง โฆษณาที่ผู้สมัครจะดึงออกนอกขอบเขต (กล่าวคือไม่อยู่ในบริบทที่โฆษณา จะปรากฏขึ้น) แพลตฟอร์มเทคโนโลยีโฆษณาจะต้องเตรียมการเพื่อให้ การประมูลและตรรกะการเลือกโฆษณา ในปัจจุบันของลูกค้ามีการปรับใช้และดำเนินการใน อุปกรณ์ แพลตฟอร์มเทคโนโลยีโฆษณาอาจพิจารณาการเปลี่ยนแปลงต่อไปนี้ในโฆษณา ขั้นตอนการทำงานที่เลือก:
- เทคโนโลยีโฆษณาที่ไม่มีข้อมูลแพ็กเกจที่ติดตั้งบนเซิร์ฟเวอร์ แพลตฟอร์มต่างๆ อาจต้องการส่งโฆษณาตามบริบทหลายรายการกลับไปยังอุปกรณ์ และ เรียกใช้เวิร์กโฟลว์การเลือกโฆษณาเพื่อเปิดใช้การกรองตามการติดตั้งแอปตามลำดับ เพื่อเพิ่มโอกาสในการแสดงโฆษณาที่เกี่ยวข้องให้ได้สูงสุด
- เนื่องจากโฆษณารีมาร์เก็ตติ้งถูกดึงออกจากช่วงสัญญาณ รูปแบบการเสนอราคาปัจจุบันจึงอาจ ต้องอัปเดต แพลตฟอร์มเทคโนโลยีโฆษณาอาจต้องการสร้างโมเดลย่อยสำหรับการเสนอราคา (การใช้งานอาจอิงตามรูปแบบที่เรียกว่าโมเดล 2 หอคอย) ซึ่งสามารถทํางานกับฟีเจอร์โฆษณาและสัญญาณตามบริบทแยกกัน และรวมเอาเอาต์พุตของโมเดลย่อยในอุปกรณ์เพื่อคาดการณ์ราคาเสนอ ซึ่งจะใช้ประโยชน์ได้จากการประมูลฝั่งเซิร์ฟเวอร์และการประมูลสําหรับโอกาสในการโฆษณาหนึ่งๆ
แนวทางนี้ช่วยให้ข้อมูลการโต้ตอบในแอปของผู้ใช้ ช่วยประกอบการเลือกโฆษณา และจำกัดการแชร์ข้อมูลนี้กับบุคคลที่สาม
เวิร์กโฟลว์การเลือกโฆษณานี้จะจัดระเบียบการเรียกใช้โค้ด JavaScript ที่ได้จากเทคโนโลยีโฆษณาบนอุปกรณ์ตามลําดับต่อไปนี้
- การดำเนินการตรรกะการเสนอราคาฝั่งผู้ซื้อ
- การกรองและการประมวลผลโฆษณาฝั่งผู้ซื้อ
- การดำเนินการตามตรรกะการตัดสินใจฝั่งผู้ขาย
สําหรับการเลือกโฆษณาที่เกี่ยวข้องกับกลุ่มเป้าหมายที่กําหนดเอง แพลตฟอร์มจะดึงข้อมูลโค้ด JavaScript ที่ได้จากฝั่งซื้อตามปลายทาง URL สาธารณะที่กําหนดโดยข้อมูลเมตา "URL ของตรรกะการเสนอราคา" ของกลุ่มเป้าหมายที่กําหนดเอง ระบบจะส่งปลายทาง URL สําหรับโค้ดการตัดสินใจฝั่งผู้ขายเป็นอินพุตเพื่อเริ่มเวิร์กโฟลว์การเลือกโฆษณาด้วย
การออกแบบการเลือกโฆษณาที่ไม่เกี่ยวข้องกับกลุ่มเป้าหมายที่กำหนดเองทำงานอยู่ การออกแบบอีกด้วย
เริ่มเวิร์กโฟลว์การเลือกโฆษณา
เมื่อแอปจำเป็นต้องแสดงโฆษณา SDK ของแพลตฟอร์มเทคโนโลยีโฆษณาอาจเริ่มแสดงโฆษณา
เวิร์กโฟลว์การเลือกโดยเรียกใช้เมธอด selectAds()
หลังจากสร้างอินสแตนซ์
ออบเจ็กต์ AdSelectionConfig
ที่มีพารามิเตอร์ที่คาดไว้:
- ผู้ขาย: ตัวระบุสำหรับแพลตฟอร์มโฆษณาฝั่งขายตาม eTLD+1 รูปแบบ
- URL ตรรกะการตัดสิน: เมื่อเริ่มการประมูลโฆษณา แพลตฟอร์มจะใช้ URL นี้เพื่อดึงข้อมูลโค้ด JavaScript จากแพลตฟอร์มฝั่งขายเพื่อประเมินโฆษณาที่ชนะ
- ผู้ซื้อกลุ่มเป้าหมายที่กำหนดเอง: รายการแพลตฟอร์มฝั่งซื้อที่มีดีมานด์ตามกลุ่มเป้าหมายที่กำหนดเองสำหรับการประมูลนี้ โดยเป็นไปตามรูปแบบ eTLD+1
- สัญญาณการเลือกโฆษณา: ข้อมูลเกี่ยวกับการประมูล (ขนาดโฆษณา รูปแบบโฆษณา เป็นต้น)
- สัญญาณผู้ขาย: สัญญาณเฉพาะแพลตฟอร์มฝั่งขาย
- URL สัญญาณการให้คะแนนที่เชื่อถือได้: ปลายทาง URL ของสัญญาณที่เชื่อถือได้ฝั่งขายจาก ข้อมูลแบบเรียลไทม์เฉพาะครีเอทีฟโฆษณาที่จะดึงข้อมูลได้
- สัญญาณต่อผู้ซื้อ: ฝั่งดีมานด์ที่เข้าร่วมอาจใช้พารามิเตอร์นี้เพื่อ ให้ข้อมูลสำหรับการประมูล ตัวอย่างเช่น พารามิเตอร์นี้อาจรวม ข้อมูลบริบทที่ครอบคลุม ซึ่งเป็นประโยชน์ในการกำหนดราคาเสนอ
ข้อมูลโค้ดแสดงตัวอย่างต่อไปนี้แสดง SDK ของแพลตฟอร์มเทคโนโลยีโฆษณาที่เริ่มต้นเวิร์กโฟลว์การเลือกโฆษณาโดยกำหนด AdSelectionConfig
ก่อน จากนั้นเรียกใช้ selectAds
เพื่อรับโฆษณาที่ชนะ
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig {
Seller = "example-ssp1.com",
DecisionLogicURL = Uri.parse("https://..."),
CustomAudienceBuyerList = Arrays.asList("example-dsp1.com","bexample-dsp2.com"),
AdSelectionSignals = "{"min_price": 10,"auction_attempts": 3}"
SellerSignals = "{"seller_type": "news", "content_category": "sports","mature_ads_accepted" :"false"}"
PerBuyerSignals = " {"buyer1Name": {"key1" : "value1"},
"buyer2Name": {"key1" : "value1", "key2" : "value2" }"
};
// Invoke ad services API to initiate ad selection workflow.
Ad winningAd = selectAds(myAdSelectionConfig);
ตรรกะการเสนอราคาฝั่งผู้ซื้อ
ตรรกะการเสนอราคานี้มักจะมาจากแพลตฟอร์มฝั่งซื้อ วัตถุประสงค์ของโค้ดนี้คือเพื่อกำหนดราคาเสนอสำหรับโฆษณาที่มีโอกาสแสดง อาจมี ตรรกะทางธุรกิจในการพิจารณาผลลัพธ์
แพลตฟอร์มจะใช้ "URL ตรรกะการเสนอราคา" ของกลุ่มเป้าหมายที่กำหนดเอง ข้อมูลเมตาไปยัง เรียกโค้ด JavaScript ซึ่งควรมีลายเซ็นของฟังก์ชันด้านล่าง:
generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
contextual_signals, user_signals, custom_audience_signals) {
// ...
return {'bid': ...};
}
เมธอด generateBid()
จะแสดงผลราคาเสนอที่คำนวณแล้ว แพลตฟอร์มจะ
เรียกใช้ฟังก์ชันนี้สำหรับโฆษณาทั้งหมด (ตามบริบทหรือรีมาร์เก็ตติ้ง) ตามลำดับ ถ้า
มีผู้ให้บริการตรรกะการเสนอราคาหลายราย ระบบไม่ได้รับประกันว่า
ลำดับการดำเนินการในบรรดาผู้ให้บริการ
ฟังก์ชันควรมีพารามิเตอร์ต่อไปนี้
- โฆษณา: โฆษณาที่โค้ดการเสนอราคาฝั่งซื้อพิจารณา นี่จะเป็น โฆษณาจากกลุ่มเป้าหมายที่กำหนดเองที่มีสิทธิ์
- สัญญาณการประมูล: สัญญาณเฉพาะแพลตฟอร์มฝั่งขาย
- สัญญาณต่อผู้ซื้อ: ฝ่ายดีมานด์ที่เข้าร่วมอาจใช้พารามิเตอร์นี้เพื่อป้อนข้อมูลสำหรับการประมูล ตัวอย่างเช่น พารามิเตอร์นี้อาจรวมข้อมูลตามบริบทที่ครอบคลุมซึ่งเป็นประโยชน์ในการกำหนดราคาเสนอ
- สัญญาณการเสนอราคาที่เชื่อถือได้: แพลตฟอร์มเทคโนโลยีโฆษณาใช้ข้อมูลแบบเรียลไทม์เพื่อ เป็นข้อมูลสำหรับการเรียกและการให้คะแนนโฆษณา เช่น แคมเปญโฆษณาอาจหมด และจะต้องหยุดแสดงทันที เทคโนโลยีโฆษณาจะกำหนด ปลายทางของ URL ที่สามารถดึงข้อมูลแบบเรียลไทม์นี้และชุดคีย์ ที่ต้องดำเนินการค้นหาแบบเรียลไทม์ เซิร์ฟเวอร์ที่มีการจัดการของแพลตฟอร์มเทคโนโลยีโฆษณาที่แสดงคําขอนี้จะถือเป็นเซิร์ฟเวอร์ที่เชื่อถือได้ซึ่งจัดการโดยแพลตฟอร์มเทคโนโลยีโฆษณา
- สัญญาณบริบท: อาจรวมถึงการประทับเวลาแบบคร่าวๆ หรือค่าประมาณ ข้อมูลสถานที่ตั้ง หรือต้นทุนต่อคลิกในโฆษณา
- สัญญาณจากผู้ใช้: ข้อมูลนี้อาจรวมถึงข้อมูล เช่น ข้อมูลที่ติดตั้งไว้ ข้อมูลแพ็กเกจ
ค่าโฆษณา
นอกจากราคาเสนอแล้ว แพลตฟอร์มฝั่งผู้ซื้อยังมีตัวเลือกในการแสดงผลต้นทุนต่อการคลิกเป็นส่วนหนึ่งของ generateBid()
เช่น
generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
contextual_signals, user_signals, custom_audience_signals) {
// ...
return {'bid': ..., 'adCost': ...,};
}
หากโฆษณานี้เป็นผู้ชนะ adCost
จะปัดเศษทศนิยมเป็น 8 บิตสำหรับ
ความเป็นส่วนตัว จากนั้นระบบจะส่งค่าที่ปัดเศษของ adCost
ไปยังพารามิเตอร์ contextual_signals
ใน reportWin
ในระหว่างการรายงานการแสดงผล
ตรรกะการกรองฝั่งผู้ซื้อ
แพลตฟอร์มฝั่งผู้ซื้อจะกรองโฆษณาตามสัญญาณเพิ่มเติมในอุปกรณ์ได้ในช่วงการเลือกโฆษณา ตัวอย่างเช่น แพลตฟอร์มเทคโนโลยีโฆษณาสามารถติดตั้งใช้งานความสามารถในการกําหนดความถี่สูงสุดได้ที่นี่ ถ้ามีองค์ประกอบ การกรองโดยอัตโนมัติ ระบบจะไม่ให้การรับประกันลำดับการดำเนินการระหว่าง ผู้ให้บริการเครือข่าย
ตรรกะการกรองฝั่งซื้อสามารถนำไปใช้เป็นส่วนหนึ่งของ
ตรรกะการเสนอราคาโดยแสดงผลมูลค่าราคาเสนอเป็น 0
สำหรับโฆษณาหนึ่งๆ
นอกจากนี้ แพลตฟอร์มฝั่งซื้อยังส่งสัญญาณให้ทราบว่า ควรกรองตามสัญญาณเพิ่มเติมในอุปกรณ์ที่ใช้ได้กับ Protected ผู้ชมจะไม่ออกไปจากอุปกรณ์ เมื่อเราเสริมความแข็งแกร่งในการออกแบบ ตรรกะการกรองเพิ่มเติม แพลตฟอร์มฝั่งซื้อจะเป็นไปตามโครงสร้างเดียวกันนี้ เป็นสัญญาณว่าจะมีการกรองเกิดขึ้น
ตรรกะการให้คะแนนฝั่งขาย
โดยปกติแล้ว แพลตฟอร์มฝั่งขายจะเป็นผู้ระบุตรรกะการให้คะแนน วัตถุประสงค์
ของโค้ดคือการกำหนดโฆษณาที่ชนะโดยดูจากผลลัพธ์ของตรรกะการเสนอราคา อาจ
ให้ใช้ตรรกะทางธุรกิจเพิ่มเติมเพื่อกำหนดผลลัพธ์ ถ้ามีองค์ประกอบ
ระบบจะไม่รับประกันลำดับการดำเนินการ
จากผู้ให้บริการ แพลตฟอร์มจะใช้พารามิเตอร์อินพุต "URL ของตรรกะการตัดสินใจ" ของ selectAds()
API เพื่อดึงข้อมูลโค้ด JavaScript ซึ่งควรมีลายเซ็นฟังก์ชันด้านล่างนี้
scoreAd(ad, bid, auction_config, trusted_scoring_signals,
contextual_signals, user_signals, custom_audience_signals) {
// ...
return score_for_this_ad;
}
ฟังก์ชันควรมีพารามิเตอร์ต่อไปนี้
- โฆษณา: โฆษณาที่กําลังประเมิน เอาต์พุตจากฟังก์ชัน
generateBid()
- ราคาเสนอ: เอาต์พุตราคาเสนอจากฟังก์ชัน
generateBid()
- การกําหนดค่าการประมูล: พารามิเตอร์อินพุตไปยังเมธอด
selectAds()
- สัญญาณการให้คะแนนที่เชื่อถือได้: แพลตฟอร์มเทคโนโลยีโฆษณาใช้ข้อมูลแบบเรียลไทม์เพื่อใช้ในการกรองและคะแนนโฆษณา ตัวอย่างเช่น ผู้เผยแพร่แอปอาจบล็อกแคมเปญโฆษณาไม่ให้แสดงโฆษณาในแอป ระบบจะดึงข้อมูลนี้มาจากพารามิเตอร์ URL ของสัญญาณการให้คะแนนที่เชื่อถือได้ของการกำหนดค่าการประมูล เซิร์ฟเวอร์ที่แสดงคำขอนี้ควรเป็นเซิร์ฟเวอร์ที่เชื่อถือได้ซึ่งจัดการโดยเทคโนโลยีโฆษณา
- สัญญาณตามบริบท: ซึ่งอาจรวมถึงการประทับเวลาแบบหยาบหรือข้อมูลตำแหน่งโดยประมาณ
- สัญญาณของผู้ใช้: ซึ่งอาจรวมถึงข้อมูล เช่น App Store ที่เริ่มการติดตั้งแอป
- สัญญาณกลุ่มเป้าหมายที่กําหนดเอง: หากโฆษณาที่ได้รับการให้คะแนนมาจากในอุปกรณ์ กลุ่มเป้าหมายที่กำหนดเอง ซึ่งจะมีข้อมูล เช่น ผู้อ่านและชื่อของ กลุ่มเป้าหมายที่กำหนดเอง
รันไทม์ของโค้ดการเลือกโฆษณา
ในข้อเสนอ ระบบจะดึงข้อมูลโค้ดการประมูลที่ได้จากแพลตฟอร์มเทคโนโลยีโฆษณา จากปลายทาง URL ที่กำหนดค่าได้และเรียกใช้ในอุปกรณ์ รหัสการประมูลควรเป็นไปตามหลักเกณฑ์ต่อไปนี้เนื่องจากข้อจํากัดด้านทรัพยากรในอุปกรณ์เคลื่อนที่
- โค้ดควรทำงานเสร็จภายในระยะเวลาที่กำหนดไว้ล่วงหน้า ขอบเขตนี้จะใช้กับเครือข่ายโฆษณาของผู้ซื้อทั้งหมดอย่างเท่าเทียม เราจะแชร์รายละเอียดของขอบเขตนี้ในการอัปเดตครั้งถัดไป
- โค้ดต้องมีทุกอย่างครบสมบูรณ์และไม่มีการอ้างอิงภายนอก
เนื่องจากโค้ดการประมูล เช่น ตรรกะการเสนอราคา อาจต้องเข้าถึงข้อมูลส่วนตัวของผู้ใช้ เช่น แหล่งที่มาของการติดตั้งแอป รันไทม์จึงจะไม่ให้สิทธิ์เข้าถึงเครือข่ายหรือพื้นที่เก็บข้อมูล
ภาษาโปรแกรม
ส่วนโค้ดการประมูลที่ได้จากแพลตฟอร์มเทคโนโลยีโฆษณาควรเขียนเป็น JavaScript วิธีนี้จะช่วยให้แพลตฟอร์มเทคโนโลยีโฆษณาแชร์โค้ดการเสนอราคาข้าม แพลตฟอร์มที่รองรับ Privacy Sandbox
การแสดงโฆษณาที่มีประสิทธิภาพสูงสุด
โฆษณาที่มีคะแนนสูงสุดจะถือว่าเป็นผู้ชนะการประมูล ในข้อเสนอเริ่มต้นนี้ ระบบจะส่งโฆษณาที่ชนะไปยัง SDK เพื่อแสดงผล
แผนของเราคือการปรับปรุงโซลูชันเพื่อให้มั่นใจว่าแอปหรือ SDK ไม่สามารถระบุข้อมูลเกี่ยวกับการเป็นสมาชิกกลุ่มเป้าหมายที่กำหนดเองของผู้ใช้หรือประวัติการมีส่วนร่วมในแอปผ่านข้อมูลเกี่ยวกับโฆษณาที่มีประสิทธิภาพสูงสุดได้ (คล้ายกับข้อเสนอเฟรมที่มีรั้วล้อม) ของ Chrome
การรายงานการแสดงผลและเหตุการณ์
เมื่อมีการแสดงโฆษณา การแสดงผลที่ชนะสามารถรายงานกลับไปยัง แพลตฟอร์มฝั่งซื้อและฝั่งขายที่เข้าร่วม ซึ่งช่วยให้ผู้ซื้อและผู้ขาย เพื่อรวมข้อมูลจากการประมูล เช่น ราคาเสนอ หรือกลุ่มเป้าหมายที่กำหนดเอง ด้วยรายงานการแสดงผลที่ชนะ นอกจากนี้ แพลตฟอร์มฝั่งขายและแพลตฟอร์มฝั่งผู้ซื้อที่ชนะยังมีสิทธิ์รับการรายงานระดับเหตุการณ์เพิ่มเติมเกี่ยวกับโฆษณาที่ชนะ ซึ่งช่วยให้คุณรวมข้อมูลเกี่ยวกับการประมูล (ราคาเสนอ ชื่อกลุ่มเป้าหมายที่กำหนดเอง ฯลฯ) กับการคลิก การดู และเหตุการณ์อื่นๆ ของโฆษณาได้ แพลตฟอร์มจะเรียกใช้ตรรกะการรายงานตามลําดับนี้
- การรายงานฝั่งขาย
- การรายงานฝั่งซื้อ
วิธีนี้จะช่วยให้แพลตฟอร์มฝั่งซื้อและฝั่งขายมีวิธีส่งข้อมูลที่สำคัญในอุปกรณ์ ข้อมูลกลับไปยังเซิร์ฟเวอร์เพื่อเพิ่มความสามารถต่างๆ เช่น การจัดทำงบประมาณแบบเรียลไทม์ การอัปเดตรูปแบบการเสนอราคา และเวิร์กโฟลว์การเรียกเก็บเงินที่ถูกต้อง การรายงานการแสดงผลนี้ ซึ่งเป็นส่วนเสริมของ Attribution Reporting API
การสนับสนุนการรายงานเหตุการณ์มี 2 ขั้นตอน ได้แก่ ฝั่งขายและฝั่งซื้อ JavaScript ต้องบันทึกเหตุการณ์ที่ควรได้รับรายงานเหตุการณ์ และ ฝั่งผู้ขายมีหน้าที่ในการรายงานข้อมูลระดับเหตุการณ์
Protected Audience มีกลไกในการติดตามเหตุการณ์ในอนาคตที่เกี่ยวข้องกับ
ที่ชนะการประมูลโดยการลงทะเบียนบีคอน ในreportResult()
ฟังก์ชัน JavaScript ของผู้ขาย แพลตฟอร์มฝั่งขายจะลงทะเบียนบีคอนได้โดยใช้ฟังก์ชัน registerAdBeacon()
ของแพลตฟอร์ม ในทํานองเดียวกัน แพลตฟอร์มฝั่งซื้อสามารถเรียกใช้registerAdBeacon()
จากฟังก์ชัน JavaScript reportWin()
registerAdBeacon(beacons)
อินพุต:
event_key
: สตริงที่ระบุประเภทการโต้ตอบที่ควรลงทะเบียน ส่วนนี้จะใช้เป็นคีย์ในการค้นหาปลายทางที่คําสั่ง ping ของแพลตฟอร์มในขณะที่ รายงานผลการประมูลreporting_url
: URL ที่เป็นของแพลตฟอร์มเทคโนโลยีโฆษณาสําหรับการจัดการเหตุการณ์
คีย์เหตุการณ์คือตัวระบุสตริงที่เป็นของ SDK ฝั่งขายซึ่งมีหน้าที่รับผิดชอบในการรายงานผลลัพธ์ของการประมูล หากต้องการให้ระบบติดต่อกลับ
เทคโนโลยีโฆษณาจะลงทะเบียนบีคอนซึ่งมีคีย์ที่ตรงกับคีย์ที่ฝั่งขายใช้
เมื่อรายงานเหตุการณ์ ซึ่งไม่จำเป็นต้องเป็น k-anonymous แม้ว่าจะมี
ขีดจำกัดของจำนวนและความยาวของคีย์ที่ลงทะเบียนสำหรับ
กลุ่มเป้าหมายที่กำหนดเองที่ระบุ หากเรียกใช้ reportEvent()
ให้เรียกใช้แพลตฟอร์มฝั่งขายที่
ที่จัดการประมูลจะมีสิทธิ์ได้รับรายงานเหตุการณ์เหล่านี้เสมอ เฉพาะ
แพลตฟอร์มฝั่งผู้ซื้อที่ชนะจะมีสิทธิ์รับรายงานเหล่านี้
การรายงานฝั่งผู้ขาย
แพลตฟอร์มจะเรียกฟังก์ชัน JavaScript reportResult()
ในการจัดหา
รหัสที่ให้ไว้ด้านข้างซึ่งดาวน์โหลดจาก URL ของตรรกะการตัดสินใจของผู้ขาย
พารามิเตอร์สำหรับ selectAds()
API:
reportResult(render_url, bid, auction_config, contextual_signals) {
// ...
beacons = {"click":clickUri}
registerAdBeacon(beacons)
return {
"status": 0,
"results": {"reporting_url": reporting_url,
"signals_for_buyer": signals_for_buyer}};
}
เอาต์พุต: ออบเจ็กต์ JSON ที่มี
- สถานะ:
0
สำหรับสำเร็จ ค่าอื่นๆ สำหรับความล้มเหลว - URL การรายงาน: แพลตฟอร์มจะเรียก URL นี้ที่แสดงผลจากฟังก์ชัน
- สัญญาณสำหรับผู้ซื้อ: ออบเจ็กต์ JSON ที่จะส่งไปยัง
reportWin
ของผู้ซื้อ
ฝั่งซัพพลายอาจเข้ารหัสสัญญาณที่เกี่ยวข้องใน URL การรายงานเพื่อช่วย ได้รับข้อมูลเชิงลึกเพิ่มเติมเกี่ยวกับการประมูลและโฆษณาที่ชนะการประมูล เช่น อาจมีสัญญาณต่อไปนี้
- URL การนําเสนอโฆษณา
- ราคาเสนอที่ชนะ
- ชื่อแอป
- ตัวระบุการค้นหา
- สัญญาณสำหรับผู้ซื้อ: เพื่อรองรับการแชร์ข้อมูลระหว่างฝั่งซัพพลายและดีมานด์ แพลตฟอร์มจะส่งค่าผลลัพธ์นี้เป็นพารามิเตอร์อินพุตไปยัง โค้ดการรายงานฝั่งดีมานด์
การรายงานฝั่งซื้อ
แพลตฟอร์มจะเรียกใช้reportWin()
ฟังก์ชัน JavaScript ในโค้ดที่ฝั่งดีมานด์ระบุซึ่งดาวน์โหลดมาจากข้อมูลเมตา URL ของตรรกะการเสนอราคาของกลุ่มเป้าหมายที่กำหนดเองซึ่งเชื่อมโยงกับการประมูล
reportWin(render_url, bid, auction_signals, per_buyer_signals,
signals_for_buyer, contextual_signals, custom_audience_signals) {
// ...
beacons = {"click":clickUri}
registerAdBeacon(beacons)
return {
"status": 0,
"results": {"reporting_uri": reporting_uri}};
}
อินพุต:
- ดึงข้อมูล
auction_signals
และper_buyer_signals
จากAuctionConfig
ข้อมูลใดก็ตามที่แพลตฟอร์มฝั่งซื้อต้องส่งไปยัง URL การรายงานอาจมาจากข้อมูลนี้ signals_for_buyer
เป็นผลลัพธ์ของ reportผลลัพธ์ ของฝั่งผู้ขาย ซึ่งจะให้ แพลตฟอร์มฝั่งขายที่มีโอกาสแชร์ข้อมูลกับฝั่งซื้อ แพลตฟอร์มเพื่อใช้ในการรายงานcontextual_signals
มีข้อมูล เช่น ชื่อแอป และcustom_audience_signals
มีข้อมูลกลุ่มเป้าหมายที่กําหนดเอง อื่นๆ อาจเพิ่มในอนาคต
เอาต์พุต:
- สถานะ:
0
สำหรับสำเร็จ ค่าอื่นๆ สำหรับความล้มเหลว - URL การรายงาน: แพลตฟอร์มจะเรียกใช้ URL นี้ที่แสดงผลจากฟังก์ชัน
เหตุการณ์การรายงาน
การรายงานเหตุการณ์จะทำได้หลังจากที่การรายงานการแสดงผลสําหรับการประมูลได้
เสร็จสมบูรณ์แล้ว SDK ฝั่งขายมีหน้าที่รับผิดชอบในการรายงานเหตุการณ์
แพลตฟอร์มแสดง API ที่ใช้ ReportEventRequest
ที่ระบุ
การประมูลที่เรียกใช้เมื่อเร็วๆ นี้ คีย์เหตุการณ์ที่มีการรายงาน ข้อมูลที่เชื่อมโยงกับ
รวมถึงควรส่งรายงานไปยังผู้ซื้อหรือผู้ขาย (หรือ
ทั้ง 2 แบบ) และเหตุการณ์อินพุตที่ไม่บังคับสำหรับเหตุการณ์โฆษณา ไคลเอ็นต์กำหนดเหตุการณ์
คีย์และการรวบรวมข้อมูลที่จะรายงาน
ReportEventRequest request = new ReportEventRequest(
AdSelectionId = ad_selection_id,
event_key = "view"
event_data = "{ "viewTimeInSeconds" :1 }",
reporting_destinations =
FLAG_REPORTING_DESTINATION_SELLER |
FLAG_REPORTING_DESTINATION_BUYER,
input_event = clickInputEvent // or null for view
)
reportEvent(request)
อินพุต:
ad_selection_id
ต้องเป็นAdSelectionId
ของการประมูลที่เพิ่งจัดขึ้น ดึงมาจากAdSelectionOutcome
event_key
คือสตริงที่กำหนดด้านการขายซึ่งอธิบายการโต้ตอบ กิจกรรมevent_data
คือสตริงที่แสดงข้อมูลที่เชื่อมโยงกับevent_key
reporting_destinations
เป็นชุดมาสก์เล็กน้อยโดยใช้ Flag ที่ให้ไว้โดย ที่มีการจัดการครบวงจรได้เลย โดยอาจเป็นFLAG_REPORTING_DESTINATION_SELLER
หรือFLAG_REPORTING_DESTINATION_BUYER
หรือทั้ง 2 อย่างinput_event
(ไม่บังคับ) ใช้สำหรับการผสานรวมกับ Attribution Reporting API อาจเป็นออบเจ็กต์InputEvent
(สําหรับเหตุการณ์การคลิก) หรือเป็นค่า Null (สําหรับเหตุการณ์การดู) ดูข้อมูลเพิ่มเติมในการผสานรวม Attribution Reporting API รายละเอียดของพารามิเตอร์นี้
หลังจาก SDK ฝั่งขายเรียกใช้ reportEvent
และขึ้นอยู่กับ
reporting_destinations
แฟล็ก แพลตฟอร์มจะพยายามจับคู่ event_key
กับ
คีย์ที่ลงทะเบียนโดยผู้ซื้อและผู้ขายใน reportWin
และ
reportResult
ฟังก์ชัน JavaScript หากมีชื่อที่ตรงกัน แพลตฟอร์มจะ POST เป็น
event_data
ไปยัง reporting_url
ที่เชื่อมโยง ประเภทเนื้อหาของคําขอคือข้อความธรรมดาที่มีevent_data
เป็นเนื้อหา เราสร้างคำขอนี้ให้ดีที่สุด
ความพยายามและล้มเหลวโดยไม่มีการแจ้งเตือนในกรณีที่เครือข่ายเกิดข้อผิดพลาด
หรือไม่พบคีย์ที่ตรงกัน
การผสานรวม Attribution Reporting API
เราพร้อมให้การสนับสนุนผู้ซื้อที่เข้าร่วมการประมูลที่ใช้ Protected Audience API ให้ฟังก์ชันการทำงานแบบข้าม API ใน Protected Audience และ Attribution Reporting API (ARA) ฟังก์ชันการทำงานนี้ช่วยให้เทคโนโลยีโฆษณาประเมิน ประสิทธิภาพการระบุแหล่งที่มาในกลยุทธ์รีมาร์เก็ตติ้งต่างๆ เพื่อให้ เพื่อให้เข้าใจว่ากลุ่มเป้าหมายประเภทใดให้ ROI สูงที่สุด
การผสานรวมข้าม API นี้ทำให้ AdTech ทำสิ่งต่อไปนี้ได้
- สร้างการแมปค่าคีย์ของ URI เพื่อใช้สําหรับทั้ง 1) การรายงานการโต้ตอบกับโฆษณา และ 2) การลงทะเบียนแหล่งที่มา
- รวมข้อมูลการประมูลจากการประมูลกลุ่มเป้าหมายที่ได้รับการคุ้มครองในการแมปคีย์ฝั่งแหล่งที่มาสําหรับการรายงานสรุปรวม (โดยใช้ Attribution Reporting API) ดูข้อมูลเพิ่มเติมได้ในข้อเสนอการออกแบบ ARA
เมื่อผู้ใช้เห็นหรือคลิกโฆษณา
- URL ที่ใช้รายงานการโต้ตอบกับเหตุการณ์เหล่านั้นโดยใช้ Protected Audience จะระบุข้อมูลที่จำเป็นให้แก่ผู้ซื้อเพื่อใช้ในการบันทึกการดูหรือการคลิกเป็นแหล่งที่มาที่มีสิทธิ์ด้วย Attribution Reporting API
- เทคโนโลยีโฆษณาอาจเลือกส่ง
CustomAudience
(หรือบริบทที่เกี่ยวข้องอื่นๆ ข้อมูลเกี่ยวกับโฆษณา เช่น ตำแหน่งโฆษณา หรือระยะเวลาการดู) โดยใช้ URL ดังกล่าว เพื่อให้ข้อมูลเมตานี้เผยแพร่ไปยังรายงานสรุปได้เมื่อเทคโนโลยีโฆษณา กำลังตรวจสอบประสิทธิภาพแคมเปญโดยรวม
การเปิดใช้การลงทะเบียนแหล่งที่มา
reportEvent()
จะยอมรับพารามิเตอร์ที่ไม่บังคับใหม่ InputEvent
ชนะ
ผู้ซื้อที่ลงทะเบียนบีคอนโฆษณาสามารถเลือกรับรายงาน reportEvent ได้
ซึ่งลงทะเบียนกับ Attribution Reporting API เป็นแหล่งที่มาที่ลงทะเบียนแล้ว ระบบจะเพิ่มส่วนหัว "มีสิทธิ์รายงานการระบุแหล่งที่มา" ลงในคำขอรายงานเหตุการณ์ทั้งหมดที่ส่งจาก reportEvent()
การตอบกลับที่มีส่วนหัว ARA ที่เหมาะสมจะได้รับการแยกวิเคราะห์ในลักษณะเดียวกับการตอบกลับการลงทะเบียนแหล่งที่มา ARA ปกติอื่นๆ ดูวิธีทำสิ่งต่างๆ ได้ในคำอธิบาย Attribution Reporting API
ลงทะเบียน URL แหล่งที่มา
เนื่องจาก ARA บน Android รองรับกิจกรรมการดูและการคลิก InputEvents
จะใช้เพื่อแยกระหว่าง 2 ประเภทนี้ เช่นเดียวกับการลงทะเบียนแหล่งที่มา ARA reportEvent()
API จะตีความInputEvent
ที่ยืนยันโดยแพลตฟอร์มเป็นเหตุการณ์คลิก หากไม่มี InputEvent
หรือ InputEvent
เป็นค่าว่างหรือไม่ถูกต้อง ระบบจะถือว่าการลงทะเบียนแหล่งที่มาเป็นการดู
โปรดทราบว่า eventData
หลังการประมูลอาจมีข้อมูลที่ละเอียดอ่อน ดังนั้นแพลตฟอร์มจึงนำ eventData
ออกจากคำขอลงทะเบียนแหล่งที่มาที่เปลี่ยนเส้นทาง
ตัวอย่างการรายงานการมีส่วนร่วมและ Conversion
ในตัวอย่างนี้ เราจะดูจากมุมมองของผู้ซื้อที่สนใจ ในการเชื่อมโยงข้อมูลจากการประมูล โฆษณาที่แสดงผล และแอป Conversion
ในเวิร์กโฟลว์นี้ ผู้ซื้อจะประสานงานกับผู้ขายเพื่อส่งรหัสที่ไม่ซ้ำกันไปยัง การประมูล ในระหว่างการประมูล ผู้ซื้อจะส่งรหัสที่ไม่ซ้ำกันนี้พร้อม ข้อมูลการประมูล ในระหว่างการแสดงผลและเวลาเกิด Conversion ข้อมูลจากโฆษณาที่แสดง จะส่งออกไปโดยมีรหัสที่ไม่ซ้ำกันเหมือนกัน ภายหลัง คุณจะใช้รหัสที่ไม่ซ้ำกันเพื่อเชื่อมโยงรายงานเหล่านี้เข้าด้วยกันได้
ขั้นตอนการทำงาน:
ก่อนที่การประมูลจะเริ่มขึ้น ผู้ซื้อจะส่งรหัสที่ไม่ซ้ำกันให้กับผู้ขาย ซึ่งเป็นส่วนหนึ่งของ
การเสนอราคาตอบแบบเรียลไทม์ ("RTB") แบบเป็นโปรแกรมของบริษัท คุณสามารถตั้งค่ารหัสเป็นตัวแปรได้ เช่น auctionId
ระบบจะส่งรหัสเป็น perBuyerSignals
ใน auctionConfig
และรหัสจะพร้อมใช้งานในตรรกะการเสนอราคาของผู้ซื้อ
- ในระหว่างการเรียกใช้
reportWin
ผู้ซื้อสามารถลงทะเบียนบีคอนโฆษณาเพื่อ ถูกเรียกให้แสดงในระหว่างเวลาที่แสดงโฆษณา และสำหรับเหตุการณ์การโต้ตอบที่เฉพาะเจาะจง (registerAdBeacon()
) หากต้องการเชื่อมโยงสัญญาณการประมูลสำหรับเหตุการณ์โฆษณา ให้ตั้งค่าauctionId
เป็นพารามิเตอร์การค้นหาของ URL บีคอน - ในระหว่างที่มีการแสดงโฆษณา บีคอนที่คุณลงทะเบียนไว้ระหว่างการประมูลอาจ
ทริกเกอร์หรือปรับปรุงด้วยข้อมูลระดับเหตุการณ์ ผู้ขายต้องทริกเกอร์
reportEvent()
และส่งข้อมูลระดับเหตุการณ์ แพลตฟอร์มจะส่งคําขอ ping ไปยัง URL ของบีคอนโฆษณาที่ลงทะเบียนไว้ของผู้ซื้อซึ่งสัมพันธ์กับreportEvent()
ที่ทริกเกอร์ - ผู้ซื้อจะลงทะเบียนโฆษณากับ Attribution Reporting API โดย
ตอบกลับคำขอบีคอนโฆษณาด้วย
ส่วนหัว
Attribution-Reporting-Register-Source
วิธีเชื่อมโยงสัญญาณการประมูล สำหรับเหตุการณ์ Conversion ให้ตั้งค่าauctionId
ใน URL แหล่งที่มาของการลงทะเบียน
หลังจากกระบวนการข้างต้น ผู้ซื้อจะมีรายงานการประมูล รายงานการโต้ตอบ และรายงาน Conversion ซึ่งสามารถเชื่อมโยงโดยใช้รหัสที่ไม่ซ้ำกันซึ่งใช้เชื่อมโยงกันได้
เวิร์กโฟลว์ที่คล้ายกันจะมีผลกับผู้ขายหากผู้ขายต้องการเข้าถึงข้อมูลการระบุแหล่งที่มา และ
ผู้ขายสามารถใช้รหัสที่ไม่ซ้ำกันเพื่อส่งไปพร้อมกับ registerAdBeacon()
ได้ด้วย
การเรียกใช้ reportEvent()
มีพร็อพเพอร์ตี้ปลายทางที่สามารถใช้เพื่อส่ง
รายงานให้ทั้งผู้ซื้อและผู้ขายทราบ
เซิร์ฟเวอร์ที่เชื่อถือซึ่งจัดการโดยแพลตฟอร์มเทคโนโลยีโฆษณา
ตรรกะการเลือกโฆษณาในปัจจุบันต้องใช้ข้อมูลแบบเรียลไทม์ เช่น การลดลงของงบประมาณ เพื่อพิจารณาว่าควรเลือกผู้สมัครโฆษณาเข้าร่วมการประมูลหรือไม่ ทั้งแพลตฟอร์มฝั่งซื้อและฝั่งขายจะรับข้อมูลนี้ได้จากเซิร์ฟเวอร์ที่ใช้งาน เพื่อป้องกันไม่ให้ข้อมูลที่มีความละเอียดอ่อนรั่วไหลผ่านเซิร์ฟเวอร์เหล่านี้ ข้อเสนอจึงกำหนดข้อจำกัดต่อไปนี้
- ลักษณะการทำงานของเซิร์ฟเวอร์เหล่านี้ ซึ่งจะอธิบายภายหลังในส่วนนี้ ทำให้ข้อมูลผู้ใช้รั่วไหล
- เซิร์ฟเวอร์จะไม่สร้างโปรไฟล์ที่ไม่ระบุตัวบุคคลตามข้อมูลที่เห็น นั่นคือจะต้องเป็นเซิร์ฟเวอร์ที่ "เชื่อถือได้"
ฝั่งซื้อ: เมื่อฝั่งซื้อเริ่มต้นตรรกะการเสนอราคาฝั่งซื้อ แพลตฟอร์ม จะทำการเรียก HTTP ของข้อมูลการเสนอราคาที่เชื่อถือได้จากเซิร์ฟเวอร์ที่เชื่อถือได้ URL นี้สร้างขึ้นโดยการต่อท้าย URL และคีย์ที่มีอยู่ในข้อมูลเมตาของสัญญาณการเสนอราคาที่เชื่อถือได้ของกลุ่มเป้าหมายที่กําหนดเองที่ประมวลผล การดึงข้อมูลนี้จะดำเนินการเฉพาะเมื่อประมวลผลโฆษณาจากกลุ่มเป้าหมายที่กำหนดเองในอุปกรณ์เท่านั้น ในขั้นตอนนี้ ฝ่ายซื้อสามารถบังคับใช้งบประมาณ ตรวจสอบสถานะหยุดชั่วคราว/เลิกหยุดชั่วคราวของแคมเปญ ทำการกําหนดเป้าหมาย ฯลฯ
ด้านล่างคือตัวอย่าง URL สำหรับดึงข้อมูลการเสนอราคาที่เชื่อถือได้ โดยอิงตามการเสนอราคาที่เชื่อถือได้ ข้อมูลเมตาสัญญาณจากกลุ่มเป้าหมายที่กำหนดเอง
https://www.kv-server.example/getvalues?keys=key1,key2
การตอบสนองจากเซิร์ฟเวอร์ควรเป็นออบเจ็กต์ JSON ที่มีคีย์เป็น key1, key2 ฯลฯ และมูลค่าของที่จะใช้ได้กับฟังก์ชันการเสนอราคาของผู้ซื้อ
ฝั่งขาย: คล้ายกับขั้นตอนฝั่งซื้อด้านบน นั่นคือฝั่งขายอาจต้องการดึงข้อมูล เกี่ยวกับครีเอทีฟโฆษณา ที่พิจารณาในการประมูล ตัวอย่างเช่น ผู้เผยแพร่โฆษณาอาจต้องการบังคับไม่ให้ครีเอทีฟโฆษณาบางรายการแสดงในแอปของตนเนื่องจากข้อกังวลด้านความปลอดภัยของแบรนด์ เราสามารถดึงข้อมูลนี้และทำให้พร้อมใช้งานกับ ตรรกะการประมูลฝั่งขาย การค้นหาเซิร์ฟเวอร์ที่เชื่อถือฝั่งขายจะทํางานโดยใช้การดึงข้อมูล HTTP เช่นเดียวกับการค้นหาเซิร์ฟเวอร์ที่เชื่อถือฝั่งซื้อ URL ประกอบด้วยการต่อท้าย URL ของสัญญาณการให้คะแนนที่เชื่อถือได้ด้วย URL การนําเสนอของครีเอทีฟโฆษณาที่จําเป็นต้องดึงข้อมูล
ด้านล่างนี้คือตัวอย่าง URL สำหรับดึงข้อมูลเกี่ยวกับครีเอทีฟโฆษณาที่นำมาพิจารณาใน ตาม URL การแสดงครีเอทีฟโฆษณา
https://www.kv-server.example/getvalues?renderUrls=render_url1,render_url2
การตอบกลับจากเซิร์ฟเวอร์ควรเป็นออบเจ็กต์ JSON ซึ่งมีคีย์ที่ใช้แสดงผล URL ที่ส่งมาในคำขอ
เซิร์ฟเวอร์เหล่านี้จะดำเนินการด้วยวิธีที่เชื่อถือได้เพื่อให้มีความปลอดภัยหลายอย่าง สิทธิประโยชน์ด้านความเป็นส่วนตัว
- ค่าที่เซิร์ฟเวอร์แสดงผลสำหรับแต่ละคีย์จะเชื่อถือได้ว่าจะอิงตามคีย์นั้นๆ เท่านั้น
- เซิร์ฟเวอร์จะไม่ทำการบันทึกระดับเหตุการณ์
- เซิร์ฟเวอร์ไม่มีผลข้างเคียงอื่นๆ ตามคำขอเหล่านี้
เพื่อเป็นกลไกชั่วคราว ผู้ซื้อและผู้ขายสามารถดึงข้อมูลการเสนอราคาเหล่านี้ สัญญาณจากเซิร์ฟเวอร์ใดๆ ซึ่งรวมถึงเซิร์ฟเวอร์ที่เซิร์ฟเวอร์ทำงานด้วยตนเอง อย่างไรก็ตาม ในเวอร์ชันที่เผยแพร่ ระบบจะส่งคำขอไปยังเซิร์ฟเวอร์ประเภทคีย์-ค่าที่เชื่อถือได้เท่านั้น
ผู้ซื้อและผู้ขายสามารถใช้เซิร์ฟเวอร์ประเภทคีย์-ค่าที่เชื่อถือได้โดยทั่วไปสำหรับ แพลตฟอร์มที่เข้ากันได้กับ Privacy Sandbox ใน Android และสำหรับเว็บ