파트너 API

카탈로그 및 제품

CitrusAd와 통합하려면 최소한 하나 이상의 제품 카탈로그가 필요합니다.

카탈로그가 무엇인가요?

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

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

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

📘

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

🚧

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

제품은 무엇인가요?

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

제품은 캠페인 생성 시 광고주에 의해 선택되며, 오직 광고주가 선택한 카탈로그와 연관된 제품만 선택을 위해 표시됩니다. 제품은 단일 제품 GTIN 이상의 요소를 나타내는 데 사용될 수 없습니다. 동일한 제품의 변형 모델은 다른 제품으로 나열되어야 합니다(예: 동일한 음료 제품의 200ml, 600ml, 및 2L 변형 모델은 기존의 통합자 모범 사례에 맞게 정렬되어, CitrusAd에서 서로 다른 3가지 제품으로 간주됩니다.

제품 필터 설명됨

제품 필터는 imageUrl 및 이름과 같은 속성을 포함하는 것 외에도 광고 생성에 주로 사용됩니다. CitrusAd에서 광고 요청 시 귀하는 각 페이지에 관련 광고가 제공되도록 관련 페이지 정보가 포함된 컨텍스트를 보내게 됩니다.

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

아래에 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 보다 쉽게 이해할 수 있습니다.

이미지와 제품 이름 제공

CitrusAd는 CitrusAd 포털에서 캠페인을 생성할 때 검색이 가능하도록 제품 이미지와 이름에 대한 정보를 요구합니다. 이러한 값은 다음 예시와 같이 형식이 있는 CitrusAd 내부 태그에 전송할 수 있습니다.

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"
            ]
        }
    ]
}

이들은 아래 예와 같이 제품 선택을 포함한 CitrusAd 포털의 다양한 영역에서 볼 수 있습니다.

1581

참조 이미지