เปิดใช้การวัด Conversion

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

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

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

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

สถานการณ์ทั่วไปในการวัด Conversion

ในส่วนนี้ เราจะพิจารณาสถานการณ์ทั่วไป 2 อย่างสำหรับการวัด Conversion

สถานการณ์ที่ 1: ทั้งเทคโนโลยีโฆษณาที่แสดงและผู้ให้บริการวัดผลบุคคลที่สามต้องได้รับรายงานจาก Attribution Reporting API

ผู้ลงโฆษณาต้องการระบุแหล่งที่มาของ Conversion ในพื้นที่โฆษณาโดยใช้ผู้ให้บริการวัดผลบุคคลที่สาม และเทคโนโลยีโฆษณาที่โฮสต์ครีเอทีฟโฆษณาต้องการระบุแหล่งที่มาของ Conversion ในพื้นที่โฆษณา ซึ่งเป็นเรื่องปกติสำหรับ DSP หรือเซิร์ฟเวอร์โฆษณาของผู้ลงโฆษณา (เซิร์ฟเวอร์โฆษณาบุคคลที่สาม - 3PAS) ที่ให้มาร์กอัปสำหรับครีเอทีฟโฆษณา ดำเนินการรายงานการระบุแหล่งที่มาของตนเอง และทำงานร่วมกับผู้ลงโฆษณาที่ผสานรวมกับผู้ให้บริการวัดผลหรือผู้ให้บริการวิเคราะห์บุคคลที่สาม

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

การตั้งค่าแคมเปญทั่วไปอาจมีลักษณะดังนี้

  1. เซิร์ฟเวอร์โฆษณาของผู้ลงโฆษณา (3PAS) จัดหามาร์กอัปสำหรับครีเอทีฟโฆษณาให้กับ DSP ซึ่งรวมถึงพิกเซลการติดตามการแสดงผลและการคลิกของผู้ให้บริการวัดผลบุคคลที่สาม เซิร์ฟเวอร์โฆษณาควรตรวจสอบว่าได้รวม attributionsrc ไว้ในการมาร์กอัปครีเอทีฟโฆษณา

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

สถานการณ์ที่ 2: เฉพาะผู้ให้บริการวัดผลบุคคลที่สามเท่านั้นที่ต้องรับรายงานจาก Attribution Reporting API

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

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

ในตัวอย่างการตั้งค่าแคมเปญทั่วไปจากสถานการณ์ที่ 1 เซิร์ฟเวอร์โฆษณาของผู้เผยแพร่โฆษณา, SSP หรือผู้เผยแพร่โฆษณาเองอาจเพียงแค่ต้องยืนยันว่าแอตทริบิวต์ attributionsrc ที่ DSP ระบุนั้นปรากฏในหน้าของผู้เผยแพร่โฆษณา

รายละเอียดการติดตั้งใช้งาน

ตารางต่อไปนี้อธิบายขั้นตอนการติดตั้งใช้งาน Attribution Reporting API ในระดับสูง

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

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

สำหรับโฆษณาวิดีโอที่ใช้รูปแบบ VAST ผู้เผยแพร่โฆษณาและ SDK วิดีโอจะเพิ่มแอตทริบิวต์

ขั้นตอนที่ 2: เปิดใช้การรายงานการระบุแหล่งที่มาสำหรับต้นทางของบุคคลที่สาม ซึ่งจะใช้งานได้ทันทีหากใช้เส้นทางการเปลี่ยนเส้นทางที่มีอยู่กับการเปลี่ยนเส้นทาง 302

หากใช้การเปลี่ยนเส้นทาง 302 ไม่ได้ คุณสามารถใช้แอตทริบิวต์ attributionsrc เพื่อแสดงเซิร์ฟเวอร์เทคโนโลยีโฆษณาหลายรายการได้

โดยทั่วไป ตราบใดที่เพิ่มแอตทริบิวต์ attributionsrc ลงในครีเอทีฟโฆษณา การเปลี่ยนเส้นทางของบุคคลที่สามควรได้รับการเรียก Attribution Reporting API
ขั้นตอนที่ 3: ตั้งค่าการตอบกลับสำหรับคำขอ Attribution Reporting API นิติบุคคลใดก็ตามที่ต้องการรับรายงานจาก Attribution Reporting API DSP และผู้ให้บริการวัดผลโดยบุคคลที่สามที่ผู้ลงโฆษณาใช้

