파트너 API
가이드

광고 타겟팅 최적화

이 문서에서는 검색, 카테고리 및 광범위한 디스플레이(홈, 결제, 스페셜 등) 게재 위치에서 제품 광고를 생성하는 모범 사례를 간략하게 설명합니다. 이러한 전략을 구현하면 광고의 관련성과 타기팅이 향상되어 사용자 참여도와 만족도가 높아집니다. 향상된 기능에는 페이지 매김, 필터링 검색 및 개인화된 광고 접근을 위한 위치 기반 필터링이 포함됩니다.

검색 및 카테고리 게재 위치를 사용하여 제품 광고를 생성하려면 다음 주제를 참조하세요:

페이지 매김 요청

페이지 매김은 대규모 데이터 세트를 개별 페이지 또는 세그먼트로 나누어 관리하는 데 사용되는 기술로 제품 광고 생성 시 페이지 매김을 통해 사용자에게 한 번에 너무 많은 광고가 표시되지 않고 이전에 본 광고가 중복 실행되지 않도록 할 수 있습니다.

제품 광고를 생성할 때 응답에는 다음이 포함됩니다: memoryToken. 이 토큰은 어떤 광고가 이미 실행되었는지 추적하는 데 도움이 됩니다. 다음을 포함하면: memoryToken 후속 광고 요청에서 이전에 게재된 광고가 새 광고 응답에서 제외되어 새롭고 관련성 높은 광고를 표시함으로써 사용자 경험을 개선할 수 있습니다.

  • 초기 요청: 제품 광고를 생성하고 응답으로 memoryToken 를 받습니다.
  • 후속 요청: memoryToken 을(를) 후속 광고 요청에 추가하여 이전에 게재된 광고를 응답에서 제외할 수 있습니다.

자세한 내용은 페이지 매김을 참조하세요.

요청 매개 변수

요청 본문은 다음 필드를 포함하는 JSON 객체여야 합니다:

개체유형설명
customerId문자열, 필수 항목고객의 고유 식별자로 소매업체에서 제공합니다.
sessionId문자열, 필수 항목세션의 고유 식별자로 어트리뷰션에 필요하며 소매업체에서 제공합니다.
게재위치문자열, 필수 항목광고가 표시되는 컨텍스트입니다(예: '검색').
카탈로그 ID문자열, 필수 항목제품 광고가 필터링되는 제품 광고 카탈로그의 고유 식별자로 Epsilon의 소매 미디어 UI 또는 소매업체에서 CatalogID를 확인할 수 있습니다.
maxNumberOfAds정수, 필수 항목표시할 광고의 최대 수입니다.
검색어문자열, 검색 게재 위치에 필수 항목카탈로그 내에서 검색할 단어입니다.
memoryToken문자열, 필수 항목이전에 실행된 광고를 제외하기 위한 토큰입니다.
옵션개체, 선택 사항필터링 모드 AndOr과 같은 추가 옵션으로 지정 시 시스템에서 "및"과 "또는" 조건을 모두 사용하여 검색 결과의 범위를 좁힙니다.

요청 예시

다음 예시의 초기 광고 요청은 "초콜릿"이라는 단어로 검색 게재 위치를 요청한 경우입니다. . memoryToken 가 포함되어 동일한 검색어 및 컨텍스트에 대해 이전에 게재된 광고가 응답에서 제외되도록 합니다 . options 개체는 필터링 모드를 지정하며 maxNumberOfAds 은(는) 응답에서 생성될 광고 수에 대한 제한을 설정합니다.

페이지 매김과 메모리 토큰을 활용하면 광고의 중복을 피하고 관련성을 높여 사용자에게 보다 동적이고 매력적인 광고 경험을 제공할 수 있습니다.

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    
}

응답 예시

