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

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

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

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

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

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

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

รายงานสรุป

รายงานสรุปคือประเภทรายงาน Attribution Reporting API และ Private Aggregation API รายงานสรุปจะมีข้อมูลผู้ใช้ที่รวบรวมไว้ และอาจมีข้อมูล 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 ถูกใช้งาน ไม่มีวิธีตรวจสอบเรื่องนี้แบบเป็นโปรแกรมเพ��่อปกป้องความเป็นส่วนตัวของผู้ใช้

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

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

ตั้งค่า

ที่มา

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

การวางแผน

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