โปรดทราบว่ารายละเอียดของแต่ละขั้นตอนจะขึ้นอยู่กับวิธีแสดงและแสดงครีเอทีฟโฆษณาในหน้าของผู้เผยแพร่โฆษณา และเอนทิตีเทคโนโลยีโฆษณารายใดที่ได้รับรายงานซึ่งส่งโดย Attribution Reporting API

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

ในขั้นตอนแรก ระบบจะเปิดใช้แหล่งที่มาของการระบุแหล่งที่มา

วิธีการทำงานของแอตทริบิวต์ attributionsrc

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

สําหรับเหตุการณ์คลิกที่ใช้การเปลี่ยนเส้นทาง ควรเพิ่มแอตทริบิวต์ attributionsrc ลงในการนําทาง การเปลี่ยนเส้นทาง 302 ใดๆ หลังจากที่นำทางแล้วไม่จำเป็นต้องเพิ่มแอตทริบิวต์ attributionsrc และจะมีสิทธิ์สำหรับ ARA ตราบใดที่การนำทางครั้งแรกได้เพิ่ม attributionsrc

เมื่อ attributionsrc ว่างเปล่า ระบบจะส่งคำขอ ARA ไปยัง URL ที่กำหนดไว้ในแอตทริบิวต์ href ของแท็ก Anchor (URL การคลิกผ่าน) เมื่อกำหนดแอตทริบิวต์ attributionsrc แล้ว ระบบจะส่งคำขอ ARA ไปยัง URL ที่กำหนดไว้ในแอตทริบิวต์ attributionsrc นอกจากนี้ URL ที่คลิกผ่านยังมีสิทธิ์ลงทะเบียนแหล่งที่มาด้วย

โดยทั่วไป ให้ใช้แอตทริบิวต์ attributionsrc ที่ว่างเปล่าหากเซิร์ฟเวอร์ที่โฮสต์ URL การคลิกผ่านรับและตอบสนองต่อคำขอ Attribution Reporting API ได้ กำหนด attributionsrc URL ของคุณเองหากต้องการให้คำขอ Attribution Reporting API ไปยังเซิร์ฟเวอร์อื่น

ตัวอย่างแอตทริบิวต์ attributionsrc ที่ว่างเปล่า

การตั้งค่าที่มีอยู่ เมื่อผสานรวมกับ ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

เมื่อแอตทริบิวต์ attributionsrc ว่างเปล่า ระบบจะส่งคำขอ Attribution Reporting API ไปยัง URL ที่กำหนดโดยแอตทริบิวต์ href ของแท็ก Anchor

ตัวอย่างแอตทริบิวต์ attributionsrc ที่มีค่า

การตั้งค่าที่มีอยู่ เมื่อผสานรวมกับ ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

เมื่อ attributionsrc ไม่ว่าง ระบบจะส่งคำขอ Attribution Reporting API ไปยัง URL ที่กำหนดโดยแท็ก attributionsrc นอกจากนี้ URL ที่คลิกผ่านยังมีสิทธิ์ลงทะเบียนแหล่งที่มาด้วย

เพิ่ม attributionsrc สำหรับเหตุการณ์คลิกและการแสดงผล

  • เหตุการณ์คลิก:
    • โดยปกติแล้ว นิติบุคคลที่มีหน้าที่เพิ่ม attributionsrc คือเทคโนโลยีโฆษณาที่แสดงโฆษณา
    • แท็ก Anchor ที่มีเหตุการณ์การคลิกควรมีแอตทริบิวต์ attributionsrc เพิ่ม
    • คลิกที่ใช้ window.open ควรใช้อาร์กิวเมนต์ windowFeatures ของการเรียก window.open เพื่อระบุแหล่งที่มาของการระบุแหล่งที่มา
  • เหตุการณ์การแสดงผล:
    • โดยปกติแล้ว หน่วยงานที่มีหน้าที่เพิ่ม attributionsrc คือเทคโนโลยีโฆษณาที่แสดงและผู้ให้บริการวัดผล
    • เหตุการณ์การแสดงผลที่ทริกเกอร์จากแท็ก <img> หรือแท็ก <script> ควรมีแอตทริบิวต์ attributionsrc
    • เหตุการณ์การแสดงผลที่ใช้ Fetch API ควรมีออบเจ็กต์ attributionReporting ในอาร์กิวเมนต์ options ที่ส่งไปยังการเรียกใช้ Fetch API

