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

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

ก่อนอื่น คุณจะได้เรียนรู้วิธีการต่อไปนี้

  • แยกความแตกต่างระหว่างประเภทรายงาน Attribution Reporting API

  • ทําตามขั้นตอนการติดตั้งใช้งาน API และการสร้างรายงานให้เสร็จสมบูรณ์

  • ค้นหาข้อมูลอ้างอิงและการแก้ปัญหา

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

Attribution Reporting API มีรายงาน 2 ประเภทที่แตกต่างกันเพื่อให้วัดประสิทธิภาพแคมเปญโฆษณาได้อย่างมีประสิทธิภาพโดยมีรายละเอียดและความเป็นส่วนตัวในระดับต่างๆ ดังนี้

  • รายงานระดับเหตุการณ์: ให้ข้อมูลแบบละเอียดที่เชื่อมโยงการคลิกหรือการดูโฆษณาที่เฉพาะเจาะจง (แหล่งที่มา) กับข้อมูล Conversion ที่เกี่ยวข้อง (ทริกเกอร์) รายงานระดับเหตุการณ์จะจํากัดปริมาณข้อมูล Conversion และเพิ่มสัญญาณรบกวนในรายงาน เหมาะสําหรับกรณีการใช้งานที่การระบุแหล่งที่มาของเหตุการณ์แต่ละรายการเป็นสิ่งสําคัญ เช่น การวัดการเข้าถึงของแคมเปญ

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

ภาพรวมการใช้งาน

ส่วนต่อไปนี้จะอธิบายขั้นตอนระดับสูงในการสร้างรายงานแต่ละประเภท นอกจากนี้ คุณยังทำตามเดโม Attribution Reporting API เพื่อดูคำแนะนำแบบทีละขั้นของกระบวนการทั้งหมดได้ด้วย

ข้อกำหนดเบื้องต้น: เว็บไซต์ต้องมีใบรับรอง SSL/TLS (HTTPS) ก่อนจึงจะลงทะเบียนแหล่งที่มา ทริกเกอร์ และรับรายงานได้

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

ขั้นตอนต่อไปนี้จะอธิบายวิธีสร้างรายงานระดับเหตุการณ์

  1. ลงทะเบียนแหล่งที่มา: เชื่อมโยงการคลิกหรือการดูโฆษณากับข้อมูลการระบุแหล่งที่มา ดูวิธีการโดยละเอียดได้ที่ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาและการลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา โปรดทราบว่ากระบวนการลงทะเบียนสำหรับการคลิกและการดูจะแตกต่างกันเล็กน้อย

  2. ลงทะเบียนทริกเกอร์: บันทึกเหตุการณ์ Conversion และลิงก์กับแหล่งที่มาที่ลงทะเบียนไว้ก่อนหน้านี้ ดูวิธีการได้ที่ลงทะเบียนทริกเกอร์การระบุแหล่งที่มา

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

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

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

  1. ลงทะเบียนแหล่งที่มา: เหมือนกับรายงานระดับเหตุการณ์ ดูรายละเอียดได้ที่ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาและการลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา

  2. ลงทะเบียนทริกเกอร์: เหมือนกับรายงานระดับเหตุการณ์ ดูลงทะเบียนทริกเกอร์การระบุแหล่งที่มา

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

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

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

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

ตั้งค่าตัวกรอง (ไม่บังคับ)

หากต้องการควบคุมข้อมูลการระบุแหล่งที่มาที่คุณได้รับอย่างละเอียดยิ่งขึ้น คุณสามารถตั้งค่าตัวกรองได้

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

หากต้องการตั้งค่าการกรอง โปรดดูกําหนดกฎที่กําหนดเองโดยใช้ตัวกรองและส่วนทริกเกอร์ของการลงทะเบียนทริกเกอร์การระบุแหล่งที่มาเพื่อดูรายละเอียดเฉพาะสําหรับรายงานที่รวบรวมได้

ยืนยันว่าได้เปิดใช้ API แล้ว

ก่อนใช้ API ให้ตรวจสอบว่าได้เปิดใช้ API แล้วหรือไม่โดยใช้โค้ดต่อไปนี้

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

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

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

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

การใช้งาน

ความเป็นมาและแนวคิด

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

การวางแผน