Protected Audience: คู่มือการผสานรวม

การติดตั้งใช้งาน Protected Audience (เดิมเรียกว่า FLEDGE) ใน Android มักเกี่ยวข้องกับการผสานรวมระหว่างแอปผู้ลงโฆษณา แอปผู้เผยแพร่โฆษณา ผู้ขาย และผู้ซื้อ คู่มือนี้มีไว้สำหรับพาร์ทเนอร์ที่วางแผนจะจัดการกลุ่มเป้าหมายที่กำหนดเองและเรียกใช้การประมูล ซึ่งรวมถึงเครือข่ายเทคโนโลยีโฆษณาที่ดำเนินการทั้งในฐานะผู้ซื้อและผู้ขาย แคมเปญโฆษณาที่แตกต่างกันอาจมีเป้าหมายที่แตกต่างกัน และไม่ได้ใช้ฟีเจอร์ Protected Audience ทั้งหมดสำหรับกรณีการใช้งานทั้งหมด คู่มือนี้พยายาม ระบุขั้นตอนที่จำเป็นเพื่อรองรับกรณีที่เฉพาะเจาะจงมากขึ้นทุกครั้งที่เป็นไปได้

หากต้องการเตรียมพร้อมสำหรับการติดตั้งใช้งาน Protected Audience ในการผลิตที่ปรับขนาดได้ พาร์ทเนอร์ อาจเริ่มทดสอบโดยจำลองจุดผสานรวมกับบุคคลที่สามอื่นๆ คู่มือนี้จะให้มุมมองที่ครอบคลุมเกี่ยวกับวิธีผสานรวม Protected Audience กับแอป Android เพื่อช่วย คุณในการวางแผนการผสานรวม ซึ่งอาจรวมถึงฟีเจอร์ที่ยังไม่ได้ใช้งานในระยะปัจจุบันของ Privacy Sandbox ใน Android Developer Preview ในกรณีเหล่านี้ เราจะให้คำแนะนำเกี่ยวกับไทม์ไลน์

เวิร์กโฟลว์การผสานรวม Protected Audience ประกอบด้วยขั้นตอนสำคัญ 4 ขั้นตอนที่ขับเคลื่อนโดย พาร์ทเนอร์เทคโนโลยีโฆษณาประเภทต่างๆ ดังนี้

1. ผู้ซื้อสร้างกลุ่มเป้าหมายที่กำหนดเอง
2. กระบวนการเลือกโฆษณาจะเลือกโฆษณาที่ชนะ
   1. แอปของผู้ขายจะเริ่มการเลือกโฆษณา
   2. บริการโฆษณาจะเรียกใช้โค้ดการกรองและการเสนอราคาฝั่งผู้ซื้อ
   3. บริการโฆษณาดำเนินการโค้ดการตัดสินใจฝั่งผู้ขาย
3. ระบบจะแสดงผลโฆษณาที่ชนะในแอปของผู้ขาย
4. รายงานการแสดงผลโฆษณาพร้อมให้บริการแก่ทั้งผู้ซื้อและผู้ขาย

แผนภาพต่อไปนี้แสดงขั้นตอนเหล่านี้

คำศัพท์

• ผู้ลงโฆษณา: บริษัทที่ดึงดูดผู้ใช้ด้วยการซื้อพื้นที่โฆษณา
• ผู้เผยแพร่โฆษณา: บริษัทที่ขายพื้นที่โฆษณาที่พร้อมใช้งานควบคู่ไปกับเนื้อหาของบริษัท
• ผู้ซื้อ: บริษัทเทคโนโลยีโฆษณาที่ช่วยให้ผู้ลงโฆษณาซื้อพื้นที่โฆษณาได้
• ผู้ขาย: บริษัทเทคโนโลยีโฆษณาที่ช่วยให้ผู้เผยแพร่โฆษณาขายพื้นที่โฆษณาได้
• เครือข่าย: บริษัทเทคโนโลยีโฆษณาที่ทำหน้าที่ทั้งผู้ซื้อและผู้ขาย
• เป็นเจ้าของและดำเนินการเอง: บริษัทที่ทำหน้าที่เป็นผู้เผยแพร่โฆษณา ผู้ขาย และผู้ซื้อ
• พาร์ทเนอร์การผสานรวม: บริษัทที่คุณต้องทำงานด้วยเพื่อ ผสานรวมกับ Protected Audience ให้สำเร็จ

ข้อกำหนดเบื้องต้น การมีส่วนร่วมของพาร์ทเนอร์การผสานรวม และการตั้งค่า

ส่วนนี้จะอธิบายกิจกรรมเบื้องต้นชุดหนึ่งเพื่อช่วยให้คุณเข้าใจวิธีการทำงานของ Protected Audience API วิธีเริ่มต้นใช้งานการผสานรวม Protected Audience API และวิธีมีส่วนร่วมกับพาร์ทเนอร์การผสานรวมในการติดตั้งใช้งาน Protected Audience API กิจกรรมเหล่านี้สามารถเกิดขึ้นพร้อมกันได้

ทำความคุ้นเคยกับ Protected Audience API

ขั้นตอนแรกคือการทำความคุ้นเคยกับ Protected Audience API และ บริการ

1. เริ่มต้นด้วยการอ่านข้อเสนอการออกแบบเพื่อทำความคุ้นเคยกับ Protected Audience API และความสามารถของ API
2. อ่านคู่มือนักพัฒนาซอฟต์แวร์เพื่อดูวิธีรวมโค้ดและการเรียก API ที่คุณต้องการสำหรับกรณีการใช้งานของคุณ รวมถึงบริการที่จำเป็นในการผสานรวมกับ Protected Audience
3. ส่งความคิดเห็นเกี่ยวกับการออกแบบและการติดตั้งใช้งาน Protected Audience API, บริการ และเอกสารประกอบ
4. ลงชื่อสมัครรับข้อมูลอัปเดตเพื่อติดตามฟีเจอร์ล่าสุดของ Privacy Sandbox