ดูสรุปการแก้ไขที่จำเป็นสำหรับเหตุการณ์คลิกและการแสดงผลในตารางต่อไปนี้

กิจกรรม แท็ก การตั้งค่าที่มีอยู่ หลังจากผสานรวม ARA
คลิก HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
การแสดงผล แท็ก <img> HTML <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
แท็ก <script> HTML <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options);
const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

เปิดใช้การลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาในการประมูลที่ใช้ Protected Audience API

หากต้องการวัด Conversion ในการประมูลที่ใช้ Protected Audience API คุณสามารถใช้ registerAdBeacon/registerAdMacro และ setReportEventDataForAutomaticBeacons/reportEvent แทนการใช้ attributionsrc เพื่อเปิดใช้การลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา

สำหรับการรายงานสัญญาณ Protected Audience API ฟังก์ชัน registerAdBeacon จะพร้อมใช้งานภายใน Worklet การรายงาน และ registerAdMacro จะพร้อมใช้งานภายใน Worklet การรายงานการชนะของผู้ซื้อ จากนั้นจะเพิ่มข้อมูลเหตุการณ์ภายในเฟรมโฆษณาไปยังบีคอนและมาโครที่ลงทะเบียนได้ด้วยฟังก์ชัน reportEvent และ setReportEventDataForAutomaticBeacons ของ Fenced Frame Ads Reporting API ซึ่งช่วยให้เชื่อมโยงสัญญาณของ Worklet การรายงาน Protected Audience API และเพย์โหลดเหตุการณ์เฟรมครีเอทีฟโฆษณากับสัญญาณอื่นๆ ได้

ระบบจะเพิ่มAttribution-Reporting-Eligibleส่วนหัว HTTP ลงในคำขอเมื่อบีคอนและมาโครทริกเกอร์โดยการเรียก reportEvent จากเฟรม หรือเมื่อเบราว์เซอร์ทริกเกอร์บีคอนอัตโนมัติ คุณใช้การตอบกลับของบีคอนเพื่อลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาได้ ระบบอาจเปลี่ยนเส้นทางคำขอ Beacon เพื่ออนุญาตการวัดผลโดยบุคคลที่สาม

ดูข้อมูลเพิ่มเติมได้ที่ส่วนการรองรับการรายงานผลการระบุแหล่งที่มาของคำอธิบาย Fenced Frame Ad Reporting API

เปิดใช้การรายงานการระบุแหล่งที่มาสำหรับรูปแบบ VAST

VAST เป็นรูปแบบทั่วไปสำหรับการแสดงและวัดพื้นที่โฆษณาวิดีโอ และเหตุการณ์หลายอย่างที่กำหนดไว้ในมาตรฐานนั้นควรพิจารณาว่าเป็นเหตุการณ์ต้นทางที่มีศักยภาพซึ่งมีสิทธิ์ลงทะเบียนกับ Attribution Reporting API เอกสารแนบท้าย VAST สำหรับการรองรับการรายงานการระบุแหล่งที่มาจะอธิบายเรื่องนี้โดยละเอียด แต่โดยสรุปแล้ว เหตุการณ์ <Tracking>, <Impression>, <*ClickThrough> และ <*ClickTracking> ทั้งหมดเป็นเหตุการณ์แหล่งที่มาของการระบุแหล่งที่มาที่อาจเกิดขึ้น การติดตั้งใช้งาน VAST ทั้งหมดควรให้ความครอบคลุมการมีสิทธิ์ลงทะเบียนสำหรับเหตุการณ์เหล่านี้

