นี่คือจุดเริ่มต้น รวมถึงการตั้งค่าและภาพรวมคร่าวๆ
เลือกประเภทรายงาน
เมื่อใช้ Attribution Reporting API คุณสามารถสร้างรายงานได้ 2 ประเภท ได้แก่ ระดับเหตุการณ์และรายงานสรุป รายงานระดับเหตุการณ์ต้องการการตั้งค่าน้อยกว่ารายงานแบบรวมหรือรายงานสรุป จึงอาจเป็นจุดที่ดีในการเริ่มต้น รายงานสรุปต้องมีการผสานรวมกับบริการรวบรวมข้อมูล แต่รายงานระดับเหตุการณ์ไม่ต้องใช้
คุณสามารถตั้งค่าการรายงานได้ทั้งสําหรับรายงานระดับเหตุการณ์และรายงานสรุป องค์ประกอบทั้งสองส่งเสริมกัน
รายงานระดับเหตุการณ์
รายงานระดับเหตุการณ์จะเชื่อมโยงการคลิกหรือการดูโฆษณาหนึ่งๆ (ในด้านโฆษณา) กับข้อมูลด้าน Conversion เพื่อรักษาความเป็นส่วนตัวของผู้ใช้โดยจำกัดการรวมข้อมูลประจำตัวของผู้ใช้ในเว็บไซต์ต่างๆ ข้อมูลฝั่ง Conversion จึงมีจำกัดมาก และข้อมูลจะมีเสียงดัง
รายงานสรุป
รายงานสรุปคือประเภทรายงาน Attribution Reporting API และ Private Aggregation API รายงานสรุปจะมีข้อมูลผู้ใช้ที่รวบรวมไว้ และอาจมีข้อมูล Conversion แบบละเอียดที่มีการเพิ่มเสียงรบกวน รายงานสรุปประกอบด้วยรายงานสรุป
การใช้งาน
คุณเริ่มต้นใช้งานได้ด้วยการลองทำตามขั้นตอนต่อไปนี้
โปรดทราบว่าคุณสามารถสร้างทั้งรายงานระดับเหตุการณ์และรายงานที่รวบรวมได้สําหรับแหล่งที่มาของเหตุการณ์หนึ่งๆ การสาธิตจะแนะนำคุณเกี่ยวกับขั้นตอนต่างๆ
การสร้างรายงานระดับเหตุการณ์
ขั้นตอนขั้นต่ำที่ควรทําเพื่อสร้างรายงานระดับเหตุการณ์มีดังนี้
ลงทะเบียนแหล่งที่มา ดูวิธีการได้ที่ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา โปรดทราบว่าขั้นตอนสำหรับการคลิกและการดูจะแตกต่างกัน
ลงทะเบียนทริกเกอร์ โปรดดูวิธีการที่หัวข้อลงทะเบียนทริกเกอร์การระบุแหล่งที่มา
ตั้งค่าปลายทางด้วย URL ต่อไปนี้
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
ดูโค้ดตัวอย่างใน adtech.js เพื่อดูเมธอดpost
ดูข้อมูลเพิ่มเติมเกี่ยวกับ .well-known ได้ที่นี่
ดูรายละเอียดเพิ่มเติมเกี่ยวกับรายงานระดับเหตุการณ์ได้ที่นี่
การสร้างรายงานสรุป
หากต้องการสร้างรายงานสรุป ให้ทำตามขั้นตอนระดับสูงเหล่านี้
ลงทะเบียนแหล่งที่มา ดูวิธีการได้ที่ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา โปรดทราบว่าขั้นตอนสำหรับการคลิกและการดูจะแตกต่างกัน ดูรายละเอียดเพิ่มเติมได้ในการจดทะเบียนแหล่งที่มาของการระบุแหล่งที่มา
ลงทะเบียนทริกเกอร์ โปรดดูวิธีการที่หัวข้อลงทะเบียนทริกเกอร์การระบุแหล่งที่มา
ตั้งค่าปลายทางสำหรับรายงานรวมด้วย URL ต่อไปนี้
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
ดูโค้ดตัวอย่างใน adtech.js เพื่อดูเมธอดpost
ดูข้อมูลเพิ่มเติมเกี่ยวกับ .well-known ได้ที่นี่ทำเป็นกลุ่มและส่งรายงานเพื่อนำไปประมวลผลต่อโดยบริการรวบรวมข้อมูล ซึ่งจะสร้างรายงานสรุป โปรดดูรายงานแบบรวมกลุ่ม
ดูรายละเอียดเพิ่มเติมเกี่ยวกับรายงานสรุปได้ที่นี่
ดูวิธีตั้งค่ารายงานการแก้ไขข้อบกพร่องในชุดการแก้ไขข้อบกพร่องในการรายงานการระบุแหล่งที่มา
แนวคิดเพิ่มเติมในรายงานสรุป
นอกจากการทำความเข้าใจขั้นตอนใช้งานที่นี่แล้ว แนวคิดต่อไปนี้จะช่วยคุณในการวางแผนกลยุทธ์การรายงานสรุปด้วย:
ขั้นตอนที่ไม่บังคับ
- ตั้งค่าตัวกรอง (ไม่บังคับ) ดังนี้
- ทำตามวิธีการในกำหนดกฎที่กำหนดเองโดยใช้ตัวกรอง
- ตรวจสอบรายละเอียดเกี่ยวกับตัวกรองสำหรับรายงานที่รวบรวมได้ในส่วนทริกเกอร์ของผู้อธิบาย
อย่าลืมการตรวจหาฟีเจอร์
ก่อนใช้ API ให้ตรวจสอบว่า API ไม่ได้ถูกบล็อกในหน้าเว็บโดยใช้ Permissions-Policy หรือไม่ โดยเรียกใช้โค้ดต่อไปนี้
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
หากการตรวจสอบการตรวจจับฟีเจอร์นี้แสดงค่า "จริง" ระบบจะอนุญาตให้ใช้ API ในบริบท (หน้าเว็บ) ที่ดำเนินการตรวจสอบ
โปรดทราบว่าการตรวจสอบเพียงอย่างเดียวไม่ได้รับประกันว่า API จะใช้ได้ในหน้าเว็บ ผู้ใช้อาจปิดใช้ API โดยใช้การตั้งค่าเบราว์เซอร์ หรืออาจมีการตั้งค่าอื่นๆ ที่ป้องกันไม่ให้ใช้ API ดังกล่าว และเพื่อปกป้องความเป็นส่วนตัวของผู้ใช้ เราไม่สามารถตรวจสอบเรื่องนี้แบบเป็นโปรแกรมได้
ขั้นตอนถัดไป
หากคุณพร้อมที่จะเริ่มใช้งาน โปรดดูเอกสารเหล่านี้
ตั้งค่า
- ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา
- ลงทะเบียนทริกเกอร์การระบุแหล่งที่มา
- จัดลำดับความสำคัญให้กับการคลิก การดู หรือ Conversion ที่ต้องการ
- การแก้ไขข้อบกพร่องการรายงานการระบุแหล่งที่มา
- คีย์การรวม
ที่มา
- การรายงานการระบุแหล่งที่มาด้วยรายงานระดับเหตุการณ์
- การรายงานการระบุแหล่งที่มาด้วยรายงานที่รวบรวมได้
- ข้อจำกัดเกี่ยวกับข้อมูลการรายงานการรวม
- ทำความเข้าใจสัญญาณรบกวน
- การทำงานกับเสียงรบกวน
การสาธิตและเครื่องมือ
- การสาธิต Attribution Reporting API
- ห้องทดลองเสียงรบกวน
- โปรแกรมตรวจสอบส่วนหัวของการรายงานการระบุแหล่งที่มา
การวางแผน
ถ้าคุณยังอยู่ในขั้นตอนการวางแผน โปรดดูเอกสารเหล่านี้