ตั้งค่าและทดสอบแอปตัวอย่าง

เมื่อคุ้นเคยกับพื้นฐานของ Protected Audience ตามที่ระบุไว้ก่อนหน้านี้แล้ว คุณควรตั้งค่าและทดสอบแอปตัวอย่าง

1. เมื่อพร้อมที่จะเริ่มผสานรวมแล้ว ให้ตั้งค่าสภาพแวดล้อมการพัฒนาด้วย Privacy Sandbox Developer Preview เวอร์ชันล่าสุด
2. ตั้งค่าปลายทางเซิร์ฟเวอร์ที่จำเป็น ใช้การจำลองตัวอย่างกับ โซลูชันการทดสอบ API ที่คุณต้องการเพื่อเริ่มต้นกระบวนการนี้
3. Fork และเรียกใช้โค้ดในแอปตัวอย่างเพื่อทำความคุ้นเคยกับ การจัดการกลุ่มเป้าหมายที่กำหนดเอง เวิร์กโฟลว์การเลือกโฆษณา และ การรายงานการแสดงผล

การมีส่วนร่วมของพาร์ทเนอร์การรวมบริการ

กำหนดเวลาการพูดคุยกับพาร์ทเนอร์การผสานรวมเพื่อหารือเกี่ยวกับการทดสอบและการ นำ Protected Audience ไปใช้ใน Android รวมถึงรูปแบบของสัญญาณที่ส่ง ระหว่างฝ่ายต่างๆ สําหรับผู้ซื้อ การอภิปรายควรรวมถึงกลยุทธ์ในการสร้างและเข้าร่วมกลุ่มเป้าหมายที่กําหนดเอง ซึ่งอาจรวมถึงการอภิปรายเกี่ยวกับวิธีระบุกลุ่มเป้าหมาย ทำงานร่วมกับพาร์ทเนอร์การผสานรวมเพื่อกำหนดไทม์ไลน์สำหรับการผสานรวม ตั้งแต่การทดสอบครั้งแรกไปจนถึงการนำไปใช้ และระบุส่วนที่แต่ละฝ่าย รับผิดชอบในการออกแบบ

การตั้งค่าเวอร์ชันเบต้า (พร้อมให้บริการในไตรมาสที่ 4)

ลงทะเบียนองค์กรของคุณกับ Privacy Sandbox ใน Android การลงทะเบียน เป็นสิ่งจำเป็นเพื่อให้แน่ใจว่านักพัฒนาเทคโนโลยีโฆษณาจะดำเนินการภายในนโยบายของ Privacy Sandbox และช่วยให้นักพัฒนาเทคโนโลยีโฆษณากำหนดตัวตนของตนใน SDK และโดเมนต่างๆ ได้

ข้อควรพิจารณาด้านสถาปัตยกรรม

Protected Audience ช่วยให้ทั้งผู้ซื้อและผู้ขายสามารถ ประมูลโฆษณาในอุปกรณ์ได้ คุณและพาร์ทเนอร์การผสานรวมควรพิจารณาข้อควรพิจารณาที่สำคัญหลายประการในการออกแบบ ดังนี้

ระบบจะจัดเก็บกลุ่มเป้าหมายและโฆษณารีมาร์เก็ตติ้งไว้ในอุปกรณ์

ข้อมูลกลุ่มเป้าหมายและโฆษณารีมาร์เก็ตติ้งจะจัดเก็บไว้ในอุปกรณ์ ซึ่งแตกต่างจากการจัดเก็บโฆษณาไว้ในเซิร์ฟเวอร์ทั้งหมดในปัจจุบัน โฆษณาตามบริบทที่ไม่ต้องอาศัย ข้อมูลในอุปกรณ์เพื่อการกำหนดเป้าหมายจะยังคงอยู่ในเซิร์ฟเวอร์ แพลตฟอร์มเทคโนโลยีโฆษณา ต้องขยายเพื่อพิจารณาความต้องการโฆษณาที่กระจายอยู่ระหว่างเซิร์ฟเวอร์ และอุปกรณ์

กระบวนการเสนอราคาและการประมูลจะเกิดขึ้นในอุปกรณ์

นอกจากจะจัดการประมูลในเซิร์ฟเวอร์แล้ว แพลตฟอร์มเทคโนโลยีโฆษณายังมีโอกาสในการกำหนดราคาและจัดอันดับดีมานด์โฆษณาที่จัดเก็บไว้ในอุปกรณ์ด้วย

แนวทางที่ใช้กันโดยทั่วไปคือเทคโนโลยีโฆษณาจะจัดการประมูลโฆษณาตามบริบทเช่นเดียวกับที่ทำในปัจจุบัน หลังจากเสร็จสิ้นการประมูลแล้ว ผู้ขายสามารถเลือกที่จะทำการประมูลในอุปกรณ์เพื่อประเมินดีมานด์รีมาร์เก็ตติ้งที่จัดเก็บไว้ในอุปกรณ์ เนื่องจากกระบวนการเหล่านี้ทำงานบนอุปกรณ์แล้ว จึงควรทราบขีดจำกัดที่มีอยู่เพื่อยืนยันว่าการประมูลทำงานตั้งแต่ต้นจนจบตามที่พาร์ทเนอร์การผสานรวมต่างๆ ออกแบบไว้ใน Use Case การรีมาร์เก็ตติ้งที่หลากหลาย

กลยุทธ์ข้อมูล

