เอกสารนี้อธิบายวิธีการรายงานการแสดงผลและการคลิกโดยใช้ Epsilon Retail Media API พร้อมด้วยขั้นตอนสำหรับการบูรณาการและการตรวจสอบ ID โฆษณาที่ได้รับการปรับปรุง
หากต้องการให้รายงานการแสดงผลและการคลิกอย่างมีประสิทธิผล ให้ใช้เอนพอยต์ /resource/ การแสดงผลควรส่งไปที่ทรัพยากร first-i ในขณะที่การคลิกควรถูกรายงานไปที่ทรัพยากร second-c
ข้อกําหนดเบื้องต้น
รับ URL ฐานของคุณจากผู้จัดการบัญชีทางเทคนิคของคุณก่อนที่จะรายงานการแสดงผลและการคลิก
การรวมการโทรเอนพอยต์
การโทรไปยังเอนพอยต์จะต้องดำเนินการภายในแอปหรือเว็บไซต์ของคุณ ใน Epsilon Retail Media กระบวนการบูรณาการมีความคล้ายคลึงกันสำหรับทั้งแอปมือถือและเว็บไซต์เนื่องจากแนวทางการผสานรวม 'แบ็คเอนด์ไปยังแบ็คเอนด์' แนวทางนี้ช่วยให้แน่ใจว่าคำขอโฆษณาสอดคล้องกันทั้งบนเดสก์ท็อปและแพลตฟอร์มมือถือ อย่างไรก็ตาม เนื่องจากแอปมือถือไม่รองรับไลบรารี JS คุณต้องส่งคำขอแบ็กเอนด์ไปยังเอนพอยต์การคลิกและการแสดงผลของเรา
การรายงานการแสดงผล
หากต้องการรายงานการแสดงผล ให้ส่งคำขอ GET ในรูปแบบต่อไปนี้:
https://$BASE_URL.citrusad.com/v1/resource/first-i/AD_IDแทนที่ AD_ID ด้วย adId ที่ให้ไว้สำหรับโฆษณาที่คุณกำลังรายงาน
ตัวอย่างเช่นคำขอ GET ต่อไปนี้จะรายงานการแสดงผลสำหรับ adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdTการรายงานจํานวนคลิก
หากต้องการรายงานการคลิก ให้ส่งคำขอ GET ในรูปแบบด้านล่าง:
https://$BASE_URL.citrusad.com/v1/resource/second-c/AD_IDแทนที่ AD_ID ด้วย adId ที่ให้ไว้สำหรับโฆษณาที่คุณกำลังรายงาน
ตัวอย่างเช่นคำขอ GET ต่อไปนี้จะรายงานการแสดงผลสำหรับ adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdTการตรวจสอบ API สำหรับ ID โฆษณาที่รับรู้
API ตรวจสอบรหัสโฆษณาเพื่อให้แน่ใจว่าข้อมูลถูกต้องและลดข้อผิดพลาด คำขอที่มีรหัสโฆษณาที่เข้ารหัสหรือมีคำนำหน้าไม่ถูกต้อง จะส่งกลับข้อผิดพลาด 400 และข้อความที่แสดงข้อผิดพลาดโดยละเอียด
ประโยชน์หลัก
- การแก้ไขปัญหาที่รวดเร็วยิ่งขึ้น: ข้อเสนอแนะที่รวดเร็วช่วยให้ผู้ค้าปลีกแก้ไขปัญหาได้เร็วขึ้น
- ความแม่นยำที่ดีขึ้น: ข้อผิดพลาดน้อยลงหมายถึงรายงานและข้อมูลที่แม่นยำยิ่งขึ้น
ตัวอย่างข้อความแสดงข้อผิดพลาด
"Invalid ad ID. Must be properly encoded and prefixed with 'display_', 'banner_', or 'shotgun_'."

