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

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

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

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

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

บทความนี้มีไว้สำหรับผู้ใด

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

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

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

ภาพรวม

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

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

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

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

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

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

การตัดสินใจเกี่ยวกับการออกแบบ

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

รายงานเอาต์พุตอาจเป็นรูปแบบใดก็ได้ต่อไปนี้

• รายงานระดับเหตุการณ์จะเชื่อมโยงการคลิกหรือยอดดูโฆษณาหนึ่งๆ (ฝั่งโฆษณา) กับข้อมูลฝั่ง 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 ซึ่งก็คือทริกเกอร์การระบุแหล่งที่มา ในการดําเนินการดังกล่าว ผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณาจะใส่ส่วนหัว HTTP พิเศษที่มีข้อมูลที่กำหนดเองเกี่ยวกับ Conversion ในการตอบกลับคำขอพิกเซล

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

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

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เช่นเดียวกับ Privacy Sandbox API อื่นๆ API นี้มีเอกสารประกอบและมีการพูดคุยกันแบบสาธารณะ

ทดลองใช้ API

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