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

คู่มือนี้จะให้ภาพรวมและวิธีการตั้งค่าสําหรับทั้งรายงานการระบุแหล่งที่มาระดับเหตุการณ์และรายงานการระบุแหล่งที่มาแบบสรุปโดยใช้ 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 ดูตัวอย่างเมธอด POST ได้ที่ adtech.js และดูข้อมูล .well-known ได้ที่ Wikipedia

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

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

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

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

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

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

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

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

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

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

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

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

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

การใช้งาน

พื้นหลังและแนวคิด

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

การวางแผน