Tài liệu này giải thích cách báo cáo số lần hiển thị và số lượt nhấp bằng API Epsilon Retail Media, với các bước tích hợp và cải thiện xác thực ID quảng cáo.
Để báo cáo hiệu quả số lần hiển thị và số lượt nhấp chuột, hãy sử dụng /resource/ điểm cuối. Số lần hiển thị nên được hướng đến first-i tài nguyên, trong khi số lần nhấp chuột nên được báo cáo đến second-c tài nguyên.
Điều kiện tiên quyết
Nhận URL cơ sở từ Người quản lý tài khoản kỹ thuật của bạn trước khi báo cáo số lượt hiển thị và số lượt nhấp.
Tích hợp các cuộc gọi điểm cuối
Các cuộc gọi điểm cuối phải được thực hiện trong ứng dụng hoặc trang web của bạn. Trong CitrusAD, quy trình tích hợp tương tự nhau đối với cả ứng dụng di động và trang web do phương pháp tích hợp 'backend đến backend'. Phương pháp tiếp cận này đảm bảo rằng các yêu cầu quảng cáo nhất quán trên cả nền tảng máy tính để bàn và thiết bị di động. Tuy nhiên, vì các ứng dụng di động không hỗ trợ thư viện JS, bạn phải gửi yêu cầu chương trình backend đến điểm cuối nhấp chuột và hiển thị của chúng tôi.
Báo cáo số lần hiển thị
Để báo cáo số lần hiển thị, hãy gửi yêu cầu NHẬN theo định dạng sau:
https://$BASE_URL.citrusad.com/v1/resource/first-i/AD_ID
Thay thế AD_ID với adId được cung cấp cho quảng cáo bạn đang báo cáo.
Ví dụ, yêu cầu NHẬN sau đây báo cáo một lần hiển thị cho adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
Báo cáo số lần nhấp chuột
Để báo cáo số lần nhấp chuột, hãy gửi một yêu cầu NHẬN theo định dạng bên dưới:
https://$BASE_URL.citrusad.com/v1/resource/second-c/AD_ID
Thay thế AD_ID với adId được cung cấp cho quảng cáo bạn đang báo cáo.
Ví dụ, yêu cầu NHẬN sau đây báo cáo một lần hiển thị cho adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
Xác thực API cho ID quảng cáo đã thực hiện
Tính năng này không được bật sẵn, vui lòng điều khiển bằng nút bật tắt tính năng. Tính năng này sẽ được triển khai đến cho tất cả mọi người vào ngày 30 tháng 3 năm 2025. Để sử dụng tính năng này sớm hơn, vui lòng liên hệ với đại diện CitrusAd của bạn.
API bao gồm xác thực cho ID quảng cáo để đảm bảo dữ liệu chính xác và giảm lỗi. Các yêu cầu có ID quảng cáo được mã hóa hoặc thêm tiền tố không đúng cách sẽ trả về lỗi 400 và thông báo lỗi chi tiết.
Lợi ích chính
- Giải quyết vấn đề nhanh hơn: Phản hồi nhanh giúp các nhà bán lẻ khắc phục sự cố nhanh hơn.
- Độ chính xác tốt hơn: Ít lỗi hơn đồng nghĩa với báo cáo và dữ liệu chính xác hơn.
Ví dụ về thông báo lỗi
"ID quảng cáo không hợp lệ. Phải được mã hóa đúng cách và có tiền tố 'display', 'banner', hoặc 'shotgun_'."