파트너 API
API 참조

카탈로그 및 제품

Epsilon Retail Media와 통합하려면 하나 이상의 제품 카탈로그가 필요합니다.

카탈로그가 무엇인가요?

카탈로그는 제품과 제품의 속성을 그룹화한 것으로, 일반적으로 통합자 사이트의 모든 제품을 하나의 단일 카탈로그로 그룹화하는 데 사용됩니다.

카탈로그는 캠페인 생성 프로세스에서 광고주에 의해 선택되며 캠페인은 선택된 제품의 카탈로그 내에서만 실행됩니다. 모든 제품을 통합자를 위해 단일 카탈로그로 그룹화하여 광고주 선택을 단순하게 만드는 것이 일반적인 사례입니다.

여러 카탈로그를 생성하면 캠페인 표적화 목적을 위해 다른 소매업체나 국가의 제품 가용성을 세그먼트화할 수 있습니다.

📘

여러 카탈로그를 생성하려는 경우, 표적화를 구현하는 더 나은 방법이 존재할 수 있으므로 기술 계정 관리자에게 문의하여 모범 사례에 대해 논의하십시오.

🚧

네트워크 네임스페이스에 통합하는 경우 단일 카탈로그를 생성해야 합니다.

제품은 무엇인가요?

제품은 통합자의 사이트에 있는 개별 GTIN입니다. Epsilon Retail Media와 동기화된 제품은 각각의 고유 식별 값 및 속성이 함께 동기화됩니다. 제품은 현재 제품 카탈로그에 있는 각 GTIN/SKU를 표시해야 합니다.

제품은 광고주가 캠페인 생성 시 선택되며 광고주가 선택한 카탈로그와 관련된 제품만 선택할 수 있도록 표시됩니다. 제품은 하나의 제품 GTIN만을 나타내는 데 사용되어야 합니다. 동일한 제품의 변형은 각각 다른 제품으로 등록되어야 합니다. 예를 들어 같은 음료 제품의 200ml, 600ml, 2L 용량 변형은 기존 통합자 모범 사례와 같이 Epsilon Retail Media에서 세 개의 서로 다른 제품으로 간주됩니다.

제품 필터 설명됨

제품 필터는 imageUrl 및 이름과 같은 속성을 포함합니다. Epsilon Retail Media에 광고 요청 시 귀하는 각 페이지에 관련 광고가 제공되도록 관련 페이지 정보가 포함된 컨텍스트를 보내게 됩니다.

필터의 구조는 통합자가 결정하지만 이러한 제품 필터가 광고 생성 컨텍스트에서 전송되는 것을 가장 우선적으로 고려해야 합니다. 제품 필터는 광고 생성에서 요청되는 것과 정확히 일치해야 합니다.

아래에 productFilters 를 포함하는 컨텍스트가 설명되어 있습니다.

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
}

이 컨텍스트는 관련 배열에 있는 모든 필터를 포함하는 제품에 대한 광고만 반환합니다.

📘

카테고리의 최소 입찰 값을 활용하려면 카테고리가 사용자에게 친숙하고 캠페인을 생성하는 광고주가 쉽게 이해할 수 있어야 합니다. 예를 들어 카테고리:키보드는 카테고리:12 보다 쉽게 이해할 수 있습니다.

이미지와 제품 이름 제공

Epsilon Retail Media는 Epsilon Retail Media 포털에서 캠페인 생성 시 검색이 가능하도록 제품 이미지와 이름에 대한 정보를 필요로 합니다. 이러한 값은 다음 예시와 같은 형식의 태그를 통해 Epsilon Retail Media로 전송할 수 있습니다.

POST $BASE_URL/v1/catalog-products?teamId=<YOUR_TEAM_ID> HTTP/1.1 
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogProducts": [
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965543",
            "inventory": 50,
            "price": "19.99",
            "tags": [
                 ""imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
            ],
            "filters": [
                 "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"
            ]
        }
    ]
}

이러한 값은 아래 예시와 같이 제품 선택을 포함한 Epsilon Retail Media 포털의 다양한 영역에서 확인할 수 있습니다:

1581

참조 이미지