> 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/api-overview/integration-workflow-options-1.md).

# 리테일러를 위한 광고 연동 워크플로 옵션

Epsilon's Retail Media 표준 연동을 사용하면 웹사이트가 관련성 높은 광고를 고객에게 빠르게 제공하여 매끄러운 사용자 경험을 제공할 수 있습니다. 리테일러는 상품 카탈로그와 고객 데이터를 Epsilon's Retail Media와 동기화하기만 하면 됩니다. 유의해야 할 점은 Epsilon Retail Media 이(가) 리테일러의 백엔드를 통해 연동된다는 것입니다. 이 연동을 통해 관련성 높은 광고가 웹사이트에 표시되며, 오가닉 콘텐츠와 광고 지면을 결합하여 사용자의 쇼핑 경험을 향상시킵니다. 주요 장점은 다음과 같습니다.

1. **향상된 사용자 경험**: 광고가 오가닉 콘텐츠와 매끄럽게 결합되어 매끄러운 탐색 경험을 제공합니다.
2. **관련성**: 광고가 문맥상 관련성이 높아 사용자 참여를 유도합니다.
3. **효율성**: 광고 콘텐츠를 빠르게 전달하여 페이지 로드 시간을 단축합니다.
4. **리포팅**: 광고 노출, 클릭 및 주문에 대한 상세한 인사이트를 얻을 수 있습니다.

## 표준 연동

표준 연동 워크플로는 다음 단계로 구성됩니다.

1. 데이터 동기화
2. 광고 게재
3. 작업 리포팅

{% hint style="info" %}
고객은 최종 목록으로 병합될 때까지 지면을 볼 수 없습니다. 이를 통해 완전하고 정확한 정보를 얻을 수 있습니다.
{% endhint %}

<figure><img src="/files/syPCWscOzGGL32BCaKWt" alt="" width="100%"><figcaption></figcaption></figure>

### 워크플로

일련의 이벤트 순서는 다음과 같습니다.

#### 광고가 게재되기 전

