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