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