เปิดใช้การวัด 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 ได้ กำหนด URL ของ attributionsrc ของคุณเองหากต้องการให้คำขอ 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 จะเป็นเทคโนโลยีโฆษณาที่ใช้แสดงโฆษณา
    • ควรเพิ่มแอตทริบิวต์ attributionsrc สำหรับแท็ก Anchor ที่มีกิจกรรมการคลิก
    • การคลิกที่ใช้ window.open ควรใช้อาร์กิวเมนต์ windowFeatures ของการเรียก window.open เพื่อระบุแหล่งที่มาของการระบุแหล่งที่มา
  • เหตุการณ์การแสดงผล
    • บุคคลที่มีหน้าที่เพิ่ม attributionsrc มักจะเป็นเทคโนโลยีโฆษณาที่แสดงโฆษณาและผู้ให้บริการวัดผล
    • เหตุการณ์การแสดงผลที่เริ่มทำงานจากแท็ก <img> หรือแท็ก <script> ควรมีแอตทริบิวต์ attributionsrc
    • เหตุการณ์การแสดงผลที่ใช้ API การดึงข้อมูลควรมีออบเจ็กต์ attributionReporting ในอาร์กิวเมนต์ตัวเลือกที่ส่งไปยังการเรียก 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");
การแสดงผล แท็ก HTML <img> <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
แท็ก HTML <script> <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

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

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

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

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