노출 및 클릭 수를 효과적으로 보고하려면 /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

실현된 광고 ID에 대한 API 검증

📘

이 기능은 기본적으로 켜져 있지 않으며 기능 토글로 제어할 수 있습니다. 2025년 3월 30일까지 모든 사용자에게 제공될 예정입니다. 더 빨리 사용하려면 CitrusAd 담당자에게 문의하세요.

API에는 정확한 데이터를 보장하고 오류를 줄이기 위해 광고 ID에 대한 유효성 검사가 포함되어 있습니다. 부적절하게 인코딩되었거나 접두사가 포함된 광고 ID가 있는 요청은 400 오류와 자세한 오류 메시지를 반환합니다.

주요 이점

• 더 빠른 문제 해결: 빠른 피드백을 통해 소매업체는 문제를 더 빨리 해결할 수 있습니다.
• 더 높은 정확성: 오류가 적으면 보고서와 데이터가 더 정확해집니다.

오류 메시지 예시

"잘못된 광고 ID입니다. 올바르게 인코딩되어야 하며 접두사에 'display', 'banner' 또는 'shotgun_'이 포함되어야 합니다."