เปิดใช้การวัด 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 ของแท็กแอนคอร์ (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 ของแท็กแองเคอร์

ตัวอย่างแอตทริบิวต์ 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
    • การคลิกที่ใช้ 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");
การแสดงผล แท็ก 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 ในการประมูลกลุ่มเป้าหมายที่ได้รับการคุ้มครอง คุณสามารถใช้ registerAdBeacon/registerAdMacro และ setReportEventDataForAutomaticBeacons/reportEvent เพื่อเปิดใช้การลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาแทนการใช้ attributionsrc

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

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

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