모든 제품 광고 응답은 표준 JSON 형식을 따릅니다. 제품 광고는 광고 배열로 반환됩니다.

  • id: 노출 수 및 클릭 수 보고에 사용되는 광고 ID입니다.
  • gtin: 제품 광고의 글로벌 거래 제품 번호입니다.
  • discount: 광고에 적용되는 모든 할인에 대한 세부 정보입니다.
    • amount: 할인 금액입니다.
    • minPrice: 할인된 최저가입니다.
    • maxPerCustomer: 고객이 할인 가격으로 구매할 수 있는 최대 품목 수입니다.
  • expiry: 광고의 만료 날짜 및 시간입니다.
  • position: 응답 페이로드에서 광고의 위치입니다. 고정 테넌트 게재 위치가 올바르게 표시되도록 항상 위치 필드를 확인하고 준수해야 합니다.
{
    "ads": [
        {
            "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        },
        {
            "id": "display_xNeShqidaMuEqiJ0zNdt-Gzygjs3NzE0MTA3",
            "gtin": "7714107",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400912929Z",
            "position": 3
        },
        {
            "id": "display_3rGiryPskhQusmsf43nghbQwnqo3NzMzNjU3",
            "gtin": "7733657",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400917769Z",
            "position": 4
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

마켓플레이스 판매자를 온보딩할 때 광고 응답에 sellerId 필드가 추가로 표시될 수 있습니다. 이 필드는 캠페인의 소유 팀이 Epsilon Retail Media UI에서 판매자 ID를 구성한 경우에만 포함됩니다.

판매자 ID가 있는 예

{
    "ads": [
        {
            "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "sellerId": "2834-ascre-2wcr4",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

필터링된 검색

고객이 검색에 필터를 적용하는 경우 다음을 사용하여 쿼리의 컨텍스트를 향상시킬 수 있습니다: productFilters. 이를 통해 특정 카테고리 또는 속성에 따라 광고를 보다 정확하게 타게팅할 수 있습니다. 아래는 "찬장" 카테고리와 식이 제한 중 하나인 "글루텐 프리"로 필터링하는 것을 보여주는 예시로 모든 카테고리 또는 광범위한 일치 게재 위치에 적용할 수 있습니다.

요청 매개 변수

요청 본문은 다음 필드를 포함하는 JSON 객체여야 합니다:

개체유형설명
customerId문자열, 필수 항목고객의 고유 식별자로 소매업체에서 제공합니다.
sessionId문자열, 필수 항목세션의 고유 식별자로 어트리뷰션에 필요하며 소매업체에서 제공합니다.
게재위치문자열, 필수 항목광고가 표시되는 컨텍스트입니다(예: '검색').
카탈로그 ID문자열, 필수 항목제품 광고가 필터링되는 제품 광고 카탈로그의 고유 식별자로 Epsilon의 소매 미디어 UI 또는 소매업체에서 CatalogID를 확인할 수 있습니다.
maxNumberOfAds정수, 필수 항목표시할 광고의 최대 수입니다.
검색어문자열, 검색 게재 위치에 필수 항목카탈로그 내에서 검색할 단어입니다.
productFilters배열, 필수카테고리 필터가 포함된 배열입니다.
옵션개체, 선택 사항필터링 모드 AndOr과 같은 추가 옵션으로 지정 시 시스템에서 "및"과 "또는" 조건을 모두 사용하여 검색 결과의 범위를 좁힙니다.

요청 예시

예시의 요청은 HTTP POST 방법을 사용하여 지정된 엔드포인트로 JSON 개체를 전송합니다 . productFilters 배열은 카테고리 "찬장" 및 식이 제한 "글루텐 프리"로 검색을 필터링하도록 지정합니다. options 개체는 filterMode 설정하여 AndOr필터를 유연하게 조합할 수 있도록 합니다 . maxNumberOfAds 필드는 표시되는 광고의 수를 3개로 제한합니다.

이 구조에 따라 고객의 검색 기준과 더 관련성이 높은 타깃 광고 캠페인을 생성하여 전반적인 사용자 경험을 향상할 수 있습니다.

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",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

위치별 필터링

카탈로그에서 위치 필터를 동기화하는 경우 다음에서 고객의 스토어 위치를 포함하도록 컨텍스트를 확장할 수 있습니다: productFilters. 이 기능을 사용하면 특정 스토어 위치를 기반으로 광고를 타겟팅하여 고객에게 표시되는 광고의 관련성을 높일 수 있습니다.

요청 매개 변수

요청 본문은 다음 필드를 포함하는 JSON 객체여야 합니다:

개체유형설명
customerId문자열, 필수 항목고객의 고유 식별자로 소매업체에서 제공합니다.
sessionId문자열, 필수 항목세션의 고유 식별자로 어트리뷰션에 필요하며 소매업체에서 제공합니다.
게재위치문자열, 필수 항목광고가 표시되는 컨텍스트입니다(예: '검색').
카탈로그 ID문자열, 필수 항목제품 광고가 필터링되는 제품 광고 카탈로그의 고유 식별자로 Epsilon의 소매 미디어 UI 또는 소매업체에서 CatalogID를 확인할 수 있습니다.
maxNumberOfAds정수, 필수 항목표시할 광고의 최대 수입니다.
검색어문자열, 검색 게재 위치에 필수 항목카탈로그 내에서 검색할 단어입니다.
productFilters배열, 필수카테고리 필터가 포함된 배열입니다.
옵션개체, 선택 사항필터링 모드 AndOr과 같은 추가 옵션으로 지정 시 시스템에서 "및"과 "또는" 조건을 모두 사용하여 검색 결과의 범위를 좁힙니다.

요청 예시

예시의 요청은 HTTP POST 방법을 사용하여 지정된 엔드포인트로 JSON 개체를 전송합니다.

  • 다음 productFilters 배열은 검색이 다음을 기준으로 필터링되도록 지정합니다:
    • 카테고리: "찬장"
    • 식이 제한: "글루텐 프리"
    • 위치: "Westenbury"
  • options 개체는 filterMode 설정하여 AndOr필터를 유연하게 조합할 수 있도록 합니다.
  • 다음 maxNumberOfAds 필드는 표시되는 광고의 수를 3개로 제한합니다.

이 구조에 따라 고객의 검색 기준과 더 관련성이 높은 타깃 광고 캠페인을 생성하여 전반적인 사용자 경험을 향상할 수 있습니다.

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",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

업데이트됨 6개월 전