การรายงานการระบุแหล่งที่มา: ภาพรวมของระบบทั้งหมด

ภาพรวมระดับสูงของบริการที่เชื่อมต่อสำหรับการรายงานการระบุแหล่งที่มาซึ่งมีจุดมุ่งหมายเพื่อผู้มีอำนาจตัดสินใจทางเทคนิค

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

ก่อนดำเนินการต่อ โปรดอ่าน ภาพรวมของ Attribution Reporting ซึ่งจะช่วยให้คุณเข้าใจถึงวัตถุประสงค์ของ API และขั้นตอนของรายงานเอาต์พุตต่างๆ (รายงานระดับเหตุการณ์ และรายงานสรุป) หากพบคำศัพท์ที่ไม่คุ้นเคย โปรดไปที่ อภิธานศัพท์ของ Privacy Sandbox

บทความนี้มีไว้สําหรับใคร

คุณควรอ่านบทความนี้ในกรณีต่อไปนี้

• คุณเป็นผู้มีอำนาจตัดสินใจด้านเทคนิคของผู้ลงโฆษณาหรือเทคโนโลยีโฆษณา คุณอาจทำงาน ในการดำเนินงาน, DevOps, วิทยาศาสตร์ข้อมูล, ไอที, การตลาด หรือบทบาทอื่นๆ คุณต้องทำการตัดสินใจทางเทคนิคในการใช้งาน คุณกำลังสงสัยว่า API ทำงานอย่างไรสำหรับการวัดด้านการรักษาความเป็นส่วนตัว
• คุณเป็นผู้ปฏิบัติงานทางเทคนิค (เช่น นักพัฒนาซอฟต์แวร์ โอเปอเรเตอร์ระบบ สถาปนิกระบบ หรือนักวิทยาศาสตร์ข้อมูล) ที่จะตั้งค่าการทดลองกับ สภาพแวดล้อม API และ Aggregation Service นี้

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

ภาพรวม

Attribution Reporting API ประกอบด้วยบริการมากมายที่ต้องใช้องค์ประกอบ การตั้งค่า การกำหนดค่าฝั่งไคลเอ็นต์ และการทำให้เซิร์ฟเวอร์ใช้งานได้ เพื่อดูว่า ก่อนอื่น

• ตัดสินใจเรื่องการออกแบบ กำหนดข้อมูลที่ต้องการรวบรวม ระบุ Conversion ที่ต้องการจากแคมเปญที่กำหนด และเลือกประเภทรายงานที่จะรวบรวม ผลลัพธ์สุดท้ายจะเป็นรายงานประเภทใดประเภทหนึ่งหรือทั้ง 2 ประเภท ได้แก่ รายงานระดับเหตุการณ์และรายงานสรุป

มีองค์ประกอบ 2 (หรือ 3 รายการ) ที่ทำงานร่วมกันเพื่อสนับสนุนการรายงานเสมอ ได้แก่

• การสื่อสารระหว่างเว็บไซต์กับเบราว์เซอร์ ใน ระบบต่างๆ ที่ใช้คุกกี้ ข้อมูลสำหรับ Conversion และการมีส่วนร่วมกับโฆษณา แนบอยู่กับตัวระบุที่ทำให้คุณหรือบริการวิเคราะห์เข้าร่วมได้ กิจกรรมเหล่านี้ในภายหลัง เมื่อใช้ API นี้ เบราว์เซอร์จะเชื่อมโยง Conversion กับ จำนวนคลิก/การดูโฆษณา ตามคำสั่งของคุณ ก่อนที่จะแสดงโฆษณา การวิเคราะห์ของคุณ ดังนั้น โค้ดการแสดงโฆษณาและเครื่องมือวัด Conversion ของคุณต้องมีลักษณะดังนี้
  • บอกเบราว์เซอร์ว่า Conversion ใดควรมาจากโฆษณาใด คลิกหรือการแสดงผล
  • ส่งสัญญาณอื่นๆ ที่จะรวมไว้ในรายงานขั้นสุดท้าย
• การรวบรวมข้อมูล คุณจะต้องมีปลายทางผู้รวบรวมเพื่อ ได้รับรายงานซึ่งสร้างขึ้นใน เบราว์เซอร์ ผลลัพธ์จากเบราว์เซอร์ อาจเป็นรายงานที่เป็นไปได้ 1 ใน 2 ประเภท ได้แก่ รายงานระดับเหตุการณ์และรายงานที่รวบรวม รายงาน (ซึ่งเข้ารหัสไว้ ใช้เพื่อสร้างรายงานสรุป)