ข้อแก้ไขเพิ่มเติมของ VAST จะกำหนดแอตทริบิวต์ใหม่สำหรับองค์ประกอบเหล่านี้เพื่อให้ตั้งค่า URL รองสำหรับการลงทะเบียนการระบุแหล่งที่มาโดยเฉพาะได้ เมื่อเหตุการณ์มี attributiontype="DOUBLE_PING" และ attributionsrc="[URL]" โค้ดที่ทริกเกอร์เหตุการณ์นั้นควรใช้ [URL] เป็นค่าของแอตทริบิวต์ attributionsrc เมื่อเปิดใช้ Attribution Reporting API ภาคผนวก VAST มีตัวอย่างสำหรับแต่ละสถานการณ์

การติดตั้งใช้งาน VAST ควรทำให้เหตุการณ์ทั้งหมดที่ระบุมีสิทธิ์ลงทะเบียนโดยค่าเริ่มต้นเมื่อมีการเรียกใช้ Ping เหตุการณ์เพื่อให้ครอบคลุมสูงสุด ตัวอย่างเช่น เมื่อเรียกใช้ URL ของเหตุการณ์ <Impression> คุณควรใช้แอตทริบิวต์ (ว่าง) attributionsrc ในองค์ประกอบ <img> ที่ใช้ส่งคำขอ (หรือเทียบเท่าในการเรียกใช้ Fetch) เพื่อให้ผู้รับสามารถลงทะเบียนเหตุการณ์นั้นกับ Attribution Reporting API ได้เสมอ

ขั้นตอนที่ 2: เปิดใช้การรายงานการระบุแหล่งที่มาสำหรับต้นทางของบุคคลที่สาม

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

จัดการต้นทางของบุคคลที่สามในเชนการเปลี่ยนเส้นทางที่มีอยู่

ในการคลิกผ่านโฆษณาทั่วไป เครื่องมือติดตามการคลิกจำนวนมากอาจแสดงเป็นเชนของ302การเปลี่ยนเส้นทางที่ทำเป็นส่วนหนึ่งของการไปยังหน้า Landing Page สุดท้าย คำขอทุกรายการในเชนการเปลี่ยนเส้นทางจะมีสิทธิ์ลงทะเบียนกับ Attribution Reporting API หากมีการใส่คำอธิบายประกอบเป้าหมายการคลิกเดิมด้วย attributionsrc หรือลงทะเบียนด้วย registerAdBeacon/registerAdMacro ใน Protected Audience API เทคโนโลยีโฆษณาในเชนการเปลี่ยนเส้นทางต้องลงทะเบียนด้วย

โปรดทราบว่าระบบจะไม่ส่งเนื้อหาของคำขอเริ่มต้นในการเปลี่ยนเส้นทาง สำหรับการประมูลที่ใช้ Protected Audience API หากมีการส่ง eventData ไปยัง reportEvent และต้องใช้ setReportEventDataForAutomaticBeacons เป็นส่วนหนึ่งของการเปลี่ยนเส้นทาง คุณต้องส่ง eventData อย่างชัดเจนเป็นส่วนหนึ่งของ URL การเปลี่ยนเส้นทาง

ในตัวอย่างต่อไปนี้ เราจะใช้เทคโนโลยีโฆษณาที่แสดง (serving-adtech.example) และผู้ให้บริการวัดผลบุคคลที่สาม (3p-measurement.example) เป็น 2 หน่วยงานที่แตกต่างกันซึ่งต้องการสร้างและรับรายงานการระบุแหล่งที่มา เทคโนโลยีโฆษณาที่แสดงในตัวอย่างนี้อาจเป็น DSP ที่แสดงผลครีเอทีฟโฆษณาในเว็บไซต์ของผู้เผยแพร่โฆษณา และมีผลิตภัณฑ์การรายงานของตนเอง ผู้ให้บริการวัดผลบุคคลที่สามอาจเป็นนิติบุคคลที่ผู้ลงโฆษณาใช้สำหรับการรายงาน Conversion

