> 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/feature-integrations/category-cross-sell/integration-requirements.md).

# 연동 요구 사항

## 고급 개요

이 연동의 일환으로 아래 작업을 수행해야 합니다.

1. 교차 판매 카테고리 지면에 대한 추가 광고 요청을 구현합니다.
   1. 여기에는 사이트에 광고를 배치하고 렌더링하는 작업뿐만 아니라 클릭수 및 노출수를 보고하는 작업이 포함됩니다.
   2. 주문 정보를 다음에 제공해야 합니다. Epsilon Retail Media 표준 연동의 일환으로
2. 카테고리 ID를 다음과 동기화하는 경우 Epsilon Retail Media, UI 카테고리 선택에 필요한 사람이 읽을 수 있는 값을 제공하기 위해 사용해야 합니다. [filterMapping](/retail-media-interface/integration/ko/citrus-filter-mapping-api/filtermapping.md) API를 통해 사람이 읽을 수 있는 값을 UI 카테고리 선택 용으로 제공해야 합니다.
   1. 이는 이름 대신 카테고리 ID로 연동된 경우에만 적용됩니다. (예: 광고를 요청할 때 필터가 다음과 같은 경우 `category:123j-dsef-er` 대신 `category:Milk`
3. (권장) - 승인을 자동화하고 캠페인 관리 부담을 줄이기 위해 카테고리 교차 판매 매핑을 동기화합니다.

## 광고 요청 및 사이트 연동

### 광고 요청

카테고리 교차 판매에는 독립 실행형 지면이 필요하므로 카테고리 교차 판매를 연동하는 광고 유형별로 추가 광고 요청을 연동해야 합니다.

요청 형식은 아래 나열된 교차 판매 카테고리 광고 요청과 일치해야 합니다.

* [상품 광고 - 카테고리 교차 판매 광고 요청](/retail-media-interface/integration/ko/generating-ads/product-ads/requesting-product-ads-1.md#cross-sell-category-placements)
* [배너 광고 - 카테고리 교차 판매 광고 요청](/retail-media-interface/integration/ko/generating-ads/banner-ads-static/requesting-banner-ads.md#cross-sell-category-placements)
* Banner X - 카테고리 교차 판매 광고 요청

### 노출수 및 클릭수 보고

광고 요청을 연동한 후에는 표시되는 각 광고에 대해 클릭수와 노출수가 올바르게 보고되는지 확인해야 합니다. 다음 항목을 반드시 읽어보세요. [노출수 및 클릭수 보고](/retail-media-interface/integration/ko/data-api/api-overview/reporting-impressions-clicks.md).

### 주문 보고

일반적으로 대부분의 연동은 모든 주문 정보를 다음에 보고합니다. Epsilon Retail Media 표준 연동에 따라. 모든 주문 정보가 올바르게 다음으로 보고되는지 확인해야 합니다. Epsilon Retail Media 다음 지침에 따라 [주문 데이터](/retail-media-interface/integration/ko/data-api/order-data-1.md).

## 필터 매핑

필터 매핑 엔드포인트를 사용하여 카테고리 ID를 사람이 읽을 수 있는 값으로 매핑할 수 있습니다. UI에 사용자에게 표시되는 값이 나타나므로 카테고리 ID를 동기화하는 경우 이 작업이 필요합니다.

{% hint style="info" %}
상품 카탈로그에서 사람이 읽을 수 있는 카테고리를 다음과 동기화하는 경우 Epsilon Retail Media, 이 단계는 필요하지 않습니다.
{% endhint %}

사용자는 다음이 무엇인지 이해하지 못합니다. `category:12345-abcde` 이것이 무엇인지 이해하지 못합니다. filterMapping API를 사용하여 이 값을 사이트의 관련 카테고리 이름으로 매핑할 수 있습니다(예: `category:Pantry`).

이 정보를 동기화하는 파일 기반 방법은 없으며, 반드시 다음을 통해 수행해야 합니다. [filterMapping](/retail-media-interface/integration/ko/citrus-filter-mapping-api/filtermapping.md) API.

{% hint style="warning" %}
사이트에 추가 카테고리를 생성할 때 filterMapping API를 사용하여 카테고리를 업데이트해야 합니다.
{% endhint %}

## 카테고리 교차 판매 매핑(권장)

이러한 유형의 지면을 연동할 때 어떤 카테고리가 서로를 타겟팅할 수 있는지에 대한 매핑을 제공하는 것이 강력히 권장됩니다. 이렇게 하면 초기 연동 작업 후 운영을 간소화할 수 있습니다. 광고주 환경이 이미 선택 허용된 카테고리만 선택할 수 있도록 간소화됩니다.

또한 카테고리 교차 판매 매핑이 제공되는 경우 교차 판매 카테고리 캠페인에 대한 자동 승인을 구성할 수도 있습니다.

### 연동 방법

* 다음 API를 사용할 수 있습니다. [crossSellCategory](/retail-media-interface/integration/ko/crosssellcategory-api/crosssellcategory.md) API를 사용하여 필요에 따라 매핑을 생성하고 관리할 수 있습니다.
* 또는 다음에서 호스팅하는 GCS 버킷에 TSV 파일을 제공할 수도 있습니다. Epsilon Retail Media 아래 나열된 형식으로 제공할 수 있습니다.

#### API 연동

모든 필요한 정보는 다음에서 확인할 수 있습니다. [crossSellCategory](/retail-media-interface/integration/ko/crosssellcategory-api/crosssellcategory.md) API 참조.

#### 파일 연동

파일로 연동하는 경우, Epsilon Retail Media 카탈로그당 서로 타겟팅할 수 있는 카테고리 파일이 필요합니다.

파일의 각 행은 카테고리와 해당 카테고리가 타겟팅할 수 있는 카테고리의 단일 매핑을 나타냅니다. 각 매핑은 단방향입니다 (chocolate -> milk를 동기화하면 초콜릿 상품이 우유 카테고리에 표시될 수 있습니다. 우유 상품이 초콜릿에 표시될 수 있어야 하는 경우 추가 행이 필요함).

아래 사양에 맞는 TSV 형식의 데이터 피드가 필요합니다.

| 열 이름                | 필수 여부 | 데이터 타입 | 설명                                                             | 예시                 |
| ------------------- | ----- | ------ | -------------------------------------------------------------- | ------------------ |
| `category`          | 필수 여부 | 텍스트    | 광고되는 상품의 카테고리를 식별하는 고유한 카테고리 ID입니다.                            | `category:cookies` |
| `cross_category_id` | 필수 여부 | 텍스트    | category\_id의 상품이 교차 판매될 수 있는 자격 있는 카테고리를 식별하는 고유한 카테고리 ID입니다. | `category:milk`    |

추가 파일 사양은 아래와 같습니다:

* TSV 파일만 지원됩니다
* TSV는 CRLF가 아닌 LF 방식이어야 합니다
* TSV는 UTF-8로 인코딩되어야 하며, 다른 유형은 피드 실패를 일으킵니다
* 필요한 명명 규칙: `^cross_sell_category.*.tsv$`

샘플 스니펫은 아래와 같습니다:

| 카테고리          | 교차 카테고리 ID         |
| ------------- | ------------------ |
| 카테고리:쿠키       | category:milk      |
| 카테고리:쿠키       | category:chocolate |
| category:milk | 카테고리:쿠키            |

위의 이 스니펫을 사용하면 **cookies** 카테고리를 **milk** 및 **chocolate** 카테고리로 십자 판매할 수 있습니다. **milk** 카테고리는 **cookies** 카테고리로 십자 판매할 수 있습니다. **chocolate** 카테고리는 타겟팅할 수 있지만 다른 카테고리를 타겟팅할 수는 없습니다.

{% hint style="danger" %}
️ 각 행은 고유한 매핑 조합입니다.

고유한 각 교차 판매 카테고리 매핑에 대해 고유한 행을 동기화해야 합니다. 단일 행에서 여러 cross\_category\_id를 동기화하려고 하면 파일 수집이 실패합니다.
{% endhint %}

{% hint style="warning" %}
열 순서

파일에 다음이 포함되어 있는지 확인하세요. `category` 열을 첫 번째 열로 지정합니다. 동기화하는 경우 `cross_category_id` 첫 번째 열로 지정하면 수집이 실패합니다.
{% endhint %}

## 기능 활성화 프로세스

제안된 검색어 피드 동기화를 시작할 준비가 되면, Epsilon Retail Media 가 파일을 삭제할 GCS 버킷을 구성합니다.

이 기능은 GCS 버킷에서만 지원됩니다. AWS/Azure/기타와 같은 외부 버킷은 지원되지 않습니다.

담당 기술 고객 관리자(Technical Account Manager)가 이 기능의 활성화를 안내해 드립니다. Epsilon Retail Media의 플랫폼 운영 팀이 구성을 조치해야 하므로 활성화까지 추가 처리 시간이 소요될 수 있습니다.


---

# 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/feature-integrations/category-cross-sell/integration-requirements.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.