หากรวบรวมรายงานที่รวบรวมได้ คุณจะต้องมีองค์ประกอบที่ 3 ได้แก่

• การสร้างรายงานสรุป กลุ่ม รายงานที่รวบรวมได้และใช้บริการรวมข้อมูลเพื่อประมวลผลรายงาน เพื่อสร้างรายงานสรุป

การตัดสินใจออกแบบ

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

รายงานผลลัพธ์อาจมีลักษณะดังนี้

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

การเลือกรายงานจะเป็นตัวกำหนดข้อมูลที่คุณจะต้องรวบรวม

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

เมื่อตัดสินใจได้แล้วว่าต้องการวัดผลใด ก็ตั้งค่าฝั่งไคลเอ็นต์ สำหรับ Attribution Reporting API

การสื่อสารจากเว็บไซต์กับเบราว์เซอร์

วันที่

โฟลว์เหตุการณ์การระบุแหล่งที่มา

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

1. ในเว็บไซต์ของผู้เผยแพร่โฆษณา องค์ประกอบโฆษณา (แท็ก <a> หรือ <img>) ได้รับการกำหนดค่าด้วยแอตทริบิวต์พิเศษ attributionsrc ค่าของรายการคือ URL เช่น https://adtech.example/register-source/ad_id=...

   ต่อไปนี้คือตัวอย่างของลิงก์ที่จะลงทะเบียนแหล่งที่มาเมื่อคลิก:

   <a href="https://shoes.example/landing" 
     attributionsrc="http://adtech.example/register-source?..."
     target="_blank">
   Click me</a>
   

   ต่อไปนี้คือตัวอย่างรูปภาพที่จะทำให้เกิดการลงทะเบียนแหล่งที่มาเมื่อดู

   <img href="https://advertiser.example/landing" 
     attributionsrc="https://adtech.example/register-source?..."/>
   

   หรือจะใช้การเรียก JavaScript แทนองค์ประกอบ HTML ก็ได้

   ต่อไปนี้เป็นตัวอย่าง JavaScript ที่ใช้ window.open() โปรดทราบว่า URL มีการเข้ารหัส URL เพื่อหลีกเลี่ยงปัญหาการใช้สัญลักษณ์พิเศษ

   const encodedUrl = encodeURIComponent(
     'https://adtech.example/attribution_source?ad_id=...');
   window.open(
     "https://shoes.example/landing",
     "_blank",
     attributionsrc=${encodedUrl});
   

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

2. เมื่อได้รับคำขอนี้ ผู้ลงโฆษณาหรือผู้ให้บริการด้านเทคโนโลยีโฆษณาตัดสินใจสั่งให้เบราว์เซอร์ลงทะเบียนเหตุการณ์แหล่งที่มาสำหรับการโต้ตอบกับโฆษณา เพื่อให้ระบุแหล่งที่มาของ Conversion จากโฆษณานี้ได้ภายหลัง โดยผู้ลงโฆษณาหรือผู้ให้บริการด้านเทคโนโลยีโฆษณาจะต้องใส่ส่วนหัว HTTP พิเศษไว้ในการตอบสนองด้วย โดยระบบจะแนบข้อมูลที่กำหนดเองของส่วนหัวซึ่งให้ข้อมูลเกี่ยวกับเหตุการณ์แหล่งที่มา (การคลิกหรือการดูโฆษณา) หาก Conversion เกิดขึ้นสำหรับโฆษณานี้ ข้อมูลที่กำหนดเองนี้จะแสดงในรายงานการระบุแหล่งที่มาในท้ายที่สุด

   

3. ต่อมา ผู้ใช้เข้าชมเว็บไซต์ของผู้ลงโฆษณา

4. ในหน้าที่เกี่ยวข้องแต่ละหน้าในเว็บไซต์ของผู้ลงโฆษณา เช่น หน้ายืนยันการซื้อหรือหน้าผลิตภัณฑ์ พิกเซล Conversion (องค์ประกอบ <img>) หรือการเรียก JavaScript จะส่งคำขอไปยัง https://adtech.example/conversion?param1=...&param2=...

