เพื่อรายงานการแสดงผลและการคลิกอย่างมีประสิทธิภาพ ให้ใช้ /resource/ เอนพอยต์ การแสดงผลควรนำไปที่ first-i ทรัพยากรในขณะที่คลิกควรจะรายงานให้ทราบ second-c ทรัพยากร

ข้อกําหนดเบื้องต้น

รับ URL ฐานของคุณจากผู้จัดการบัญชีทางเทคนิคของคุณก่อนที่จะรายงานการแสดงผลและการคลิก

การรวมการโทรเอนพอยต์

การโทรไปยังเอนพอยต์จะต้องดำเนินการภายในแอปหรือเว็บไซต์ของคุณ ใน CitrusAd กระบวนการบูรณาการคล้ายคลึงกันสำหรับทั้งแอปมือถือและเว็บไซต์เนื่องจากแนวทางบูรณาการแบบ "แบ็กเอนด์กับแบ็กเอนด์" แนวทางนี้ช่วยให้แน่ใจว่าคำขอโฆษณาสอดคล้องกันทั้งบนเดสก์ท็อปและแพลตฟอร์มมือถือ อย่างไรก็ตาม เนื่องจากแอปมือถือไม่รองรับไลบรารี 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 โฆษณาที่รับรู้

📘

คุณลักษณะนี้ไม่ได้เปิดอยู่ตามค่าเริ่มต้น และควบคุมโดยการสลับคุณลักษณะ ทุกคนจะพร้อมใช้งานภายในวันที่ 30 มีนาคม 2025 หากต้องการใช้งานเร็วขึ้น โปรดติดต่อตัวแทน CitrusAd ของคุณ

API ตรวจสอบรหัสโฆษณาเพื่อให้แน่ใจว่าข้อมูลถูกต้องและลดข้อผิดพลาด คำขอที่มีรหัสโฆษณาที่เข้ารหัสหรือมีคำนำหน้าไม่ถูกต้อง จะส่งกลับข้อผิดพลาด 400 และข้อความที่แสดงข้อผิดพลาดโดยละเอียด

ประโยชน์หลัก

• การแก้ไขปัญหาที่รวดเร็วยิ่งขึ้น: ข้อเสนอแนะที่รวดเร็วช่วยให้ผู้ค้าปลีกแก้ไขปัญหาได้เร็วขึ้น
• ความแม่นยำที่ดีขึ้น: ข้อผิดพลาดน้อยลงหมายถึงรายงานและข้อมูลที่แม่นยำยิ่งขึ้น

ตัวอย่างข้อความแสดงข้อผิดพลาด

"รหัสโฆษณาไม่ถูกต้อง ต้องเข้ารหัสอย่างถูกต้องและนำหน้าด้วย 'display', 'banner', หรือ 'shotgun_'."