แพลตฟอร์มเทคโนโลยีโฆษณาควรพิจารณาประเภทข้อมูลที่ใช้ในการประมูล ปัจจุบัน ระบบจะรวบรวมข้อมูลนี้จากแหล่งที่มาต่างๆ แล้วจัดเก็บไว้ในเซิร์ฟเวอร์ส่วนกลาง การประมูลที่ใช้ Protected Audience API มีเส้นทางที่แตกต่างกันหลายเส้นทางในการส่งข้อมูลดังกล่าว ตัวอย่างเช่น สัญญาณแบบเรียลไทม์ เช่น งบประมาณที่เหลือ มาจาก บริการคู่คีย์-ค่าในรูปแบบสัญญาณที่เชื่อถือได้ ในขณะที่สัญญาณบริบท เช่น ช่วงเวลาของวัน จะส่งจากผู้ขายเมื่อเรียกใช้การประมูล เราจะอธิบายสัญญาณเหล่านี้ อย่างละเอียดในส่วนที่เกี่ยวข้องของคู่มือนี้

สร้างโซลูชัน

การจัดการประมูลด้วย Protected Audience API มีขั้นตอนสำคัญหลายขั้นตอน ผู้ซื้อ ต้องสร้างกลุ่มเป้าหมาย ระบุข้อมูลการเสนอราคา จัดเป้าหมายโฆษณาไปยังกลุ่มเป้าหมาย และตั้งค่า การเสนอราคา ผู้ขายต้องกำหนดค่าและทริกเกอร์การประมูล ให้คะแนน โฆษณาที่เข้าเกณฑ์ และเลือกผู้ชนะ บางขั้นตอนเหล่านี้ต้องมีการทำงานร่วมกัน ระหว่างทั้ง 2 ฝ่ายเพื่อให้มั่นใจว่าการประมูลจะดำเนินการได้อย่างถูกต้อง ส่วนต่อไปนี้จะอธิบายแต่ละขั้นตอนโดยละเอียดและระบุอย่างชัดเจนว่าฝ่ายใดมีหน้าที่รับผิดชอบในการติดตั้งใช้งาน

ผู้ซื้อ: การสร้างฐานผู้ชม

โดยปกติแล้ว ผู้ซื้อจะจัดการกลุ่มเป้าหมายที่กำหนดเอง เนื่องจากมีการจัดการกลุ่มเป้าหมายที่กำหนดเองในอุปกรณ์ API สำหรับจัดการกลุ่มเป้าหมายที่กำหนดเองจึงได้รับการออกแบบมาให้เรียกใช้ในอุปกรณ์

หากมี SDK ของคุณเองในแอปของผู้ลงโฆษณา คุณสามารถใช้โค้ดนี้ได้โดยตรงโดยใช้ joinCustomAudience()

หากไม่มีโค้ด SDK ของคุณเองในอุปกรณ์ คุณอาจพิจารณาเป็นพาร์ทเนอร์กับ พาร์ทเนอร์การผสานรวมที่มีอยู่ซึ่งเป็นผู้ให้บริการ SDK ด้วย ระบุและทำงานร่วมกับพาร์ทเนอร์รายนี้เพื่อกำหนดสัญญาและขั้นตอนการกำหนดและการจัดการกลุ่มเป้าหมายที่กำหนดเอง คู่มือนี้ใช้คำว่า "ผู้ซื้อ" ไม่ว่าจะใช้วิธีใดก็ตาม ตัวอย่างแนวทางบางส่วน ได้แก่

• ในฐานะผู้ซื้อ ให้ผู้ลงโฆษณากำหนดกลุ่มเป้าหมาย SDK ของพาร์ทเนอร์การผสานรวม ในอุปกรณ์จะส่งเหตุการณ์ของแอปไปยังผู้ซื้อได้ เมื่อตรงตามเกณฑ์ที่กำหนดไว้ล่วงหน้า ผู้ซื้อจะส่งข้อความไปยัง SDK เพื่อเข้าร่วมกลุ่มเป้าหมายที่กำหนดเองใน ไคลเอ็นต์ในนามของผู้ซื้อ
• SDK สามารถเป็นเจ้าของกลุ่มเป้าหมายได้โดยตรง ผู้ลงโฆษณาทํางานร่วมกับผู้ให้บริการ SDK เพื่อกําหนดกลุ่มเป้าหมาย SDK จะตรวจสอบเหตุการณ์ในแอปและเข้าร่วมกลุ่มเป้าหมาย ในเวลาที่เหมาะสม และแจ้งให้ผู้ซื้อทราบว่าระบบได้เพิ่มผู้ใช้ ลงในกลุ่มเป้าหมายแล้ว

แคมเปญรีมาร์เก็ตติ้งต้นแบบ: ออกแบบกลุ่มเป้าหมายที่กำหนดเอง

กลุ่มเป้าหมายที่กำหนดเองคือการจัดกลุ่มผู้ใช้ที่มีความสนใจคล้ายกันซึ่งสามารถ แสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ ผู้ซื้อช่วยผู้ลงโฆษณาสร้างกลุ่มเป้าหมายที่กําหนดเองในแอปโดยอิงตามกิจกรรมของผู้ใช้ได้

Protected Audience สร้างคอนเทนเนอร์สำหรับกลุ่มเป้าหมายที่กำหนดเองซึ่งแมปกับ การมีส่วนร่วมของผู้ใช้ที่กำหนดเองที่เฉพาะเจาะจงตามที่ผู้ลงโฆษณากำหนด ซึ่งรวมถึง ชุดโฆษณาที่เป็นไปได้ซึ่งแสดงต่อกลุ่มเป้าหมายนั้นได้ และ ชุดตรรกะและข้อมูลการเสนอราคาที่กำหนดเองซึ่งใช้ในระหว่างการประมูล เพื่อกรองและกำหนดราคาโฆษณาได้

การตั้งค่าและต้นแบบ

• ใช้ Custom Audience API เพื่อสร้างและจัดเก็บกลุ่มเป้าหมายใน อุปกรณ์ซึ่งจะใช้ในการประมูลได้ในภายหลัง
• ดูรายละเอียดการใช้งานและ API ได้ที่คู่มือนักพัฒนาซอฟต์แวร์

ข้อควรพิจารณาในการออกแบบ