5. บริการที่ URL นี้ (โดยทั่วไปคือผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณา) จะได้รับคำขอ จึงตัดสินใจจัดหมวดหมู่ Conversion นี้เป็น Conversion จึงต้องสั่งให้เบราว์เซอร์บันทึก Conversion เพื่อทริกเกอร์การระบุแหล่งที่มา โดยผู้ลงโฆษณาหรือผู้ให้บริการด้านเทคโนโลยีโฆษณาจะต้องใส่ส่วนหัว HTTP พิเศษที่มีข้อมูลที่กำหนดเองเกี่ยวกับ Conversion ดังกล่าวตามคำขอพิกเซล

6. เบราว์เซอร์ในอุปกรณ์ภายในของผู้ใช้จะได้รับการตอบกลับนี้ และจับคู่ข้อมูล Conversion กับเหตุการณ์แหล่งที่มาเดิม (การคลิกหรือการดูโฆษณา) ดูข้อมูลเพิ่มเติมในจับคู่แหล่งที่มากับทริกเกอร์

7. เบราว์เซอร์จะตั้งเวลาให้ระบบส่งรายงานไปยัง attributionsrc รายงานนี้ประกอบไปด้วยข้อมูลต่อไปนี้

   1. ข้อมูลการกําหนดค่าการระบุแหล่งที่มาที่กําหนดเองซึ่งผู้ให้บริการเทคโนโลยีโฆษณาหรือผู้ลงโฆษณาแนบกับเหตุการณ์แหล่งที่มาในขั้นตอนที่ 3
   2. ชุดข้อมูล Conversion ที่กําหนดเองในขั้นตอนที่ 6

   

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

ทริกเกอร์การระบุแหล่งที่มา (เว็บไซต์ของผู้ลงโฆษณา)

ทริกเกอร์การระบุแหล่งที่มา คือเหตุการณ์ที่บอกให้เบราว์เซอร์บันทึก Conversion

เราขอแนะนําให้บันทึก Conversion ที่สําคัญที่สุดต่อ ผู้ลงโฆษณา เช่น การซื้อ Conversion และข้อมูลเมตามีได้หลายประเภท ที่บันทึกไว้ในรายงานสรุป

วิธีนี้ช่วยให้ผลลัพธ์รวมมีความละเอียดและแม่นยำสําหรับเหตุการณ์เหล่านี้

จับคู่แหล่งที่มากับทริกเกอร์

เมื่อได้รับการตอบสนองจากทริกเกอร์การระบุแหล่งที่มา เบราว์เซอร์จะเข้าถึง พื้นที่เก็บข้อมูลในเครื่องเพื่อค้นหาแหล่งที่มาที่ตรงกับทั้งทริกเกอร์การระบุแหล่งที่มา ต้นทางและ URL ของหน้าเว็บนั้น eTLD+1

ตัวอย่างเช่น เมื่อเบราว์เซอร์ได้รับทริกเกอร์การระบุแหล่งที่มาจาก adtech.example ใน shoes.example/shoes123 เบราว์เซอร์จะมองหาแหล่งข้อมูลใน พื้นที่เก็บข้อมูลในเครื่องที่ตรงกับทั้ง adtech.example และ shoes.example

คุณตั้งค่าตัวกรอง (หรือกฎที่กำหนดเอง) เพื่อระบุว่าระบบจะจับคู่ทริกเกอร์เมื่อใดได้ แหล่งที่มาที่เจาะจง ตัวอย่างเช่น ตั้งค่าตัวกรองให้นับเฉพาะ Conversion สำหรับ และไม่สนใจหมวดหมู่อื่นๆ ทั้งหมด ตัวกรองและ รูปแบบการจัดลำดับความสำคัญช่วยให้มีการรายงานการระบุแหล่งที่มาขั้นสูงขึ้น

ถ้าพบแหล่งที่มาของการระบุแหล่งที่มาหลายแหล่งในพื้นที่เก็บข้อมูลในเครื่อง เบราว์เซอร์จะเลือก ข้อมูลที่เก็บไว้ล่าสุด ในบางกรณีที่แหล่งที่มาของการระบุแหล่งที่มา ได้รับการกำหนดลำดับความสำคัญ เบราว์เซอร์จะเลือกแหล่งที่มาที่มี ลำดับความสำคัญ

การรวบรวมข้อมูล

เมื่อรวมกันแล้ว ทริกเกอร์การระบุแหล่งที่มาที่ตรงกับแหล่งที่มาที่เกี่ยวข้องจะส่งเป็น รายงานโดยเบราว์เซอร์ไปยังปลายทางการรายงานบนเซิร์ฟเวอร์ที่เป็นของเทคโนโลยีโฆษณา (บางครั้งเรียกว่าบริการปลายทางการเก็บรวบรวมหรือบริการ) เหล่านี้ อาจเป็นรายงานระดับเหตุการณ์หรือรายงานที่รวบรวมได้

