파트너 API

광고 캐싱

광고 생성 엔드포인트에서 반환된 광고는 adtype에 관계없이 절대적으로 필요한 경우를 제외하고는 캐시되지 않아야 합니다. 한 페이지가 소매업체의 웹사이트에 로드될 때마다 새로운 광고 세트를 생성하기 위해 올바른 컨텍스트를 사용하여 새 광고 생성 요청을 CitrusAd에 전송해야 합니다.

소매업체가 이를 지원할 수 없는 경우, CitrusAd는 소매업체가 여러 고객에게 반복하여 광고를 제공할 수 있는 캐싱 기능을 제공합니다.

🚧

유효한 클릭에 대한 CitrusAd의 기준을 충족하는 모든 노출 수와 클릭 수는 이에 맞춰 청구될 것입니다. 이러한 이유로 CitrusAd는 초과 지출 가능성을 줄이기 위해 캐싱 기간을 합리적인 시간(분) 이내로 최소화할 것을 권장합니다.

통합 요구 사항

sessionId 의 경우 광고가 여러 세션에 제공될 수 있으므로 더 이상 광고 요청에서 필요하지 않습니다.

광고를 캐싱하려는 모든 소매업체는 다음을 수행해야 합니다.

  • 옵션 섹션에서 “cached”: true 의 CitrusAd에 광고 요청의 새 매개 변수를 전송합니다.
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "options": {
                         "filterMode": "AndOr",
                         "cached": true
                             },
    "maxNumberOfAds": 3    
}
  • 주문 보고 시 sessionId 속성 방법과 통합합니다.
  • 노출 및 클릭 보고에 인코딩된 sessionId 를 전송합니다.
  • 노출 수 및 클릭 수 보고서에서 이벤트 타임 스탬프를 전송합니다. 이벤트 간 시간대는 일정해야 하지만, 사용하는 시간대는 소매업체가 선택합니다. ISO-8601 형식으로 포맷되어 있습니다.
https://integration.<ENV>.citrusad.com/v1/resource/second-c/<AD_ID>?sessionId=<SESSION_ID>&event_ts=20220127152500

일단 작동되면, CitrusAd 측면에서 관련 처리 작업을 진행할 것입니다. CitrusAd에서는 추가 구성을 요청하지 않습니다.

캐싱 작동 방법

캐시에 저장된 광고의 경우 '창'이라는 구성 가능한 속성이 있습니다. 이 창은 모든 광고 유형에 적용됩니다. 또한 CitrusAd에 의한 응답에서 이미 통과된 '만료일' 속성이 있습니다.
저희는 이러한 속성을 사용하여 노출 수와 및 클릭 수를 처리하는 방법을 판별합니다. 특정한 경우에, CitrusAd는 새로운 AdId를 생성하고 그에 따라 노출 수/클릭 수를 처리합니다. 이러한 방법으로 CitrusAd는 여러 고객 세션에서 속성이 완전히 기능하도록 보장합니다.

시나리오 1

"범위" 내 동일한 sessionId에 대한 모든 광고의 경우 동일한 adId로 취급됩니다.

2640

시나리오 2

다른 sessionId가 있는 광고의 경우 새 AdId를 생성하고 이를 새 노출 수/클릭 수로 처리합니다.

2606

시나리오 3

광고 만기 이외의 모든 노출 수/클릭 수는 기록되지만 청구되거나 보고되지 않습니다.

2612

시나리오 4

보고된 노출 수가 없는 범위에서 클릭 수가 발생하는 경우 CitrusAd는 클릭 수를 추정하며, 현재 시스템 전반에서 이러한 작업이 진행됩니다.

이는 범위를 늘리고 소매업체가 캐시를 줄임으로써 완화할 수 있습니다.

2650

각 시나리오는 여러 고객에게 광고가 제공되는 경우 제작 단계에서 독립적으로 발생하는 것으로 예상할 수 있습니다.

2670

🚧

초과 지출 위험

이 기능을 사용하면 소매업체가 CitrusAd에 광고를 요청할 필요 없이 여러 고객에게 여러 번 광고를 제공할 수 있습니다.

이 기능은 캠페인/지갑이 변경되는 방법에 대한 변경 사항을 구현하지 않았습니다. 광고가 캐싱되는 기간이 길어질수록, 현재 자금이 부족한 지갑이나 캠페인에 대한 광고를 제공할 가능성이 높아집니다.

CitrusAd는 지갑에 자금이 있을 때 제공되었던 광고와 관련하여 자금을 사용할 수 없는 캠페인/지갑에 대한 노출 수/클릭 수를 계속해서 처리하고 이에 대한 비용을 청구할 것입니다.

이러한 시나리오에서 초과 지출을 완화하는 방법은 세 가지가 있습니다.

  • 캐싱을 가능한 최소 기간(기본)으로 줄입니다.
    광고가 제공될 수 있는 기간이 길어질수록, 그 이후로 규모가 대폭 감소한 지갑/캠페인의 광고를 제공할 위험이 커집니다.

  • CitrusAd는 모든 광고의 "만기"를 줄입니다.
    CitrusAd는 광고를 제공한 후에 광고가 "유효"한 것으로 간주되는 기간을 줄일 수 있습니다. 이러한 만기 이후의 모든 노출 수/클릭 수는 무효화됩니다.

  • CitrusAd는 모든 광고의 "범위"를 확장합니다.
    더 큰 범위는 새로운 노출 수/클릭 수의 양을 감소시킵니다. 하지만 이는 보고된 노출 수/클릭 수를 줄입니다.