ผู้ซื้อรองรับกรณีการใช้งานที่หลากหลายได้โดยการกำหนดค่ากลุ่มเป้าหมายที่กำหนดเอง ซึ่งรวมถึงการกำหนดตรรกะการเสนอราคาสำหรับประเภทโฆษณาหรือแคมเปญที่ใช้กำหนดเป้าหมายกลุ่มเป้าหมายนี้ การกำหนดรายการโฆษณาที่อาจแสดง และข้อควรพิจารณาที่คล้ายกัน ส่วนนี้ประกอบด้วยข้อควรพิจารณาในการออกแบบสำหรับการป้อนข้อมูลและการใช้ฟิลด์คีย์บางรายการในกลุ่มเป้าหมายที่กำหนดเอง

URL ตรรกะการเสนอราคา

เนื่องจากระบบจะดำเนินการประมูลในอุปกรณ์ ผู้ซื้อจึงต้องติดตั้งใช้งานปลายทางที่ สามารถแสดงตรรกะการเสนอราคาเป็น JavaScript ได้ คู่มือนักพัฒนาซอฟต์แวร์ของเราอธิบาย ลายเซ็นของเมธอดที่จำเป็น ตรรกะการเสนอราคาจะเข้าถึงสัญญาณบางอย่างเกี่ยวกับ ผู้ใช้ในระหว่างการประมูลตามที่อธิบายไว้ใน 2-3 ส่วนถัดไป เราจะอธิบายตรรกะการเสนอราคา และการตั้งค่าสัญญาณของผู้ใช้ในส่วนท้ายของบทความนี้

สัญญาณการเสนอราคาของผู้ใช้

ผู้ซื้อสามารถใช้ UserBiddingSignals เพื่อส่งต่อความรู้ที่ผู้ลงโฆษณาหรือผู้ซื้อเองมีเกี่ยวกับผู้ใช้ไปยังการประมูลในอนาคตบนอุปกรณ์ ซึ่งอาจรวมถึงข้อมูลต่อไปนี้

• กลุ่มเป้าหมายอื่นๆ ที่เพิ่มผู้ใช้
• ข้อมูลเชิงลึกจากบุคคลที่หนึ่งที่ผู้ลงโฆษณามีเกี่ยวกับผู้ใช้

เนื่องจากสัญญาณเหล่านี้พร้อมใช้งานในระหว่างการประมูล ผู้ซื้อจึงสามารถดำเนินการเสนอราคาที่กำหนดเองในระหว่างการประมูลได้ ซึ่งรวมถึง

• เสนอราคาสูงขึ้นหรือต่ำลงตามสัญญาณในการเสนอราคา
• กรองโฆษณาที่เฉพาะเจาะจงออกจากการประมูล

ข้อมูลการเสนอราคาที่เชื่อถือได้

ในส่วนของการติดตั้งใช้งาน Protected Audience ผู้ซื้อจะเข้าถึงข้อมูลแบบเรียลไทม์ ในระหว่างการประมูลจากบริการคู่คีย์-ค่าได้ ผู้ซื้อและผู้ขายสามารถดึงสัญญาณการเสนอราคาเหล่านี้จากบริการใดก็ได้ รวมถึงบริการที่ดำเนินการด้วยตนเอง ซึ่งเป็นกลไกชั่วคราว ตัวอย่างที่พบบ่อยที่สุดคือการ ค้นหางบประมาณที่เหลือสำหรับโฆษณา ในระหว่างการพัฒนา คุณสามารถจำลอง บริการนี้ และพัฒนาโดยใช้ปลายทางจำลองนี้ได้ ดูวิธีการตั้งค่าได้ในไดเรกทอรี FledgeServerSpec ในที่เก็บแอปตัวอย่างของเราบน GitHub

ฟิลด์ TrustedBiddingData ประกอบด้วย URL และชุดคีย์ ข้อควรพิจารณาในการออกแบบโครงสร้างคีย์ที่จะใช้มีดังนี้

• วิธีหนึ่งคือการใส่คีย์ที่แมปแบบ 1:1 กับกลุ่มเป้าหมายที่สร้างขึ้น จากนั้นบริการคีย์-ค่าจะมีข้อมูลที่เกี่ยวข้องทั้งหมด ซึ่งเชื่อมโยงกับกลุ่มเป้าหมาย
• งบประมาณและสถานะโฆษณาเป็นสิ่งสำคัญที่ควรพิจารณาแบบเรียลไทม์
• จํานวนราคาเสนอสูงสุดหรือสัญญาณอื่นๆ ที่ใช้กําหนดราคาโฆษณาในการประมูลได้ คุณสามารถรวมข้อมูลนี้ไว้กับโฆษณาในAdData รายการได้ แต่การจัดเก็บข้อมูลนี้ไว้ในบริการคู่คีย์-ค่าจะช่วยให้สามารถอัปเดตได้ตามต้องการ

รายการ AdData

เมื่อสร้างแคมเปญรีมาร์เก็ตติ้ง ผู้ลงโฆษณามักจะพิจารณาโฆษณาหลายประเภทเพื่อแสดงต่อผู้ใช้ในกลุ่มเป้าหมาย เช่น การโฆษณาส่วนลดต่างๆ ตามการมีส่วนร่วมก่อนหน้านี้ของผู้ใช้กับแอป กลุ่มเป้าหมายที่กำหนดเองจะมีรายการ AdData ที่มีโฆษณาที่อาจแสดง

ผู้ซื้อจะเป็นผู้กำหนดปริมาณข้อมูลที่จะรวมไว้ในโฆษณาแต่ละรายการ สิ่งที่ควรพิจารณามีดังนี้

