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

แสดงความคิดเห็น

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

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

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

Protected Audience ช่วยให้คุณทำสิ่งต่อไปนี้ได้

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

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

ไทม์ไลน์

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

ภาพรวม

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

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

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

1. API กลุ่มเป้าหมายที่กำหนดเอง: โค้ดนี้อยู่ตรงกลาง "กลุ่มเป้าหมายที่กำหนดเอง" Abstraction ซึ่งแสดงถึงสิ่งที่ผู้ลงโฆษณากำหนดว่า ที่มีความตั้งใจเดียวกัน ระบบจะจัดเก็บข้อมูลกลุ่มเป้าหมายไว้ในอุปกรณ์และ สามารถเชื่อมโยงกับโฆษณาผู้สมัครที่เกี่ยวข้อง สำหรับผู้ชมได้อย่างไร ข้อมูลเมตา เช่น สัญญาณการเสนอราคา สามารถใช้ข้อมูลนี้เพื่อแจ้ง การเสนอราคาของผู้ลงโฆษณา การกรองโฆษณา และการแสดงโฆษณา
2. 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) โปรแกรมป้องกัน 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 ที่ผู้ซื้อเป็นเจ้าของตอบกลับด้วย JSON ของ CustomAudience ในเนื้อหาการตอบสนอง ช่องผู้ซื้อและเจ้าของของกลุ่มเป้าหมายที่กำหนดเองคือ ถูกละเว้น (และถูกป้อนอัตโนมัติโดย 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 หากผู้ใช้เลือกใช้ Protected Audience API ทำงานไม่ได้โดยไม่มีสัญญาณเตือนจาก Privacy Sandbox

การออกแบบของความสามารถนี้ยังอยู่ระหว่างการพัฒนา และรายละเอียดจะ ซึ่งจะรวมไว้ในการอัปเดตในภายหลัง

การอัปเดตตามกำหนดการ

โซลูชันที่อธิบายก่อนหน้านี้กําหนดให้ 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 ในนามของตน และอนุญาตให้เฉพาะ fetchAndJoinCustomAudience API เปิดใช้กลุ่มเป้าหมายที่กำหนดเองทั้งหมดของการเรียกเท่านั้น คุณอัปเดตการควบคุมได้ระหว่างการลงทะเบียน 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 ที่กำหนดค่าได้และเรียกใช้ในอุปกรณ์ ได้รับทรัพยากรแล้ว โค้ดการประมูลต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้บนอุปกรณ์เคลื่อนที่ หลักเกณฑ์:

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

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

ภาษาโปรแกรม

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

การรายงานฝั่งซื้อ

แพลตฟอร์มนี้จะเรียกใช้ฟังก์ชัน JavaScript reportWin() ในความต้องการ โค้ดที่ได้จากด้านข้างซึ่งดาวน์โหลดจากข้อมูลเมตา 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

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

การผสานรวมข้าม API นี้ช่วยให้เทคโนโลยีโฆษณาทําสิ่งต่อไปนี้ได้

• สร้างแมปคีย์-ค่าของ URI ที่จะใช้สำหรับทั้ง 2 ประเภท 1) การรายงานการโต้ตอบกับโฆษณาและ 2) การลงทะเบียนแหล่งที่มา
• รวมข้อมูลการประมูลจากการประมูลที่ใช้ Protected Audience API ไว้ในฝั่งแหล่งที่มา การแมปคีย์สำหรับการรายงานข้อมูลสรุปรวม (โดยใช้ Attribution Reporting API) ดูข้อเสนอการออกแบบ ARA สำหรับข้อมูลเพิ่มเติม

เมื่อผู้ใช้เห็นหรือคลิกโฆษณา

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

การเปิดใช้การลงทะเบียนแหล่งที่มา

reportEvent() จะยอมรับพารามิเตอร์ที่ไม่บังคับใหม่ InputEvent ชนะ ผู้ซื้อที่ลงทะเบียนบีคอนโฆษณาสามารถเลือกรายงาน reportEvent ที่จะได้รับ ซึ่งลงทะเบียนกับ Attribution Reporting API เป็นแหล่งที่มาที่ลงทะเบียนแล้ว คำขอ ส่วนหัว Attribution-การรายงาน-มีสิทธิ์จะได้รับการเพิ่มลงในการรายงานเหตุการณ์ทั้งหมด คำขอที่ส่งจาก reportEvent() คำตอบที่มีส่วนหัว ARA ที่เหมาะสม จะได้รับการแยกวิเคราะห์เหมือนกับการลงทะเบียนแหล่งที่มา ARA ปกติอื่นๆ ที่จะได้รับคำตอบ ดูวิธีทำสิ่งต่างๆ ได้ในคำอธิบาย Attribution Reporting API ลงทะเบียน URL แหล่งที่มา

เนื่องจาก ARA บน Android รองรับกิจกรรมการดูและการคลิก InputEvents จะใช้เพื่อแยกระหว่าง 2 ประเภทนี้ เช่นเดียวกับในซอร์ส ARA แล้ว reportEvent() API จะตีความแอปที่ยืนยันด้วยแพลตฟอร์ม 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() มีพร็อพเพอร์ตี้ปลายทางที่สามารถใช้เพื่อส่ง รายงานต่อทั้งผู้ซื้อและผู้ขาย

เซิร์ฟเวอร์ที่เชื่อถือได้ที่จัดการโดยแพลตฟอร์มเทคโนโลยีโฆษณา

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

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

ฝั่งซื้อ: เมื่อฝั่งซื้อเริ่มต้นตรรกะการเสนอราคาฝั่งซื้อ แพลตฟอร์ม จะทำการเรียก 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 และสำหรับเว็บ