**상품 데이터 동기화**: 다음을 사용하여 상품 카탈로그를 Epsilon Retail Media 와 동기화합니다. [API](https://developers.citrusad.com/integration/docs/use-apis) 또는 일일 [파일 동기화](https://developers.citrusad.com/integration/docs/use-apis). 선택적으로 API 또는 일일 파일 동기화를 사용하여 고객 데이터를 Epsilon Retail Media 와 동기화합니다.

#### 광고가 게재될 때

1. **고객의 웹사이트 방문**: 고객이 웹사이트를 열고 Epsilon’s Retail Media 이(가) 연동된 특정 페이지로 이동합니다.
2. **웹사이트의 데이터 요청**: 웹사이트가 페이지 컨텍스트를 기반으로 백엔드 서버에 데이터를 요청합니다(예: `customerId`, `sessionId`, `dtmCookieID`, `productFilters`).
3. 백엔드의 Epsilon Retail Media에 광고 요청\*\*: 백엔드 서버가 Epsilon Retail Media API를 호출하여 고객의 페이지 컨텍스트와 관련된 광고를 요청합니다.
4. **Epsilon Retail Media 관련 광고 반환**: Epsilon Retail Media 은(는) 배너 광고의 상품 코드 및 URL을 포함하여 요청에 가장 관련성이 높은 광고를 반환합니다.
5. **광고와 오가닉 콘텐츠 병합**: 백엔드 서버가 다음의 광고 응답을 Epsilon Retail Media 웹사이트의 오가닉 콘텐츠와 병합합니다.
6. **고객에게 모든 콘텐츠 제공**: 서버가 결합된 광고 및 오가닉 콘텐츠를 하나의 응답으로 고객의 브라우저에 전송합니다.

#### 광고가 게재된 후

1. **노출 보고**: 고객이 광고를 볼 때 노출이 다음으로 보고됩니다: Epsilon Retail Media 개별 항목에 대해 adId.
2. **클릭 보고**: 고객이 광고를 클릭할 때 클릭이 다음으로 보고됩니다: Epsilon Retail Media 개별 항목에 대해 `adId`.
3. **주문 보고**: 고객이 구매를 완료하면 주문 세부정보(항목, 가격, 수량)가 다음 정보와 함께 `customerId`, `sessionId`, `dtmCookieId` 다음으로 보고됩니다: Epsilon Retail Media.

## 유연한 연동 옵션

Epsilon Retail Media 또한 다양한 리테일러의 니즈와 선호도를 충족하기 위해 맞춤화된 두 가지 추가 연동 방법을 제공합니다. 각 방법은 고유한 장점과 트레이드오프를 가지고 있어 리테일러가 특정 요구 사항과 기술 역량에 따라 가장 적합한 접근 방식을 선택할 수 있습니다.

### 접근 방식 1: 개별 브라우저 요청

이 접근 방식은 오가닉 상품과 광고에 대해 별도의 백엔드 호출을 포함하므로 백엔드 수정을 줄이고 사용자가 항상 최신의 목록을 볼 수 있도록 합니다. 이 접근 방식을 사용할 때 리테일러가 얻을 수 있는 일부 이점은 다음과 같습니다.

* **개발 시간 단축**: 최소한의 백엔드 변경으로 더 쉽게 구현할 수 있어 개발 시간과 리소스를 절약합니다.
* **최신 목록**: 가장 최신의 광고 콘텐츠가 표시되도록 하여 광고 관련성과 사용자 참여를 잠재적으로 높입니다.

#### 워크플로

일련의 이벤트 순서는 다음과 같습니다.

<figure><img src="/files/T21FMDUQGBKcgAyZ7ZX0" alt="" width="100%"><figcaption></figcaption></figure>

#### 광고가 게재될 때

브라우저 요청의 경우 광고 게재는 다음과 같은 점에서 표준 연동과 다릅니다:

**요청 처리**

* 오가닉 리스팅이 다음과 통합될 때까지 상품 리스팅이 사용자에게 숨겨집니다: Epsilon Retail Media 리스팅.
* 기존 백엔드 서비스가 데이터에서 직접 요청하도록 하는 대신 Epsilon Retail Media이제 새로운 리테일러 서비스를 사용합니다.
* 리테일러 서비스는 관련 게재위치 정보와 함께 Epsilon Retail Media 에 백엔드 호출을 실행합니다.
* 백엔드 서버에 문의하고 Epsilon Retail Media 병합하기 전에 별도로 지정하더라도, 다음에서 제공된 상품 코드에 필요한 모든 상품 상세 정보를 계속 수집해야 합니다. Epsilon Retail Media 응답.

**콘텐츠 병합 및 서빙**

* 브라우저는 자연 검색 목록과 다음을 병합합니다. Epsilon Retail Media 리스팅.
* 병합 후 브라우저는 결합된 콘텐츠를 고객에게 서빙합니다.

### 접근 방식 2: 고객에게 표시한 후 병합

이 접근 방식은 자연 검색 콘텐츠를 먼저 보여준 다음 광고를 병합하므로 백엔드 변경을 최소화하고 사용자가 자연 검색 목록에 끊김 없이 접근할 수 있도록 합니다.

#### 워크플로

이 접근 방식에서는 이전과 유사한 워크플로를 따르지만, 자연 검색 상품 결과를 고객이 이용할 수 있는 즉시 서빙합니다. 자연 검색 결과가 표시된 후, 다음으로부터 콘텐츠를 받으면 결과를 병합하고 순서를 재정렬합니다. Epsilon Retail Media 이 연동 방식은 최소한의 개발 리소스만 필요하므로 구현하는 데 가장 적은 시간이 소요될 가능성이 높습니다.

<figure><img src="/files/bcw62aVWPOUEAGbLSZ08" alt="" width="100%"><figcaption></figcaption></figure>

#### 광고가 게재되는 시점

초기에는 오가닉 리스팅이 표시되고, Epsilon Retail Media 브라우저가 응답을 받으면 응답이 병합됩니다. 간혹 상품 광고를 병합하고 재정렬하기 전에 오가닉 리스팅이 사용자에게 먼저 표시되기도 합니다. Epsilon Retail Media 에서 상품 코드 목록을 제공하더라도, 귀사는 여전히 해당 각 상품에 대한 모든 관련 상세 정보를 가져와야 합니다.

## 연동 방식 비교

사용할 수 있는 모든 다양한 연동 방식을 빠르게 비교한 내용은 다음과 같습니다.

|        | 표준 연동                                  | 개별 브라우저 요청                               | 고객에게 표시한 후 병합                     |
| ------ | -------------------------------------- | ---------------------------------------- | --------------------------------- |
| 워크플로   | 백엔드로 단일 요청, 표시 전 병합                    | 오가닉 상품 및 광고에 대한 별도 요청                    | 오가닉 콘텐츠가 먼저 표시되고, 이후에 광고가 병합됨     |
| 백엔드 수정 | 기존 백엔드 서비스가 처리 Epsilon Retail Media 요청 | 다음에 대한 새 백엔드 서비스 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/data-api/api-overview/integration-workflow-options-1.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.