• คุณอัปเดตรายการ AdData ได้ 2 วิธี ดังนี้
  • เมื่อแอปมีกิจกรรมที่มองเห็นได้ในเบื้องหน้า แอปจะเริ่ม รายการได้เมื่อเชื่อมโยงผู้ใช้กับกลุ่มเป้าหมายที่กำหนดเอง
  • ในระหว่างการอัปเดตรายวัน ระบบจะเริ่มการดึงข้อมูลในเบื้องหลัง อุปกรณ์จะส่งคำขอไปยัง daily_update_url ที่รวมอยู่ใน การเรียก joinCustomAudience และคาดหวังการตอบกลับซึ่งรวมถึงรายการ AdData ที่อัปเดตแล้ว
• คุณขอข้อมูลเพิ่มเติมเกี่ยวกับโฆษณาได้ในเวลาที่ ประมูล ก่อนการประมูล อุปกรณ์จะส่งคำขอไปยังบริการคีย์-ค่าของผู้ซื้อที่ระบุไว้ในฟิลด์ trustedBiddingData ของ joinCustomAudience บริการคู่คีย์-ค่าเป็นบริการใหม่ที่เป็นส่วนหนึ่ง ของการติดตั้งใช้งาน Protected Audience ของผู้ซื้อ อธิบายรายละเอียดเพิ่มเติมเกี่ยวกับบริการนี้ในภายหลังในเอกสารนี้
• การใส่รหัสครีเอทีฟโฆษณาสำหรับโฆษณาจะช่วยให้คุณดำเนินการบางอย่าง กับครีเอทีฟโฆษณาที่เฉพาะเจาะจงได้ ตัวอย่างเช่น ผู้ลงโฆษณาอาจหยุดครีเอทีฟโฆษณาที่เฉพาะเจาะจงชั่วคราว และคุณต้องการดึงรหัสครีเอทีฟโฆษณาดังกล่าวจากบริการคีย์-ค่าแบบเรียลไทม์ แล้วจับคู่กับโฆษณาในAdDataรายการ

AdData ควรมี render_url ระบบจะใช้ URL การแสดงผลของโฆษณารีมาร์เก็ตติ้งที่ชนะเพื่อแสดงผลโฆษณา สิ่งที่ควรพิจารณาบางส่วนมีดังนี้

• URL การแสดงผลมีเกณฑ์ k-anonymity ดังนั้นจึงควรหลีกเลี่ยงการรวมพารามิเตอร์ที่แคบ ข้อมูลเพิ่มเติมเกี่ยวกับเกณฑ์ k-anonymity นี้จะ เผยแพร่ในภายหลัง
• URL นี้ควรมีข้อมูลทั้งหมดที่จำเป็นต่อการแสดงโฆษณา เช่น หากต้องการแสดงผลิตภัณฑ์ที่เฉพาะเจาะจง ให้ฝังรหัสผลิตภัณฑ์เป็นพารามิเตอร์ใน URL

ขณะสร้างต้นแบบ ช่องที่ต้องระบุมีเพียง renderUri ซึ่งชี้ไปยัง ชิ้นงานการแสดงโฆษณา คุณสามารถละเว้นฟิลด์ข้อมูลเมตาใน AdData ได้ ขณะสร้างโซลูชัน เมื่อย้ายโซลูชันไปสู่การใช้งานจริง คุณควรพิจารณาว่าข้อมูลเมตาใดที่เกี่ยวข้องกับคุณ เนื่องจากสามารถใช้ในระหว่าง การสร้างราคาเสนอเพื่อปรับราคาเสนอได้

เวลาการเปิดใช้งานและเวลาหมดอายุ

คุณสามารถใช้ช่องเวลาเปิดใช้งานและเวลาหมดอายุเพื่อรองรับกรณีการใช้งานที่กลุ่มเป้าหมายที่กําหนดเองควรมีสิทธิ์เข้าร่วมการประมูลภายในเวลาที่กําหนดไว้ล่วงหน้าเท่านั้น โปรดทราบว่ามีข้อจำกัดบางอย่างเกี่ยวกับระยะเวลาที่สามารถเลื่อนเวลา การเปิดใช้งานและส่วนต่างระหว่างเวลาเปิดใช้งานกับเวลาหมดอายุ ตัวอย่าง กรณีการใช้งานมีดังนี้

• ผู้ใช้ที่หยุดใช้งาน (เช่น ผู้ใช้ที่ไม่ได้มีส่วนร่วมกับแอปของผู้ลงโฆษณาใน ช่วง 7 วันที่ผ่านมา)
  • ทุกครั้งที่ผู้ใช้เปิดแอป ผู้ซื้อจะโทรหา joinCustomAudience และกำหนดค่า activation_time ให้เป็นไทม์สแตมป์ เป็นเวลา 7 วันในอนาคตได้
  • กลุ่มเป้าหมายจะมีสิทธิ์เสนอราคาหากผ่านไปแล้ว 7 วันนับตั้งแต่ผู้ใช้เปิดแอปครั้งล่าสุด
• กลุ่มเป้าหมายตามฤดูกาล (กลุ่มเป้าหมายที่ใช้ได้ในช่วงระยะเวลาที่เฉพาะเจาะจงในอนาคตอันใกล้นี้เท่านั้น)
  • ผู้ซื้อสามารถเริ่มกำหนดกลุ่มเป้าหมายที่กำหนดเองล่วงหน้าซึ่งควรมีสิทธิ์เสนอราคาในช่วงเวลาที่กำหนดไว้ล่วงหน้าในอนาคต (อันใกล้)
  • ตัวอย่างเช่น หากผู้ลงโฆษณามีแคมเปญช่วงสิ้นสุดฤดูร้อนในสหรัฐอเมริกาในปี 2022 ผู้ซื้อสามารถเรียกใช้ joinCustomAudience และกำหนดค่า activation_time เป็นวันเสาร์ที่ 20 สิงหาคม 2022 หากแคมเปญทํางานเพียง 1 สัปดาห์ ผู้ซื้อสามารถตั้งค่าวันที่หมดอายุเป็นวันที่ 27 สิงหาคม 2022 หลังจากนั้นแพลตฟอร์มจะกรองกลุ่มเป้าหมายที่กําหนดเองออกในระหว่างการเลือกโฆษณาและในที่สุดก็จะถูกลบออก

