파트너 API

페이지 매김

여러 페이지 탐색 시 고객 경험을 개선합니다. 제품 광고 생성 시 이전에 게재된 광고를 제외하기 위한 후속 요청에서 보낸 memoryToken 를 받게 됩니다.

🚧

제품 광고만 가능!

이 기능은 현재 CitrusAd의 제품 광고에만 지원됩니다.

사이트에 페이지 매김을 설정하는 방법은 무엇입니까?

제품 광고 생성 시 고객 반응에 다음이 제공됩니다: memoryToken.

{
    "ads": [
        {
            "id": "display_3rGiryPskhQusmsf43nghbQwnqo3NzMzNjU3",
            "gtin": "7733657",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400917769Z",
            "position": 1
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

고객이 다음 페이지로 이동할 때 귀하는 다음 광고 요청 시 이 토큰을 보내야 합니다.

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9", 
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0=",
    "options": {
                         "filterMode": "AndOr"
                             },
    "maxNumberOfAds": 3    
}

CitrusAd는 이 토큰을 사용하여 sessionId가 토큰의 요청과 동일한 경우 이전에 고객에게 제공된 모든 광고를 제외합니다.

🚧

표준 통합!

이 기능은 현재 CitrusAd의 제품 광고에만 지원됩니다.

어떻게 작동합니까?

광고 요청 시 CitrusAd가 memoryToken 을 수신하면 sessionId에 대해 이전에 실행된 모든 광고가 광고 반응에서 제외됩니다. 이를 통해 고객이 여러 페이지를 탐색하는 동안 더 다양한 광고가 실행될 수 있습니다.

요청에 토큰이 없는 경우 광고는 제외 적용 없이 현재 프로세스에 따라 생성됩니다. 광고 생성 후에는 소매업체가 사용 여부를 선택할 수 있도록 항상 토큰이 제공됩니다.

메모리 토큰에는 CitrusAd가 이전에 실행된 광고를 결정할 수 있도록 인코딩된 정보가 포함되어 있습니다(단일 요청 또는 여러 연결 요청 기간 동안).

관련 없는 토큰이 CitrusAd로 전송되는 경우(예: 다른 컨텍스트) 광고 요청에 토큰이 제공되지 않은 것처럼 광고가 조정됩니다.

⚠

귀하는 귀하의 웹사이트에서 실행되는 광고보다 더 많은 광고를 요청합니까?

귀하가 고객에게 제공되는 것보다 더 많은 광고를 CitrusAd에 요청하는 소매업체인 경우 후속 페이지에서 많은 광고를 수신하지 못할 수 있습니다. 15개의 광고를 요청하고 4개의 광고만 고객에게 제공하는 경우 memoryTokenCitrusAd는 수신 시 후속 광고 반응에서 이전에 실행된 15-20개의 광고를 모두 제외합니다.

요청 절차 예시

자주 묻는 질문

여러 고객 검색에서 이 토큰을 사용하여 더 큰 고객 여정에서 제품을 제외할 수 있습니까?

아니요, CitrusAd가 토큰의 광고 요청과 일치하지 않는 광고 요청을 받는 경우 이 요청은 무시되며 토큰이 제공되지 않은 것처럼 광고가 생성됩니다.

memoryToken 전송 시 형식이 잘못된 경우 어떻게 합니까?

CitrusAd는 토큰을 무시하고 정상적인 요청으로 처리합니다.

페이지 매김은 몇 페이지까지 설정할 수 있습니까?

기본값은 5페이지이며 이는 CitrusAd가 다수의 클라이언트에서 확인한 성능 및 채도가 가장 균형을 이룬 최상의 값입니다.

CitrusAd 릴리스 39.0부터는 기술 계정 관리자를 통해 이를 구성할 수 있습니다.

기본 구성에서 페이지 5-10과 같이 실행할 광고가 없을 시에는 어떻게 됩니까?

memoryToken은 구성의 페이지 수에 따른 광고를 저장하도록 CitrusAd 측에서 구성됩니다. 예를 들어 구성이 기본값인 5페이지인 경우 CitrusAd는 7페이지부터 광고를 다시 실행하기 시작합니다.

페이지 매김 요청 6(페이지 6): : memoryToken에는 이전 5페이지의 광고에 대한 정보가 포함되어 있으므로 이전 5페이지의 광고가 실행되지 않습니다.

페이지 매김 요청 7(페이지7): 1페이지의 광고가 실행될 수 있습니다.

기본 구성에서 5페이지 이전에 광고가 소진된 경우 어떻게 됩니까?

예를 들어 3페이지에서 광고가 소진된 경우 CitrusAd는 7페이지부터 다시 광고 실행을 시작합니다. 이는 구성의 총 페이지 수를 이전에 실행된 광고 중 다시 실행되서는 안되는 광고로 저장하기 때문입니다.