파트너 API
API 참조

향후 날짜에 대한 광고 요청

CitrusAd campaignFilterDate 속성 사용 시 요청한 날짜에 실행 예정인 캠페인을 쿼리할 수 있습니다.

📘

이 기능은 배너 광고 통합에 가장 적합하며 특히 고객이 배송 슬롯 선택 시 배너에 가격 정보를 표시해야 하는 법적 요구 사항이 있는 경우 사용하면 가장 좋습니다.

이 기능은 무엇을 지원합니까?

CitrusAd 광고 요청에 campaignFilterDate 지정 시 CitrusAd는 지정된 날짜에 실행 예정인 캠페인 또는 CitrusAd 시스템에서 "항상 사용"으로 설정된 캠페인만 고려합니다.

광고주는 CitrusAd 시스템에서 캠페인이 특정 날짜 범위에서만 실행되도록 설정할 수 있습니다.

이 기능은 일반적으로 광고주가 특정 기간에 대해 캠페인을 예약하려는 경우 사용하며 예산이 충분한 경우 "항상 사용"을 선택하여 캠페인 지출을 설정할 수 있습니다.

예를 들어 위 캠페인은 2023년 7월 2일부터 2023년 3월 14일까지 활성화됩니다. 이 기간 내에 campaignFilterDate 를 포함한 관련 광고 요청이 수신되면 가장 관련성 높은 광고로 판단되는 캠페인이 실행됩니다.

통합 요구 사항

고급 단계 개요

CitrusAd와 표준 통합을 구축하는 것 외에도 광고 요청에 campaignFilterDate 를 지정하도록 통합을 향상시켜야 합니다. 노출 및 클릭 보고를 변경할 필요는 없으며 아래에 설명된 대로 주문 보고가 정확한지 확인해야 합니다.

광고 요청

광고 요청 시 ISO-8601 형식으로 campaignFilterDate를 지정해야 합니다. 예는 다음과 같습니다.

이 campaignFilterDate 는 고객이 귀하의 웹사이트에서 주문을 받는 날짜입니다.

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",
    "campaignFilterDate": "2022-11-20T13:40:00+01:00",
    "options": {
                         "filterMode": "AndOr",
                             },
    "maxNumberOfAds": 3    
}

주문 보고

주문 보고 시 다음 사항이 구현되었는지 확인해야 합니다.

  • 지정한 주문 날짜는 고객이 결제를 완료한 시간이어야 하며 고객의 주문이 수집/전송되는 시간이 아닙니다.
    • 이는 CitrusAd의 어트리뷰션 알고리즘이 고객의 상호 작용에 올바른 룩백 기간을 적용하여 고객에게 표시된 캠페인에 판매를 어트리뷰션할 수 있도록 하기 위한 것입니다.
  • 고객이 주문을 다시 제출할 가능성이 있으므로 CitrusAd에 주문 ID를 보내지 않도록 해야 합니다. 주문 및 주문 업데이트가 다시 제출될 시 CitrusAd 알고리즘은 주문 및 어트리뷰션을 적절하게 검토합니다.
    • 현재 CitrusAd 어트리뷰션 알고리즘은 이전에 제출된 주문 ID로 주문 제출 시 주문을 다시 처리하지 않습니다.

주문 보고에 대한 정확한 정보는 주문 데이터를 확인하십시오.

플랫폼 보고

CitrusAd 시스템은 실시간으로 보고를 표시하므로 향후 전송을 포함하여 사용자가 조회 또는 클릭 시 클릭 수 및 노출 수가 보고됩니다.

광고가 실시간으로 제공됨에 따라 CitrusAd에 노출과 클릭이 보고되면 지갑에 비용이 청구됩니다.

🚧

지출 보고

이 기능은 실행 예정인 캠페인을 쿼리하므로 지출 금액이 포함된 실행 예정 캠페인을 볼 수 있으며 데이터 보고가 누적됩니다. 이는 해당 기간 동안 활성화 예정인 캠페인이 사전 쿼리됨으로써 가능한 의도된 동작입니다.