ผู้ซื้อและผู้ขาย: การเลือกโฆษณา

การเลือกโฆษณาต้องอาศัยการทำงานร่วมกันระหว่างผู้ซื้อและผู้ขาย ซึ่งอาจมองได้ว่าเป็นกระบวนการ 4 ขั้นตอนดังนี้

1. ผู้ขายกำหนดกลยุทธ์สื่อกลาง
2. ผู้ขายกำหนดค่าการประมูลและเริ่มการเลือกโฆษณา
3. ผู้ซื้อจะได้รับเชิญให้เข้าร่วมการประมูลโดยใช้การกำหนดค่าที่ผู้ขายกำหนด ระบบจะเรียกใช้ตรรกะการเสนอราคาของผู้ซื้อเพื่อเลือกโฆษณาและราคาเสนอที่เป็นไปได้
4. ระบบจะเรียกใช้ตรรกะการตัดสินใจของผู้ขายเพื่อให้คะแนนผู้สมัครและเลือกโฆษณาที่ชนะ

เพื่อความสะดวกในการพัฒนา คุณสามารถจำลองการตอบกลับของบริการสำหรับผู้ซื้อและผู้ขาย ซึ่งรวมถึงตรรกะการเสนอราคาและการให้คะแนน เพื่อให้คุณมุ่งเน้นไปที่การพัฒนาสิ่งที่เกี่ยวข้องกับกรณีการใช้งานของคุณ ดูวิธีการตั้งค่าปลายทางจำลองได้ในไดเรกทอรี FledgeServerSpec ใน GitHub หรือดูวิธีการ ลบล้างความจำเป็นในการดึงข้อมูล JavaScript จากระยะไกลได้ในคู่มือนักพัฒนาแอป

ผู้ขาย: กำหนดกลยุทธ์สื่อกลาง

Protected Audience มีเป้าหมายที่จะรองรับการแสดงโฆษณาสื่อกลางตามลำดับขั้น (Waterfall Mediation) ส่วนนี้อยู่ระหว่าง การพัฒนา และเราจะให้ข้อมูลเพิ่มเติมเมื่อพร้อมใช้งาน ในตอนนี้ โปรดดูข้อเสนอการออกแบบสำหรับการแสดงโฆษณาสื่อกลางตามลำดับขั้น (Waterfall Mediation) ใน Protected Audience

ผู้ขาย: กำหนดค่าการประมูล

ผู้ขายมีหน้าที่กำหนดค่าการประมูลและให้ข้อมูลแก่ กระบวนการเลือกโฆษณา ผู้ขายเลือกได้ว่าจะให้ข้อมูลแก่ทุกฝ่ายหรือเฉพาะบางฝ่ายเท่านั้น ซึ่งอาจรวมถึงข้อมูลที่คุณมีหรือข้อมูลที่คุณระบุในนามของผู้ซื้อ

การตั้งค่าและต้นแบบ

• ผู้ขายสามารถกำหนดค่าและเริ่มการประมูลได้โดยการตั้งค่าออบเจ็กต์ AdSelectionConfig และใช้ AdSelection API เรียกใช้การประมูลโดยการเรียกใช้ selectAds()
• ดูรายละเอียดการใช้งานและ API ได้ที่คู่มือนักพัฒนาซอฟต์แวร์

ข้อควรพิจารณาในการออกแบบ

ส่วนนี้ประกอบด้วยข้อควรพิจารณาในการออกแบบสำหรับการป้อนและใช้ฟิลด์คีย์ ในการกำหนดค่าการเลือกโฆษณา

• สภาพแวดล้อมการดำเนินการแบบส่วนตัวจะมีเฉพาะโฆษณาสำหรับกลุ่มเป้าหมายที่กำหนดเองในอุปกรณ์ ดังนั้นการออกคำขอโฆษณาตามบริบทก่อนจะช่วยให้คุณพิจารณาดีมานด์เพิ่มเติมได้

• ก่อนเริ่มเวิร์กโฟลว์การเลือกโฆษณา ให้เรียกใช้คำขอโฆษณาเพื่อรวบรวมข้อมูลจากผู้ซื้อ จากนั้นใช้ข้อมูลนี้เพื่อกำหนดค่าการเลือกโฆษณา

• เนื่องจากผู้ซื้อจำนวนมากอาจสร้างกลุ่มเป้าหมายที่กำหนดเองในอุปกรณ์ ผู้ขายจึงต้องใช้ช่องผู้ซื้อกลุ่มเป้าหมายที่กำหนดเองเพื่อระบุผู้ซื้อที่เฉพาะเจาะจงที่จะรวมไว้ในกระบวนการ คุณสร้างรายการนี้ได้หลายวิธี ตัวอย่างเช่น

  • รายชื่อผู้ซื้อแบบคงที่ที่ผู้ขายต้องการรวมไว้ใน กระบวนการเสมอ
  • รายชื่อผู้ซื้อที่ระบุว่าต้องการเข้าร่วมในการตอบโฆษณา ตัวเลือกนี้มีประโยชน์ในกรณีที่ผู้ขายทำงานร่วมกับ Ad Exchange และอาจ ไม่ทราบข้อมูลทั้งหมดของผู้ซื้อ

