รองรับการกำหนดกลุ่มเป้าหมายที่กำหนดเองด้วย Protected Audience API

อัปเดตล่าสุด

• เพิ่มข้อมูลเกี่ยวกับการตั้งเวลาการอัปเดตกลุ่มเป้าหมายที่กำหนดเอง
• เพิ่มการผสานรวมการรายงานการระบุแหล่งที่มากับกลุ่มเป้าหมายที่มีการป้องกัน
• เผยแพร่ไทม์ไลน์ของฟีเจอร์ Protected Audience
• FLEDGE ได้เปลี่ยนชื่อเป็น Protected Audience API
• เพิ่มข้อเสนอสําหรับการมอบสิทธิ์กลุ่มเป้าหมายที่กําหนดเอง
• นำข้อกำหนด k-anonymity ออกสำหรับการอัปเดตรายวัน URL

Protected Audience อยู่ในเวอร์ชันเบต้าและพร้อมสำหรับการทดสอบในอุปกรณ์สาธารณะแล้ว

กลุ่มเป้าหมายที่มีการป้องกันช่วยให้คุณทําสิ่งต่อไปนี้ได้

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

หากต้องการเริ่มต้นใช้งาน โปรดอ่านคู่มือนักพัฒนาซอฟต์แวร์สำหรับ Protected Audience บัญชี เราขอขอบคุณความคิดเห็นของเราในการพัฒนา Protected Audience อย่างต่อเนื่อง

ไทม์ไลน์

เราจะเปิดตัวฟีเจอร์ใหม่ๆ ในอีกไม่กี่เดือนข้างหน้า วันที่วางจำหน่ายที่แน่นอนจะ แตกต่างกันไปตามฟีเจอร์ และตารางนี้จะได้รับการอัปเดตโดยลิงก์ไปยัง เมื่อมีให้ใช้งานได้

ภาพรวม

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

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

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

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

ในระดับสูง การผสานรวมจะทํางานดังนี้

1. SportingGoodsApp ต้องการช่วยเตือนผู้ใช้ให้ซื้อสินค้าคงคลังในรถเข็นหากยังไม่ได้ซื้อภายใน 2 วัน SportingGoodsApp ใช้ Custom Audience API เพื่อเพิ่มผู้ใช้ไปยังรายการกลุ่มเป้าหมาย "ผลิตภัณฑ์ในรถเข็น" แพลตฟอร์มจะจัดการและจัดเก็บรายการกลุ่มเป้าหมายนี้ไว้ในอุปกรณ์ ซึ่งจะจํากัดการแชร์กับบุคคลที่สาม SportingGoodsApp ร่วมมือกับแพลตฟอร์มเทคโนโลยีโฆษณาเพื่อแสดงโฆษณาต่อผู้ใช้ ในรายการกลุ่มเป้าหมาย แพลตฟอร์มเทคโนโลยีโฆษณาจะจัดการข้อมูลเมตาสำหรับรายการกลุ่มเป้าหมายและแสดงโฆษณาที่เป็นไปได้ ซึ่งจะพร้อมใช้งานในเวิร์กโฟลว์การเลือกโฆษณาเพื่อพิจารณา แพลตฟอร์มสามารถกําหนดค่าให้ดึงข้อมูลโฆษณาตามกลุ่มเป้าหมายที่อัปเดตเป็นประจําในเบื้องหลัง วิธีนี้ช่วยให้รายการโฆษณาที่อาจแสดงตามกลุ่มเป้าหมายมีความใหม่อยู่เสมอและไม่เกี่ยวข้องกับคําขอที่ส่งไปยังเซิร์ฟเวอร์โฆษณาบุคคลที่สามในระหว่างโอกาสในการโฆษณา (เช่น คําขอโฆษณาตามบริบท)

