คู่มือการผสานรวม Protected Audience (เดิมเรียกว่า FLEDGE) สำหรับผู้ให้บริการวัดผล

Chrome ได้เสนอให้เป็นส่วนหนึ่งของ Privacy Sandbox กลุ่มเป้าหมายที่มีการป้องกัน API - API ในเบราว์เซอร์ ที่ช่วยให้ผู้ลงโฆษณาและบริษัทเทคโนโลยีโฆษณาแสดงโฆษณาที่กำหนดเป้าหมายตามความสนใจได้ โดยไม่ต้องอาศัยคุกกี้ของบุคคลที่สาม ขณะเดียวกันก็ปกป้องผู้ใช้จาก เครื่องมือวัด Conversion

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

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

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

การลงทะเบียน

ตั้งแต่เดือนสิงหาคม 2023 เป็นต้นไป ผู้ให้บริการการวัดผลอาจต้องทำตามขั้นตอน ด้านล่างเพื่อลงทะเบียนตนเองเพื่อใช้ Fenced Frame Reporting API ใน Protected Audience API

รายละเอียดเกี่ยวกับวิธีและผู้ที่จะต้อง ลงทะเบียน

การผสานรวม

แท็กการแสดงผลของผู้ให้บริการการวัดผล

วิธีการตั้งค่า

แท็กสคริปต์ ตัวอย่าง 
<script src='https://tracking.com/a.js'>xxx</script>
 ความรับผิดชอบ: ผู้ให้บริการการวัดจะต้องอัปเดตแท็กสคริปต์เพื่อใช้ reportEvent API สำหรับการติดตามการแสดงผล (ดูคำแนะนำ ที่ด้านล่าง)
แท็กภาพ ตัวอย่าง 
<img src='https://tracking.com/'>
 ความรับผิดชอบ: ดิสเพลย์และ Video 360 เพื่ออัปเดตแท็ก img src ที่จะใช้ reportEvent API สำหรับการติดตามการแสดงผล

API reportEvent

มีการเสนอ API ให้ใช้สำหรับ สำหรับการติดตามการแสดงผลหลังการแสดงผลเท่านั้น API ประกอบด้วย 2 ส่วนคือ registerAdMacro และ reportEvent

  • ดิสเพลย์และ Video 360 เป็นเจ้าของฟังก์ชัน registerAdMacro ใน reportWin จะลงทะเบียนคู่คีย์-ค่ามาโครในเบราว์เซอร์ก่อน การแสดงผลการโทร
  • "ดิสเพลย์และ" ขึ้นอยู่กับประเภทแท็ก Video 360 หรือผู้ให้บริการวัดผลเป็นเจ้าของ การเปลี่ยนแปลงแท็ก 3PAT เพื่อใช้ reportEvent API

reportEvent รับ "destinationURL" เพียง 1 อินพุต ซึ่งชี้ ไปยังเซิร์ฟเวอร์ผู้ให้บริการวัดผล มาโครนี้สามารถประกอบด้วยมาโคร จอแสดงผลและ ความช่วยเหลือสำหรับ Video 360 Center เช่น

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

เมื่อ Chrome เริ่มการทำงานของ URL ในฟังก์ชัน คำสั่ง ping จะดูเหมือนลงทะเบียน แล้วแทนที่ด้วยค่าก่อนที่จะส่งคำขอ HTTP GET ไปยัง https://adtech.example

ขั้นตอนการอัปเดตแท็กสคริปต์

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

  1. เตรียม URL การแสดงผลของผู้ให้บริการการวัดผลเพื่อยอมรับการใช้คำสั่ง ping การแสดงผล เช่น

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. เพิ่ม reportEvent JS เมื่อตอบกลับสคริปต์จาก Protected Audience API เช่น

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. บันทึกการแสดงผลเมื่อได้รับคำสั่ง ping จาก URL การแสดงผลที่กำหนดค่าไว้ใน ขั้นตอนที่ 1

แท็กการคลิกของผู้ให้บริการการวัดผล

แท็กการคลิกของผู้ให้บริการการวัดผลที่มีอยู่จะยังคงทํางานต่อไปสําหรับการแสดงผลของ Protected Audience ดิสเพลย์และ Video 360 จะใช้ บีคอน reserved.top_navigation รายการสำหรับลงทะเบียนการคลิก และจะเชื่อมโยงทั้งหมด เครื่องมือติดตามคลิกของผู้ให้บริการการวัดผลเป็นการเปลี่ยนเส้นทาง ดูรายละเอียดเพิ่มเติมได้ที่ เอกสารประกอบของ Chrome สำหรับการรายงานโฆษณาแบบ Fenced Frame API