• ผู้ขายส่งข้อมูลไปยังกระบวนการได้หลายวิธี ดังนี้

  • ฟิลด์สัญญาณการเลือกโฆษณาพร้อมใช้งานสำหรับผู้ซื้อและผู้ขายทั้งหมด ที่เข้าร่วมการประมูลในรันไทม์ส่วนตัว ใช้เพื่อ ระบุข้อมูลเกี่ยวกับโอกาสในการแสดงโฆษณา เช่น ขนาดโฆษณาและรูปแบบ โฆษณา
  • ระบบจะส่งต่อฟิลด์สัญญาณต่อผู้ซื้อไปยังผู้ซื้อที่เฉพาะเจาะจงเพื่อใช้ในกระบวนการเสนอราคา ข้อมูลนี้มาจากผู้ซื้อ และคุณในฐานะผู้ขายต้องพิจารณาว่าจะรับข้อมูลนี้ในอุปกรณ์เพื่อใช้ในระหว่างการเลือกโฆษณาได้อย่างไร
  • ฟิลด์สัญญาณผู้ขายเป็นวิธีสุดท้ายที่ผู้ขายจะส่ง ข้อมูลไปยังกระบวนการได้ ในฐานะผู้ขาย คุณจะใช้สัญญาณเหล่านี้เมื่อ ให้คะแนนโฆษณาและกรองโฆษณา เช่น การเปิดใช้การตรวจสอบความปลอดภัยของแบรนด์

ผู้ซื้อ: การเสนอราคาสำหรับช่องโฆษณา

การตั้งค่าและต้นแบบ

• ผู้ซื้อสามารถเพิ่มตรรกะการเสนอราคาลงในฟังก์ชัน generateBid() JavaScript ที่แสดงจากชุดพารามิเตอร์ biddingLogicUrl เมื่อสร้าง CustomAudience คุณสามารถตั้งค่าบริการจำลองโดยใช้ข้อมูลจำเพาะที่ระบุ หรือจะใช้ปลายทางนี้ในเซิร์ฟเวอร์จริงก็ได้
• ดูรายละเอียดการใช้งานและ API ได้ที่คู่มือนักพัฒนาซอฟต์แวร์

ข้อควรพิจารณาในการออกแบบ

• ตรรกะการเสนอราคาจะดำเนินการในอุปกรณ์ และมีการค้นหาสัญญาณบางอย่างที่ใช้ในการประมูล แบบเรียลไทม์ โปรดดูรายการข้อจำกัดสำหรับข้อจำกัด
• สำหรับกรณีการใช้งานโฆษณาบางกรณี คุณควรทำงานร่วมกับผู้ขายเพื่อยืนยันว่าคุณมีโฆษณาหลายรายการและราคาเสนอของโฆษณาเหล่านั้นที่จะพิจารณาในอุปกรณ์

ออกแบบตรรกะการเสนอราคา

ต้องใช้ JavaScript เพื่อติดตั้งตรรกะการเสนอราคาของผู้ซื้อและดำเนินการในอุปกรณ์ คู่มือนักพัฒนาซอฟต์แวร์มีข้อมูลเกี่ยวกับลายเซ็นที่จำเป็น และรายละเอียดเกี่ยวกับพารามิเตอร์ต่างๆ ที่ส่งผ่านระหว่างการประมูล ตรรกะการเสนอราคาในอุปกรณ์มีสิทธิ์เข้าถึงข้อมูลเพิ่มเติมที่ส่งเป็น พารามิเตอร์ไปยังฟังก์ชัน generateBid()

ข้อมูลการเสนอราคาฝั่งซัพพลาย

สัญญาณการเสนอราคาแบบเรียลไทม์พร้อมบริการคีย์-ค่า

ในฐานะผู้ซื้อ คุณสามารถดึงสัญญาณแบบเรียลไทม์ระหว่างการประมูลจากบริการคีย์-ค่า ที่คุณเป็นเจ้าของ คุณดูการติดตั้งใช้งานบริการนี้ครั้งแรกได้ใน ที่เก็บ Privacy Sandbox แบบสาธารณะ หรือจะสร้างบริการ ของคุณเองก็ได้ URL ของบริการนี้จะระบุเป็น trustedBiddingUrl ใน กลุ่มเป้าหมายที่กำหนดเอง และแพลตฟอร์มจะพยายามดึงข้อมูลและทำให้ข้อมูล พร้อมใช้งานในฟังก์ชัน generateBid ของคุณด้วย trusted_bidding_signals parameter คุณต้องสร้างโครงสร้างคีย์ของคุณเอง

สัญญาณบริบทและสัญญาณของผู้ใช้

generateBid ฟังก์ชันของคุณมีสิทธิ์เข้าถึงสัญญาณของผู้ใช้เพิ่มเติมเมื่อเรียกใช้ การประมูลในอุปกรณ์ ระบบจะส่งสัญญาณเหล่านี้พร้อมกับฟิลด์ contextual_signals และ per_buyer_signals ฟิลด์เหล่านี้เป็นออบเจ็กต์ JSON ทั้งหมดซึ่งผู้ซื้อและผู้ขายต้องกำหนดรูปแบบ

ฟิลด์ contextual_signals มีข้อมูลที่อาจเกี่ยวข้องกับผู้ใช้ ออบเจ็กต์ที่เก็บสัญญาณเหล่านี้สร้างขึ้นโดย Protected Audience เองและส่งผ่านไปยังตรรกะการเสนอราคา โดยจะส่งเป็น ออบเจ็กต์ว่าง หากเชื่อว่าสัญญาณตามบริบทเกี่ยวกับผู้ใช้อาจ เกี่ยวข้องกับกรณีการใช้งานของคุณ โปรดส่งความคิดเห็นเพื่อให้เราพิจารณา

ฟิลด์ per_buyer_signals จะพร้อมใช้งานในตรรกะการเสนอราคา ผู้ขาย จะตั้งค่าเหล่านี้เมื่อสร้างการกำหนดค่าการประมูล ผู้ซื้อและผู้ขาย ต้องทำงานร่วมกันเพื่อยืนยันว่าข้อมูลนี้อยู่ในอุปกรณ์และส่งไปยังตรรกะการเสนอราคา ของคุณ ตัวอย่างการใช้งานฟิลด์นี้มีดังนี้