2. เมื่อผู้ใช้เล่น FrisbeeGame บนอุปกรณ์เดียวกัน ผู้ใช้อาจเห็นโฆษณา แจ้งเตือนให้ซื้อสินค้าที่เหลือใน SportingGoodsApp รถเข็นช็อปปิ้ง ซึ่งทําได้ด้วย FrisbeeGame (ด้วยโฆษณาที่ผสานรวม SDK) การเรียกใช้ API การเลือกโฆษณาเพื่อเลือกโฆษณาที่ชนะ สำหรับผู้ใช้โดยอิงจากรายการกลุ่มเป้าหมาย ที่ผู้ใช้อาจเป็นสมาชิกอยู่ (ใน ตัวอย่างเช่น "ผลิตภัณฑ์ในรถเข็น" กลุ่มเป้าหมายที่กำหนดเองที่สร้างโดย SportingGoodsApp) ตั้งค่าเวิร์กโฟลว์การเลือกโฆษณาให้พิจารณาโฆษณาที่ดึงมาจากโฆษณาได้ ของแพลตฟอร์มเทคโนโลยี เซิร์ฟเวอร์นอกเหนือจากโฆษณาในอุปกรณ์ที่เชื่อมโยงกับ รวมถึงสัญญาณอื่นๆ ในอุปกรณ์ เวิร์กโฟลว์ยังสามารถ ปรับแต่งตามแพลตฟอร์มเทคโนโลยีโฆษณาและ SDK โฆษณาด้วยการเสนอราคาที่กำหนดเอง ตรรกะในการให้คะแนนเพื่อบรรลุเป้าหมายการโฆษณาที่เหมาะสม วิธีนี้ทำให้ ข้อมูลความสนใจหรือการโต้ตอบในแอปของผู้ใช้เพื่อประกอบการเลือกโฆษณา จำกัดการแชร์ข้อมูลนี้กับบุคคลที่สาม

3. SDK ของแอปการแสดงโฆษณาหรือแพลตฟอร์มเทคโนโลยีโฆษณาจะแสดงโฆษณาที่เลือก

4. แพลตฟอร์มนี้ช่วยให้การรายงานการแสดงผลและผลลัพธ์การเลือกโฆษณาเป็นไปอย่างสะดวก ความสามารถในการรายงานนี้ช่วยเสริม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 ซึ่งช่วยให้แชร์ข้อมูลในลักษณะเดียวกันได้

• 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 ที่ได้จากเทคโนโลยีโฆษณาบนอุปกรณ์ตามลําดับต่อไปนี้

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

สําหรับการเลือกโฆษณาที่เกี่ยวข้องกับกลุ่มเป้าหมายที่กําหนดเอง แพลตฟอร์มจะดึงข้อมูลโค้ด 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

การรายงานการแสดงผลและเหตุการณ์

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

1. การรายงานฝั่งขาย
2. การรายงานฝั่งซื้อ

วิธีนี้จะช่วยให้แพลตฟอร์มฝั่งซื้อและฝั่งขายมีวิธีส่งข้อมูลที่สำคัญในอุปกรณ์ ข้อมูลกลับไปยังเซิร์ฟเวอร์เพื่อเพิ่มความสามารถต่างๆ เช่น การจัดทำงบประมาณแบบเรียลไทม์ การอัปเดตรูปแบบการเสนอราคา และเวิร์กโฟลว์การเรียกเก็บเงินที่ถูกต้อง การรายงานการแสดงผลนี้ ซึ่งเป็นส่วนเสริมของ 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 และรหัสจะพร้อมใช้งานในตรรกะการเสนอราคาของผู้ซื้อ

1. ในระหว่างการเรียกใช้ reportWin ผู้ซื้อสามารถลงทะเบียนบีคอนโฆษณาเพื่อ ถูกเรียกให้แสดงในระหว่างเวลาที่แสดงโฆษณา และสำหรับเหตุการณ์การโต้ตอบที่เฉพาะเจาะจง (registerAdBeacon()) หากต้องการเชื่อมโยงสัญญาณการประมูลสำหรับเหตุการณ์โฆษณา ให้ตั้งค่า auctionId เป็นพารามิเตอร์การค้นหาของ URL บีคอน
2. ในระหว่างที่มีการแสดงโฆษณา บีคอนที่คุณลงทะเบียนไว้ระหว่างการประมูลอาจ ทริกเกอร์หรือปรับปรุงด้วยข้อมูลระดับเหตุการณ์ ผู้ขายต้องทริกเกอร์ reportEvent() และส่งข้อมูลระดับเหตุการณ์ แพลตฟอร์มจะส่งคําขอ ping ไปยัง URL ของบีคอนโฆษณาที่ลงทะเบียนไว้ของผู้ซื้อซึ่งสัมพันธ์กับ reportEvent() ที่ทริกเกอร์
3. ผู้ซื้อจะลงทะเบียนโฆษณากับ 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 และสำหรับเว็บ