> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ko/data-api/catalog-products-2.md).

# 카탈로그 및 상품

다음과 연동하려면 Epsilon Retail Media, 하나 이상의 상품 카탈로그가 필요합니다.

## 카탈로그란 무엇인가요?

카탈로그는 상품과 해당 속성을 그룹화한 것으로, 연동 업체의 사이트에 있는 모든 상품을 하나의 카탈로그로 그룹화하는 데 가장 일반적으로 사용됩니다.

카탈로그는 캠페인 생성 프로세스에서 광고주가 선택하며, 광고주의 캠페인은 선택한 상품 카탈로그 내에서만 게재됩니다. 연동 업체의 모든 상품을 단일 카탈로그로 그룹화하여 광고주가 쉽게 선택할 수 있도록 하는 것이 일반적인 관례입니다.

여러 카탈로그를 생성하면 캠페인 타겟팅 목적으로 다양한 리테일러 또는 국가의 상품 노출 가능 여부를 세분화하는 데 사용할 수 있습니다.

{% hint style="info" %}
여러 카탈로그를 생성하려면 타겟팅을 구현하는 더 나은 지원 방법이 있을 수 있으므로 담당 기술 계정 관리자(Technical Account Manager)에게 문의하여 모범 사례를 논의하세요.
{% endhint %}

{% hint style="warning" %}
네트워크 네임스페이스로 연동하는 경우 단일 카탈로그를 생성해야 합니다.
{% endhint %}

## 상품이란 무엇인가요?

상품은 연동 업체 사이트에 있는 개별 GTIN입니다. 다음 및 동기화된 상품은 Epsilon Retail Media 개별 식별 값 및 속성과 동기화됩니다. 상품은 현재 상품 카탈로그의 각 GTIN/SKU를 나타내야 합니다.

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

## 상품 필터 설명

상품 필터는 다음과 같은 속성을 포함하는 것 외에 주로 광고 생성에 사용됩니다. `imageUrl` 및 이름. 광고를 요청할 때 Epsilon Retail Media, 관련 페이지 정보가 포함된 컨텍스트를 전송하여 각 페이지에 관련 높은 광고가 게재되도록 합니다.

필터 구조는 연동 업체에 달려 있지만, 가장 중요하게 고려해야 할 점은 이러한 상품 필터가 광고 생성 컨텍스트에 전송된다는 것입니다. 상품 필터는 광고 생성에서 요청하는 내용과 정확히 일치해야 합니다.

다음을 포함하는 컨텍스트 예시 `productFilters` 는 아래와 같이 개요가 작성되어 있습니다.

```http
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
}
```

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

{% hint style="info" %}
카테고리 최저 입찰가를 활용하려면 category:Keyboards가 category:12보다 이해하기 쉬운 것처럼 캠페인을 생성하는 광고주가 카테고리를 사용자 친화적이고 이해하기 쉽게 만들어야 합니다.
{% endhint %}

## 이미지 및 상품 이름 제공

Epsilon Retail Media 은/는 캠페인을 생성할 때 검색할 수 있도록 상품 이미지 및 이름에 대한 정보가 필요합니다. Epsilon Retail Media 포털. 이러한 값은 다음 예시와 같이 형식 지정된 태그 내부에서 Epsilon Retail Media 로 전송될 수 있습니다.

```http
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 포털의 다양한 영역에서 볼 수 있습니다.

<figure><img src="/files/XAJxe1qkAmDMl5krZby3" alt="Screen Shot 2021-05-24 at 12.12.31 pm.png" width="100%"><figcaption><p>참조 이미지</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ko/data-api/catalog-products-2.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.