แผนภาพที่อธิบายวิธีที่บุคคลที่หนึ่งลงทะเบียนแหล่งที่มา
ตัวอย่างวิธีการทํางานของการวัด Conversion กับบุคคลที่สาม

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

  1. serving-adtech.example ตั้งค่าแอตทริบิวต์ attributionsrc ในครีเอทีฟโฆษณา ผู้ใช้เข้าชมหน้าผู้เผยแพร่โฆษณา และเบราว์เซอร์จะส่งคำขอไปยัง serving-adtech.example.
  2. serving-adtech.example ตอบกลับด้วยส่วนหัว Attribution-Reporting-Register-Source และส่วนหัว Location
    1. serving-adtech.example ใช้ส่วนหัว Attribution-Reporting-Register-Source เพื่อตอบกลับด้วยข้อมูลเมตาเกี่ยวกับแหล่งที่มาที่จะลงทะเบียน
    2. serving-adtech.example ใช้ส่วนหัว Location เพื่อรวมการเปลี่ยนเส้นทางไปยัง 3p-measurement.example โปรดทราบว่ามีแนวโน้มที่จะมีการใช้ส่วนหัว Location ในโฟลว์การติดตามคลิกที่มีอยู่แล้วเพื่อรองรับการเปลี่ยนเส้นทาง 302 ไปยังบุคคลที่สาม
  3. เบราว์เซอร์จะได้รับการตอบกลับจาก serving-adtech.example และแยกวิเคราะห์ส่วนหัว Attribution-Reporting-Register-Source เบราว์เซอร์จะจัดเก็บเหตุการณ์แหล่งที่มาโดยใช้ serving-adtech.example เป็นแหล่งที่มาของการรายงาน
  4. เนื่องจากคำขอนี้เป็นการเปลี่ยนเส้นทาง เบราว์เซอร์จึงส่งคำขอใหม่ไปยัง 3p-measurement.example ด้วย
  5. 3p-measurement.example จะตอบกลับด้วยการตอบกลับที่มีส่วนหัว Attribution-Reporting-Register-Source
  6. เบราว์เซอร์จะได้รับการตอบกลับนี้จาก 3p-measurement.example และอ่าน Attribution-Reporting-Register-Source เบราว์เซอร์จะจัดเก็บเหตุการณ์แหล่งที่มาโดยใช้ 3p-measurement.example เป็นแหล่งที่มาของการรายงาน

ใช้ attributionsrc สำหรับต้นทางของบุคคลที่สามที่ไม่ได้อยู่ในเชนการเปลี่ยนเส้นทาง

หากต้นทางของผู้รายงานหลายรายต้องการลงทะเบียนแหล่งที่มาในเหตุการณ์การนำทาง แต่ไม่สามารถปรากฏในเชนการเปลี่ยนเส้นทางได้ไม่ว่าด้วยเหตุผลใดก็ตาม คุณสามารถแสดงเว็บไซต์หลายแห่งเป็นแหล่งที่มาของการระบุแหล่งที่มาใน attributionsrc เป็นทางเลือกได้

การตั้งค่าที่มีอยู่ มีการแก้ไข ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

ในตัวอย่างนี้ ระบบจะส่งคำขอที่มีสิทธิ์สำหรับ Attribution Reporting API ไปยังทั้ง REPORTING_URL_1 และ REPORTING_URL_2 คำขอการนำทางที่ส่งไปยัง URL การคลิกผ่านจะมีสิทธิ์ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาด้วย

ขั้นตอนที่ 3: ตั้งค่าการตอบกลับสำหรับคำขอ Attribution Reporting API

สำหรับต้นทางทั้งหมดที่ได้รับคำขอ Attribution Reporting API ให้ตรวจสอบว่าเซิร์ฟเวอร์ตอบกลับด้วยส่วนหัว Attribution-Reporting-Register-Source ที่เหมาะสม ดูคำแนะนำในการลงทะเบียนแหล่งข้อมูลและคำอธิบายเพื่อดูวิธีสร้างการตอบกลับ

ลงทะเบียนทริกเกอร์หลายรายการ

คุณลงทะเบียนทริกเกอร์การระบุแหล่งที่มาหลายรายการได้โดยการเพิ่มองค์ประกอบพิกเซลหลายรายการในฝั่ง Conversion (1 รายการต่อทริกเกอร์) องค์ประกอบ attributionsrc เป็นค่าที่ไม่บังคับสำหรับการลงทะเบียนทริกเกอร์

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