เปิดใช้การวัด 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
    • เหตุการณ์การแสดงผลที่ใช้ Fetch API ควรมีออบเจ็กต์ attributionReporting ในอาร์กิวเมนต์ options ที่ส่งไปยังการเรียก 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

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

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

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

สำหรับข้อมูลเจาะลึก โปรดดูที่ส่วนการรองรับ Attribution Reporting ของคำอธิบาย 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การประมูล หากจำเป็นต้องใช้ 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 ในลักษณะเดียวกับการลงทะเบียนแหล่งที่มา ระบบจะจับคู่เหตุการณ์ต้นทางและเหตุการณ์ทริกเกอร์ที่สร้างโดยต้นทางเดียวกัน