ภาพรวมระดับสูงของบริการที่เชื่อมต่อสำหรับการรายงานการระบุแหล่งที่มา ซึ่งมุ่งเป้าไปยังผู้มีอำนาจตัดสินใจทางเทคนิค
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
การสื่อสารระหว่างเว็บไซต์กับเบราว์เซอร์
ขั้นตอนของเหตุการณ์การระบุแหล่งที่มา
ลองจินตนาการถึงเว็บไซต์ของผู้เผยแพร่โฆษณาที่แสดงโฆษณา ผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณาแต่ละรายต้องการทราบข้อมูลเกี่ยวกับการโต้ตอบกับโฆษณา และระบุแหล่งที่มาของ Conversion ไปยังโฆษณาที่ถูกต้อง รายงาน (ทั้งระดับเหตุการณ์และรวบรวมข้อมูลได้) จะสร้างขึ้นดังนี้
ในเว็บไซต์ของผู้เผยแพร่โฆษณา องค์ประกอบโฆษณา (แท็ก
<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});
- เมื่อผู้ใช้คลิกหรือดูโฆษณา เบราว์เซอร์จะส่งคำขอ
GET
ไปยังattributionsrc
ซึ่งโดยปกติแล้วจะเป็นปลายทางผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณา เมื่อได้รับคำขอนี้ ผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณาตัดสินใจสั่งให้เบราว์เซอร์ลงทะเบียนเหตุการณ์แหล่งที่มาสำหรับการโต้ตอบกับโฆษณา เพื่อให้ระบุแหล่งที่มาของ Conversion ไปยังโฆษณานี้ในภายหลังได้ โดยผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณาจะรวมส่วนหัว HTTP พิเศษไว้ในการตอบกลับ โดยแนบกับข้อมูลที่กำหนดเองของส่วนหัวนี้ที่ให้ข้อมูลเกี่ยวกับเหตุการณ์แหล่งที่มา (การคลิกหรือการดูโฆษณา) หาก Conversion เกิดขึ้นสำหรับโฆษณานี้ ข้อมูลที่กำหนดเองนี้จะปรากฏในรายงานการระบุแหล่งที่มาในที่สุด
ต่อมา ผู้ใช้เข้าชมเว็บไซต์ของผู้ลงโฆษณา
ในหน้าที่เกี่ยวข้องแต่ละหน้าในเว็บไซต์ของผู้ลงโฆษณา เช่น หน้ายืนยันการซื้อหรือหน้าผลิตภัณฑ์ พิกเซล Conversion (องค์ประกอบ
<img>
) หรือการเรียก JavaScript จะส่งคำขอไปยังhttps://adtech.example/conversion?param1=...¶m2=...
บริการใน URL นี้ซึ่งโดยปกติจะเป็นผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณาจะได้รับคําขอ เครื่องมือตัดสินใจที่จะจัดหมวดหมู่รายการเป็น Conversion จึงต้องออกคำสั่งเบราว์เซอร์ให้บันทึก Conversion เพื่อทริกเกอร์การระบุแหล่งที่มา โดยผู้ลงโฆษณาหรือผู้ให้บริการเทคโนโลยีโฆษณาจะรวมส่วนหัว HTTP พิเศษที่มีข้อมูลที่กำหนดเองเกี่ยวกับ Conversion ไว้ในการตอบสนองต่อคำขอพิกเซล
เบราว์เซอร์ในอุปกรณ์ของผู้ใช้จะได้รับการตอบกลับนี้ และจับคู่ข้อมูล Conversion กับเหตุการณ์แหล่งที่มาเดิม (การคลิกโฆษณาหรือการดู) ดูข้อมูลเพิ่มเติมในจับคู่แหล่งที่มากับทริกเกอร์
เบราว์เซอร์กำหนดเวลาให้ส่งรายงานไปยัง
attributionsrc
รายงานนี้มีข้อมูลต่อไปนี้- ข้อมูลการกําหนดค่าการระบุแหล่งที่มาที่กำหนดเองซึ่งผู้ให้บริการเทคโนโลยีโฆษณาหรือผู้ลงโฆษณาแนบไว้กับเหตุการณ์แหล่งที่มาในขั้นตอนที่ 3
- ข้อมูล Conversion ที่กําหนดเองในขั้นตอนที่ 6
หลังจากนั้น เบราว์เซอร์จะส่งรายงานไปยังปลายทางที่ระบุไว้ใน
attributionsrc
พร้อมด้วยการหน่วงเวลาและเสียงรบกวน โดยรายงานที่รวบรวมได้จะมีการเข้ารหัส ขณะที่รายงานระดับเหตุการณ์จะไม่มีการเข้ารหัส
ทริกเกอร์การระบุแหล่งที่มา (เว็บไซต์ของผู้ลงโฆษณา)
ทริกเกอร์การระบุแหล่งที่มาคือเหตุการณ์ที่บอกเบราว์เซอร์ให้บันทึก Conversion
เราแนะนำให้บันทึก Conversion ที่สำคัญที่สุดสำหรับผู้ลงโฆษณา เช่น การซื้อ คุณบันทึก Conversion และข้อมูลเมตาหลายประเภทไว้ในรายงานสรุปได้
วิธีนี้จะช่วยให้มั่นใจได้ว่าผลลัพธ์แบบรวมจะมีรายละเอียดและถูกต้องสำหรับเหตุการณ์เหล่านี้
จับคู่แหล่งที่มากับทริกเกอร์
เมื่อเบราว์เซอร์ได้รับการตอบกลับทริกเกอร์การระบุแหล่งที่มา เบราว์เซอร์จะเข้าถึงพื้นที่เก็บข้อมูลในเครื่องเพื่อค้นหาแหล่งที่มาที่ตรงกับทั้งต้นทางของทริกเกอร์การระบุแหล่งที่มาและ eTLD+1 ของ URL ของหน้าเว็บนั้น
ตัวอย่างเช่น เมื่อเบราว์เซอร์ได้รับทริกเกอร์การระบุแหล่งที่มาจาก adtech.example
ใน shoes.example/shoes123
เบราว์เซอร์จะมองหาแหล่งที่มาในพื้นที่เก็บข้อมูลในเครื่องที่ตรงกับทั้ง adtech.example
และ shoes.example
คุณตั้งค่าตัวกรอง (หรือกฎที่กำหนดเอง) เพื่อระบุเวลาที่ทริกเกอร์จับคู่กับแหล่งที่มาที่เฉพาะเจาะจงได้ ตัวอย่างเช่น ตั้งค่าตัวกรองให้นับเฉพาะ Conversion สำหรับหมวดหมู่ผลิตภัณฑ์ที่เจาะจงและละเว้นหมวดหมู่อื่นๆ ทั้งหมด ตัวกรองและรูปแบบการจัดลำดับความสำคัญช่วยให้มีการรายงานการระบุแหล่งที่มาขั้นสูงขึ้น
หากพบแหล่งที่มาของการระบุแหล่งที่มาหลายแหล่งในพื้นที่เก็บข้อมูลในเครื่อง เบราว์เซอร์จะเลือกแหล่งที่มาที่จัดเก็บไว้ล่าสุด ในบางกรณีที่มีการกำหนดลำดับความสำคัญของแหล่งที่มาของการระบุแหล่งที่มา เบราว์เซอร์จะเลือกแหล่งที่มาที่มีลำดับความสำคัญสูงสุด
การรวบรวมข้อมูล
เมื่อรวมกันแล้ว ทริกเกอร์การระบุแหล่งที่มาที่ตรงกับแหล่งที่มาที่เกี่ยวข้องจะส่งเป็นรายงานโดยเบราว์เซอร์ไปยังปลายทางการรายงานในเซิร์ฟเวอร์ที่เทคโนโลยีโฆษณาเป็นเจ้าของ (บางครั้งเรียกว่าปลายทางการรวบรวมข้อมูลหรือบริการรวบรวม) รายงานเหล่านี้อาจเป็นรายงานระดับเหตุการณ์หรือรายงานที่รวบรวมได้
รายงานที่รวบรวมได้ใช้สำหรับสร้างรายงานสรุป รายงานที่รวบรวมได้คือข้อมูลที่รวบรวมจากโฆษณา (ในเว็บไซต์ของผู้เผยแพร่โฆษณา) และข้อมูล Conversion (จากเว็บไซต์ของผู้ลงโฆษณา) ซึ่งเบราว์เซอร์สร้างขึ้นและเข้ารหัสไว้ในอุปกรณ์ของผู้ใช้ก่อนที่เทคโนโลยีโฆษณาจะรวบรวมไว้
รายงานระดับเหตุการณ์จะล่าช้าระหว่าง 2 ถึง 30 วัน ระบบจะส่งรายงานที่รวบรวมได้ซึ่งมีความล่าช้าแบบสุ่มภายใน 1 ชั่วโมงและกิจกรรมจะต้องไม่เกินงบประมาณการมีส่วนร่วม ตัวเลือกเหล่านี้จะปกป้องความเป็นส่วนตัวและป้องกันการแสวงหาประโยชน์จากการกระทำของผู้ใช้แต่ละราย
หากคุณสนใจเฉพาะรายงานระดับเหตุการณ์ นี่คือโครงสร้างพื้นฐานส่วนสุดท้ายที่คุณต้องการ แต่หากต้องการสร้างรายงานสรุป คุณจะต้องประมวลผลรายงานที่รวบรวมได้กับบริการเพิ่มเติม
การสร้างรายงานสรุป
หากต้องการสร้างรายงานสรุป คุณจะใช้บริการรวบรวมข้อมูล (ดำเนินการโดยเทคโนโลยีโฆษณา) เพื่อประมวลผลรายงานที่รวบรวมได้ บริการการรวมจะแทรกเสียงรบกวนเพื่อปกป้องความเป็นส่วนตัวของผู้ใช้และแสดงผลรายงานสรุปขั้นสุดท้าย
รายงานแบบรวมกลุ่มได้
ก่อนที่จะประมวลผลรายงานที่รวบรวมได้ ต้องแยกรายงานเป็นกลุ่มก่อน กลุ่มประกอบด้วยรายงานที่รวบรวมได้ที่มีการจัดกลุ่มอย่างมีกลยุทธ์ กลยุทธ์ของคุณมักจะสอดคล้องกับช่วงเวลาที่เฉพาะเจาะจง (เช่น รายวันหรือรายสัปดาห์) กระบวนการนี้อาจเกิดขึ้นในเซิร์ฟเวอร์เดียวกับที่ทำหน้าที่เป็นปลายทางการรายงาน
กลุ่มควรมีรายงานจำนวนมากเพื่อให้แน่ใจว่าอัตราส่วนสัญญาณต่อเสียงรบกวนอยู่ในระดับสูง
ช่วงเวลากลุ่มอาจเปลี่ยนแปลงได้ตลอดเวลาเพื่อให้แน่ใจว่าคุณจะบันทึกเหตุการณ์ที่เฉพาะเจาะจงซึ่งคาดว่าจะได้รับปริมาณสูงขึ้น เช่น การลดราคาประจำปี ระยะเวลาการทำงานเป็นกลุ่มจะเปลี่ยนแปลงได้โดยไม่ต้องเปลี่ยนแหล่งที่มาของการระบุแหล่งที่มาหรือทริกเกอร์
บริการรวบรวม
บริการรวบรวมข้อมูลมีหน้าที่ประมวลผลรายงานที่รวบรวมได้เพื่อสร้างรายงานสรุป รายงานที่รวบรวมได้จะมีการเข้ารหัสและมีเพียงบริการรวบรวมเนื้อหา (Aggregation Service หรือ TEE) เท่านั้นที่ทำงานบนสภาพแวดล้อมการดำเนินการที่เชื่อถือได้ (TEE)
บริการรวบรวมจะขอคีย์การถอดรหัสจากผู้ประสานงานเพื่อถอดรหัสและรวบรวมข้อมูล เมื่อถอดรหัสและรวบรวมข้อมูลแล้ว ระบบจะส่งเสียงผลลัพธ์ เพื่อรักษาความเป็นส่วนตัวและแสดงผลเป็นรายงานสรุป
ผู้ปฏิบัติงานสามารถสร้างรายงานข้อความธรรมดาที่รวบรวมได้เพื่อทดสอบบริการรวบรวมข้อมูลภายในเครื่อง หรือคุณจะทดสอบด้วยรายงานที่เข้ารหัสบน AWS ด้วย Nitro Enclaves ก็ได้
ขั้นตอนถัดไปคือ
เราต้องการพูดคุยกับคุณเพื่อให้แน่ใจว่าเราได้สร้าง API ที่เหมาะสำหรับทุกคน
พูดคุยเกี่ยวกับ API
API นี้มีการบันทึกและพูดคุยแบบสาธารณะเช่นเดียวกับ Privacy Sandbox API อื่นๆ
ทดลองใช้ API
คุณสามารถทดสอบและเข้าร่วม เกี่ยวกับ Attribution Reporting API