• การกรองเพื่อความปลอดภัยของแบรนด์ ผู้ขายสามารถแจ้งให้ผู้ซื้อทราบข้อมูลการจัดประเภทบางอย่างเกี่ยวกับแอปที่ขอโฆษณา และผู้ซื้อสามารถใช้ข้อมูลนี้เพื่อกรองโฆษณาบางรายการออกได้
• ส่งการฝังสำหรับโมเดล ML ที่พิจารณา ข้อมูลตามบริบท

ผู้ขาย: ให้คะแนนและเลือกโฆษณาที่ชนะ

การตั้งค่าและต้นแบบ

• ผู้ขายสามารถเพิ่มตรรกะการให้คะแนนของตนลงในฟังก์ชัน scoreAd() JavaScript ที่แสดงจากชุดพารามิเตอร์ scoringLogicUrl เมื่อสร้าง AdSelectionConfig คุณสามารถตั้งค่าบริการจำลองโดยใช้ข้อมูลจำเพาะที่ระบุ หรือจะใช้ปลายทางนี้ในเซิร์ฟเวอร์จริงก็ได้
• ดูรายละเอียดการใช้งานและ API ได้ที่คู่มือนักพัฒนาซอฟต์แวร์

ออกแบบตรรกะการให้คะแนน

ผู้ขายจะใช้ตรรกะการให้คะแนนใน JavaScript ซึ่งจะทำงานในอุปกรณ์ คู่มือนักพัฒนาซอฟต์แวร์มีข้อมูลเกี่ยวกับลายเซ็นที่จำเป็นและรายละเอียด เกี่ยวกับพารามิเตอร์ต่างๆ ที่ส่งผ่านระหว่างการประมูล นอกจากนี้ ตรรกะการให้คะแนนในอุปกรณ์ยังเข้าถึงข้อมูลเพิ่มเติมที่ส่งเป็น พารามิเตอร์ไปยังฟังก์ชัน scoreAd ได้ด้วย

ข้อมูลการให้คะแนนซัพพลาย

สัญญาณการให้คะแนนแบบเรียลไทม์ด้วยบริการคีย์-ค่า

ในฐานะผู้ขาย คุณสามารถดึงสัญญาณแบบเรียลไทม์ระหว่างการประมูลจากบริการคีย์-ค่า ที่คุณเป็นเจ้าของ คุณดูการติดตั้งใช้งานครั้งแรกของบริการนี้ได้ในที่เก็บ Privacy Sandbox สาธารณะ URL ของบริการนี้จะระบุเป็น trustedScoringUri ในการกำหนดค่าการประมูล และแพลตฟอร์มจะพยายามดึงข้อมูลและทำให้พร้อมใช้งานในฟังก์ชัน scoreAd โดยใช้พารามิเตอร์ trusted_scoring_signals คุณควรสร้าง โครงสร้างคีย์ของคุณเอง

สัญญาณบริบทและสัญญาณของผู้ใช้

ฟังก์ชัน scoreAd มีสิทธิ์เข้าถึงสัญญาณของผู้ใช้เพิ่มเติมเมื่อเรียกใช้การประมูลในอุปกรณ์ ระบบจะส่งสัญญาณเหล่านี้ไปยังฟังก์ชันการให้คะแนนโดยใช้ฟิลด์ contextual_signal ฟิลด์นี้มีออบเจ็กต์ JSON ซึ่งมีรูปแบบที่ผู้ซื้อและผู้ขายกำหนด

ฟิลด์ contextual_signal มีข้อมูลตามบริบทที่อาจเกี่ยวข้องกับผู้ใช้ ออบเจ็กต์ที่เก็บสัญญาณเหล่านี้สร้างขึ้นโดย Protected Audience เองและส่งผ่านไปยังตรรกะการให้คะแนนของคุณ โดยจะ ส่งเป็นออบเจ็กต์ว่าง หากเชื่อว่าสัญญาณเกี่ยวกับผู้ใช้อาจ เกี่ยวข้องกับกรณีการใช้งานของคุณ โปรดส่งความคิดเห็นเพื่อให้เราพิจารณา

ผู้ขาย: แสดงโฆษณา

ผู้ขายต้องแสดงโฆษณาที่ชนะ ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีแสดงโฆษณาที่ชนะได้ในข้อเสนอการออกแบบ พื้นที่นี้ ยังอยู่ระหว่างการออกแบบ

รายงานผลการแสดงผล

การตั้งค่าและต้นแบบ

• ผู้ซื้อและผู้ขายสามารถเพิ่มตรรกะการรายงานลงในฟังก์ชัน reportWin() JavaScript ที่แสดงจากพารามิเตอร์ biddingLogicUrl หรือ scoringLogicUrl ตามลำดับ คุณสามารถตั้งค่าบริการจำลองโดยใช้ข้อมูลจำเพาะที่ระบุ หรือจะใช้ปลายทางนี้ในเซิร์ฟเวอร์จริงก็ได้
• ดูรายละเอียดการใช้งานและ API ได้ที่คู่มือนักพัฒนาซอฟต์แวร์

ข้อควรพิจารณาในการออกแบบ

ผู้ซื้อและผู้ขายต้องใช้ฟังก์ชัน reportWin ในโค้ด JavaScript ที่ส่งคืนจากปลายทางที่กำหนดค่าไว้ วิธีนี้ช่วยให้คุณส่งข้อมูลกลับไปยังเซิร์ฟเวอร์ได้

นอกจากนี้ Privacy Sandbox ยังมี Attribution Reporting API สำหรับการจัดการ รายงานระดับเหตุการณ์และรายงานรวม อ่านรายละเอียดเพิ่มเติมได้ในคู่มือการผสานรวม

แนะนำสำหรับคุณ

• หมายเหตุ: ข้อความลิงก์จะแสดงเมื่อ JavaScript ปิดอยู่
• คู่มือนักพัฒนา Protected Audience API ใน Android
• รองรับการกำหนดกลุ่มเป้าหมายแบบกำหนดเองด้วย Protected Audience API
• การกำหนดความถี่สูงสุดของ Protected Audience