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

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

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

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

เอกสารนี้มีไว้สำหรับใคร

คุณควรอ่านเอกสารนี้ในกรณีต่อไปนี้

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

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

ภาพรวม

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

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

โดยจะมีคอมโพเนนต์ 2 (และบางครั้ง 3) รายการที่ทำงานร่วมกันเพื่อรองรับการรายงานเสมอ ดังนี้

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

หากรวบรวมรายงานที่รวบรวมได้ คุณจะต้องมีคอมโพเนนต์ที่ 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}`);
   

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

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

   

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

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

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

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

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

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

   

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

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

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

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

ซึ่งจะช่วยยืนยันว่าผลลัพธ์รวมมีความละเอียดและถูกต้องสำหรับเหตุการณ์เหล่านี้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ขั้นตอนต่อไปคืออะไร

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

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

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

ทดลองใช้ API

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