รายงานที่รวบรวมได้ จะใช้ในการสร้างรายงานสรุป รายงานที่รวบรวมได้เป็นชุดค่าผสม ข้อมูลที่รวบรวมจากโฆษณา (บนไซต์ของผู้เผยแพร่โฆษณา) และข้อมูล Conversion (จาก ไซต์ของผู้ลงโฆษณา) ซึ่งสร้างขึ้นและเข้ารหัสโดยเบราว์เซอร์ใน อุปกรณ์ของผู้ใช้ก่อนที่เทคโนโลยีโฆษณาจะรวบรวม

รายงานระดับเหตุการณ์จะล่าช้าไประหว่าง 2 ถึง 30 วัน รายงานที่รวบรวมได้คือ ส่งไปแบบสุ่มภายใน 1 ชั่วโมงและเหตุการณ์นั้นจะต้องไม่เกิน งบประมาณการสนับสนุน ตัวเลือกเหล่านี้ช่วยปกป้องความเป็นส่วนตัวและป้องกันการแสวงหาประโยชน์จากการกระทำใดๆ ของผู้ใช้

ถ้าคุณสนใจเฉพาะรายงานระดับเหตุการณ์ นี่คือส่วนสุดท้าย โครงสร้างพื้นฐานที่คุณต้องการ แต่หากต้องการสร้างรายงานสรุป คุณจะต้องประมวลผลรายงานที่รวบรวมได้พร้อมด้วยบริการเพิ่มเติม

การสร้างรายงานสรุป

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

วันที่

รายงานที่รวบรวมได้เป็นกลุ่ม

ก่อนที่รายงานที่รวบรวมได้จะได้รับการประมวลผล รายงานดังกล่าวจะต้องรวมกันเป็นกลุ่ม กลุ่ม ประกอบด้วยรายงานที่รวบรวมได้ อย่างมีกลยุทธ์ กลยุทธ์ของคุณจะ สอดคล้องกับระยะเวลาที่เจาะจง (เช่น รายวันหรือรายสัปดาห์) ช่วงเวลานี้ อาจจะเกิดขึ้นในเซิร์ฟเวอร์เดียวกับที่ทําหน้าที่เป็นปลายทางการรายงาน

กลุ่มควรมีรายงานจำนวนมากเพื่อให้แน่ใจว่ามีอัตราส่วนสัญญาณต่อสัญญาณรบกวนสูง

วันที่

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

บริการรวมข้อมูล

บริการรวบรวมข้อมูลมีหน้าที่รับผิดชอบในการประมวลผลรายงานที่รวบรวมได้เพื่อ สร้างรายงานสรุป รายงานที่รวบรวมได้จะได้รับการเข้ารหัสและ อ่านโดยบริการรวม ซึ่งทำงานบนสภาพแวดล้อมการดำเนินการที่เชื่อถือได้ (TEE)

บริการรวบรวมข้อมูลจะขอคีย์ถอดรหัสจาก Coordinator เพื่อถอดรหัสและรวบรวมข้อมูล เมื่อถอดรหัสและรวบรวมแล้ว ผลลัพธ์ที่ได้ ถูกรบกวนเพื่อรักษาความเป็นส่วนตัวและแสดงผลเป็นรายงานสรุป

ผู้ปฏิบัติงานสามารถสร้างรายงานข้อความที่ชัดเจนที่รวบรวมข้อมูลได้เพื่อ ทดสอบบริการรวมข้อมูลในเครื่อง หรือจะทดสอบกับรายงานที่เข้ารหัสบน AWS ด้วยเครือข่าย Nitro ก็ได้

ขั้นตอนถัดไปคือ

เราอยากสนทนากับคุณเพื่อให้มั่นใจว่าเราได้สร้าง API ที่ ใช้ได้กับทุกคน

พูดคุยเกี่ยวกับ API

เช่นเดียวกับ Privacy Sandbox API อื่นๆ จะมีการจัดทำเอกสารของ API และ อภิปรายต่อสาธารณะ

การทดสอบกับ API

คุณสามารถทดสอบและเข้าร่วม ในการพูดคุยเกี่ยวกับ Attribution Reporting API