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

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

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

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

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

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

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

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

ภาพรวม

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

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

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

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

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

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

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

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

รายงานเอาต์พุตอาจเป็นสิ่งต่อไปนี้

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

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

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

เมื่อเลือกสิ่งที่ต้องการวัดได้แล้ว คุณสามารถตั้งค่าฝั่งไคลเอ็นต์สำหรับ Attribution Reporting API

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

หมายเหตุ: ขณะที่ API นี้อยู่ระหว่างการทดสอบ โค้ดต้องยืนยันว่า API พร้อมใช้งานและกำหนดสิทธิ์-นโยบายที่เหมาะสม

แหล่งที่มาของการระบุแหล่งที่มาบนเว็บไซต์ของผู้เผยแพร่โฆษณาจะเชื่อมต่อกับทริกเกอร์บนเว็บไซต์ของผู้ลงโฆษณา

ขั้นตอนของเหตุการณ์การระบุแหล่งที่มา

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

1. ในเว็บไซต์ของผู้เผยแพร่โฆษณา องค์ประกอบโฆษณา (แท็ก <a> หรือ <img>) ได้รับการกำหนดค่าด้วยแอตทริบิวต์พิเศษ attributionsrc ค่าของ URL คือ 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 ชั่วโมงและกิจกรรมจะต้องไม่เกินงบประมาณการมีส่วนร่วม ตัวเลือกเหล่านี้จะปกป้องความเป็นส่วนตัวและป้องกันการแสวงหาประโยชน์จากการกระทำของผู้ใช้แต่ละราย

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

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

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

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

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

รายงานแบบรวมกลุ่มได้

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

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

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

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

บริการรวบรวม

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

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

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

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

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

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

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

ทดลองใช้ API

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