เริ่มต้นใช้งานการรายงานการระบุแหล่งที่มา

คุณสามารถเริ่มต้นจากตรงนี้ ซึ่งประกอบด้วยการตั้งค่าและภาพรวมคร่าวๆ

เลือกประเภทรายงาน

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

คุณสามารถตั้งค่าการรายงานสําหรับทั้งรายงานระดับเหตุการณ์และรายงานสรุปได้ ซึ่งเป็นส่วนเสริม

รายงานระดับเหตุการณ์

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

รายงานสรุป

ประเภทรายงาน Attribution Reporting API และ Private Aggregation API รายงานสรุปจะรวมข้อมูลผู้ใช้แบบรวม และอาจมีข้อมูล Conversion โดยละเอียดที่มีการเพิ่มสัญญาณรบกวน รายงานสรุปประกอบด้วยรายงานสรุป รายงานเหล่านี้มีความยืดหยุ่นมากขึ้นและมีโมเดลข้อมูลที่สมบูรณ์กว่าการรายงานระดับเหตุการณ์ โดยเฉพาะสําหรับกรณีการใช้งานบางรายการ เช่น มูลค่า Conversion

การใช้งาน

คุณเริ่มต้นใช้งานได้โดยลองทำตามขั้นตอนต่อไปนี้

โปรดทราบว่าสำหรับแหล่งที่มาของเหตุการณ์หนึ่งๆ จะสามารถสร้างทั้ง ระดับเหตุการณ์และรายงานที่รวบรวมได้ สาธิตจะแนะนำขั้นตอนการดำเนินการ

การสร้างรายงานระดับเหตุการณ์

ขั้นตอนขั้นต่ำที่ต้องปฏิบัติตามเพื่อสร้างรายงานระดับเหตุการณ์มีดังนี้

  1. ลงทะเบียนแหล่งที่มา โปรดดูวิธีการที่หัวข้อลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา โปรดทราบว่าขั้นตอนสำหรับคลิกและการดูนั้นแตกต่างกัน

  2. ลงทะเบียนทริกเกอร์ โปรดดูวิธีการที่หัวข้อลงทะเบียนทริกเกอร์การระบุแหล่งที่มา

  3. ตั้งค่าปลายทางด้วย URL ต่อไปนี้
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    ดูโค้ดตัวอย่างใน adtech.js เพื่อดูเมธอด POST และ Wikipedia สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ .well-known

ดูรายละเอียดเพิ่มเติมได้ในคำอธิบายรายงานระดับเหตุการณ์

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

หากต้องการสร้างรายงานสรุป ให้ทำตามขั้นตอนระดับสูงต่อไปนี้

  1. ลงทะเบียนแหล่งที่มา โปรดดูวิธีการที่หัวข้อลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา โปรดทราบว่าขั้นตอนสำหรับคลิกและการดูนั้นแตกต่างกัน ดูรายละเอียดเพิ่มเติมได้ในการลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา

  2. ลงทะเบียนทริกเกอร์ โปรดดูวิธีการที่หัวข้อลงทะเบียนทริกเกอร์การระบุแหล่งที่มา

  3. ตั้งค่าปลายทางสำหรับรายงานที่รวบรวมได้ด้วย URL ต่อไปนี้
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    ดูโค้ดตัวอย่างใน adtech.js เพื่อดูเมธอด POST และ Wikipedia สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ .well-known

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

ดูรายละเอียดเพิ่มเติมได้ในคำอธิบายรายงานที่รวบรวมได้

ดูวิธีตั้งค่ารายงานการแก้ไขข้อบกพร่องในชุดการแก้ไขข้อบกพร่องในการรายงานการระบุแหล่งที่มา

แนวคิดเพิ่มเติมของรายงานสรุป

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

ขั้นตอนที่ไม่บังคับ

  1. ตั้งค่าตัวกรอง (ไม่บังคับ):
    1. ทำตามวิธีการใน ระบุกฎที่กำหนดเองโดยใช้ตัวกรอง
    2. ตรวจสอบรายละเอียดเฉพาะของตัวกรองสำหรับรายงานที่รวบรวมได้ใน ของส่วนทริกเกอร์ คำอธิบาย

อย่าลืมการตรวจจับฟีเจอร์

ก่อนใช้ API ให้ตรวจสอบว่า API ไม่ได้ถูกบล็อกในหน้าเว็บโดยใช้นโยบายสิทธิ์หรือไม่ หากต้องการดำเนินการดังกล่าว ให้เรียกใช้โค้ดต่อไปนี้:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

หากการตรวจสอบฟีเจอร์นี้แสดงผลเป็น "จริง" API จะได้รับอนุญาตในบริบท (หน้า) ที่เรียกใช้การตรวจสอบ

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

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

หากคุณพร้อมที่จะเริ่มต้นการใช้งานแล้ว โปรดอ่านเอกสารเหล่านี้

ตั้งค่า

ข้อมูลเบื้องต้น

การสาธิตและเครื่องมือ

การวางแผน

หากคุณยังอยู่ในขั้นตอนการวางแผน โปรดดูเอกสารต่อไปนี้