> 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/partner/ko/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md).

# Epsilon Retail Media 파트너 API 개요

에 오신 것을 환영합니다. Epsilon Retail Media 파트너 API입니다. 이 가이드는 광고 플랫폼과 연동하여 캠페인, 지갑, 팀 및 사용자를 프로그래밍 방식으로 관리하는 데 도움을 줍니다. 또한 성과를 추적하고 비즈니스를 효과적으로 성장시킬 수 있습니다.

## API란 무엇인가요?

API는 Application Programming Interface(애플리케이션 프로그래밍 인터페이스)의 약자입니다. API는 두 개의 소프트웨어 구성 요소가 일련의 함수와 절차를 사용하여 통신할 수 있도록 하는 중개자 역할을 합니다. API는 일반적으로 데이터를 가져오거나 보내고, 다른 애플리케이션의 기능 및 서비스에 액세스하는 데 사용됩니다.

## 파트너 API란 무엇인가요?

당사의 파트너 API는 에서 수행할 수 있는 거의 모든 작업에 대한 프로그래밍 방식의 액세스를 제공합니다. Epsilon 온사이트 캠페인 관리 플랫폼의 사용자 인터페이스입니다. 즉, 앱을 통해 수동으로 클릭하는 대신 귀하의 시스템이나 개발자가 당사 플랫폼에 직접 연결하여 해당 기능을 귀하의 자체 도구나 워크플로에 자동화, 맞춤 설정 또는 통합할 수 있음을 의미합니다.

파트너 API는 Pacvue, Skai, Commerce IQ와 같은 애그리게이터를 포함한 많은 리테일러 및 파트너가 활용하고 있습니다.

## API 개요

해당 Epsilon Retail Media 파트너 API를 통해 리테일 미디어의 프로그래밍 방식 관리가 가능합니다. [Campaigns](/retail-media-interface/partner/ko/campaign-management-api/productcampaign-1/createproductcampaign.md), [Team](/retail-media-interface/partner/ko/team-user-api/team.md) & [User](/retail-media-interface/partner/ko/team-user-api/user-1/createuserteaminvite.md)및 [Wallets](/retail-media-interface/partner/ko/billing-api/wallet.md). 이를 사용하여 스폰서 상품 광고(SPA), 스태틱 배너 및 리스폰시브 Banner X 광고를 포함한 여러 광고 형식에 걸쳐 캠페인을 생성하고 업데이트할 수 있습니다.

당사의 파트너 API는 JSON 페이로드를 통해 공통 GET, POST, PATCH 및 DELETE 프로토콜을 사용하는 REST 기반 API입니다.

## 주요 혜택

* REST API 엔드포인트를 통해 캠페인, 팀 및 사용자, 지갑 작업을 자동화하세요.
* 대량 작업 지원으로 여러 캠페인과 리소스를 효율적으로 관리하세요.
* 기존 워크플로 및 시스템 아키텍처에 맞게 API 호출을 오케스트레이션할 수 있습니다.
* 스폰서 상품 광고, 배너 및 Banner X 형식 전반에 걸쳐 캠페인을 생성하고 관리하세요.
* 안전한 API 상호 작용을 위해 시간 제한 토큰이 있는 사용자 키 기반 인증을 사용합니다.

## 사전 요구 사항

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

파트너 API를 사용하기 전에 다음 요구 사항이 충족되었는지 확인하세요.

### 네임스페이스 액세스 권한

데이터 및 구성의 컨테이너 역할을 하는 지정된 네임스페이스에 대한 액세스 권한이 있어야 합니다. Epsilon 지원 팀에 문의하여 해당 리테일러에 특정한 네임스페이스 구성 세부 정보를 구하세요.

### 팀 멤버십

네임스페이스 내에서 적절한 권한을 가진 공급업체 또는 기본 리테일러 팀 중 하나에 속해 있어야 합니다.

### API 접수 요청

광고 애그리게이터, 대행사 및 브랜드 파트너는 파트너 API를 사용하기 전에 API 접수 요청을 제기해야 합니다. 다음에서 참조된 공식 접수 양식을 사용하세요. [KB0040933 ](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)새로운 API 연결을 시작합니다.

### Reporting API 액세스 권한

dim\_product, dim\_catalog 및 dim\_placement와 같은 관련 테이블을 쿼리하려면 Reporting API(BigQuery 데이터 웨어하우스)에 대한 액세스 권한이 있어야 합니다. 이는 연동 준비 상태를 검증하고 메타데이터를 탐색하는 데 도움이 됩니다.

### 필수 메타데이터

상품 카탈로그, 지면 및 팀 정보가 생성되어 네임스페이스에서 사용 가능한지 확인하세요. 적절한 BigQuery 테이블을 쿼리하여 이를 확인할 수 있습니다.

BigQuery에 대한 액세스 권한이 없는 경우 공식 API 액세스 요청 양식을 통해 요청하세요. 요구 사항에 따라 적절한 기술 자료 문서를 참조하세요.

* **Reporting BigQuery API 엔드포인트 변경/제거**: 기존 API 엔드포인트를 수정해야 하는 경우 - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* 신규 파트너 API (reporting API)\*\* - [KB0040947](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040947).

{% hint style="info" %}
액세스 참고 사항: 이 문서의 일부 링크는 내부 또는 제한된 리소스를 가리킵니다. 콘텐츠에 액세스하려면 적절한 자격 증명으로 로그인했는지 확인하세요.
{% endhint %}

## 파트너 API 시작하기

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

### 인증 요구 사항

파트너 API는 사용자 키가 필요한 승인 프로세스를 활용합니다. 액세스 토큰은 User Key Authentication API를 호출하여 검색합니다.

* 검색된 사용자 키는 이 요청의 헤더에 전달됩니다.
* 검색된 액세스 토큰은 이후 파트너 API에 대한 모든 메서드 호출에 사용됩니다.
* 토큰은 생성 후 24시간 이내에 만료됩니다.

{% hint style="info" %}
이전 토큰이 만료되면 새 토큰을 요청해야 합니다. 클라이언트는 당사 API에 대한 모든 요청마다 새 토큰을 생성해서는 안 됩니다.
{% endhint %}

### API 자격 증명 구하기

사용을 시작하려면 Epsilon Retail Media 파트너 API에는 다음 정보가 필요합니다. 세부 정보 중 확실하지 않은 것이 있으면 지원 팀에 문의하거나 티켓을 발행하여 도움을 받으세요.

* 인증을 위한 사용자 키.
* API 호출을 수행하기 위한 베이스 URL.

### 사용자 키 검색

1. 로그인하세요 Epsilon Retail Media 팀 계정.
2. 팀을 선택하세요.
3. 프로필 드롭다운에서 **사용자 설정**을 선택합니다.
4. 사용자 키\*\* 탭으로 이동합니다.
5. **보기**를 클릭하여 API 키를 노출합니다.

이 키를 사용하여 API 요청을 인증하세요. Epsilon Retail Media 은(는) 사용자 키 기반 인증을 사용합니다. 사용자 키를 시간 제한이 있는 액세스 토큰으로 교환하여 API 요청을 승인하세요. 자세한 내용은 다음을 참조하세요. [인증 요청](/retail-media-interface/partner/ko/partner-api-authentication/authenticating-requests.md).

### 베이스 URL 구하기

사용자 환경에 맞는 올바른 베이스 URL을 얻으려면 지원 팀에 문의하세요. 예시 엔드포인트:

```
https://campaign.<env>.citrusad.com/v3/campaigns
```

사용자 키를 확보하면 인증을 완료하고 다음으로 API 호출을 시작할 수 있습니다.

* 광고 캠페인을 조회하고 관리합니다.
* 광고 예산 및 지출을 관리합니다.
* 팀 및 사용자 세부 정보를 관리합니다.

## 환경 설정

Epsilon Retail Media 각 리테일러에해 Production 및 Sandbox라는 두 가지 별개의 환경을 제공합니다. 두 환경 모두 리테일러가 온보딩될 때 기본적으로 생성됩니다.

### Sandbox 환경

{% hint style="info" %}
Sandbox 액세스는 일반적으로 리테일러 및 어그리게이터에게만 제공됩니다. 자격 요건이 확실하지 않은 경우 지원팀에 문의하세요.
{% endhint %}

라이브로 전환하기 전에 이 안전한 환경을 사용하여 연동을 테스트하세요. 리테일러는 라이브로 전환하기 전에 이 환경을 사용하여 API 호출을 검증하고, 카탈로그 업로드를 테스트하고, 캠페인 생성을 시뮬레이션하고, 엔드투엔드 기능을 확인해야 합니다. 모든 개발, 테스트 및 QA 활동에 sandbox를 사용하세요. 각 리테일러에는 일반적으로 다음과 같은 형식의 고유한 sandbox URL이 있습니다.

```
https://<retailer>-sandbox.citrusad.com
```

sandbox 환경에는 다음이 포함됩니다.

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

### Production 환경

sandbox에서 성공적으로 검증을 마친 후에만 production으로 전환하세요. production 환경은 라이브 캠페인 및 실시간 광고 게재에 사용됩니다. 카탈로그 업데이트, 주문 동기화, 광고 성과 추적을 포함한 전체 규모의 운영을 지원합니다. production URL은 다음 형식을 따릅니다.

```
https://<namespace>.citrusad.com
```

이 환경을 사용하기 전에 모든 데이터(카탈로그, 상품, 주문)가 정확하고 완전한지 확인하세요.

{% hint style="info" %}
특히 자격 증명 및 기본 URL을 사용할 때 API를 호출하기 전에 항상 올바른 환경을 확인하세요. 리테일러의 연동 설정에 따라 기본 URL이 네임스페이스와 항상 일치하지 않을 수도 있습니다.
{% endhint %}

## 파트너 API 엔드포인트

Epsilon Retail Media API는 기능별 카테고리로 그룹화된 핵심 기능 세트를 제공하며, 각 기능은 전용 엔드포인트에 의해 지원됩니다. 아래 표는 주요 파트너용 API, 그 목적 및 사용되는 HTTP 메서드를 요약한 것입니다.

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

### 캠페인 관리

**스폰서 상품 광고란 무엇인가요?** 스폰서 상품 광고(SPA)는 리테일러 사이트의 상품 그리드(일반적으로 검색 및 카테고리 페이지뿐만 아니라 PDP 및 홈 페이지에서 자연 노출 목록 사이에 레이어 형태로 배치됨)에 게재되는 광고입니다.

**광고란 무엇인가요? Banner X Ad?** Banner X 광고는 사용자의 뷰포트에 따라 크기가 조절되고 변하는 완전 반응형 광고 단위입니다. 히어로 및 배경 이미지부터 헤드라인 텍스트, CTA 버튼에 이르기까지 다양한 크리에이티브 요소를 포함합니다.

**배너 광고란 무엇인가요?** 표준 배너는 클릭 스루 URL이 연결된 정적 이미지입니다.

#### 상품 캠페인

| 엔드포인트                                                                                                                                                                 | 설명                                      | Method |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ------ |
| [Create a product campaign](/retail-media-interface/partner/ko/campaign-management-api/productcampaign-1/createproductcampaign.md)                                    | 요청 본문에 제공된 세부 정보를 사용하여 새 상품 캠페인을 생성합니다. | POST   |
| [Retrieve list of all product campaigns](/retail-media-interface/partner/ko/campaign-management-api/productcampaign-1/listproductcampaigns.md)                        | 제공된 매개변수를 기반으로 모든 상품 캠페인 목록을 조회합니다.     | GET    |
| [Update a product campaign](/retail-media-interface/partner/ko/campaign-management-api/productcampaign-1/updateproductcampaign.md)                                    | 캠페인 ID를 사용하여 기존 상품 캠페인을 업데이트합니다.        | PATCH  |
| [Get product campaign by ID](/retail-media-interface/partner/ko/campaign-management-api/productcampaign-1/getproductcampaign-1.md)                                    | 지정된 캠페인 ID에 대한 상품 캠페인 세부 정보를 조회합니다.     | GET    |
| [Change approval state of a product campaign](/retail-media-interface/partner/ko/campaign-management-api/productcampaign-1/approveproductcampaign-1.md)               | 지정된 상품 캠페인의 승인 상태를 업데이트합니다.             | POST   |
| [Check booking feasibility for fixed tenancy campaigns](/retail-media-interface/partner/ko/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | 고정 게재 캠페인의 부킹 가능 여부를 확인합니다.             | POST   |

#### Banner X 캠페인

| 엔드포인트                                                                                                                                               | 설명                                                                             | Method |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------ |
| [Create a Banner X campaign](/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md)               | 요청 본문에 제공된 세부 정보를 사용하여 새 배너 X 캠페인을 생성합니다.                                      | POST   |
| [Get Banner X campaign details](/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md)               | 지정된 캠페인 ID에 대한 배너 X 캠페인 세부 정보를 조회합니다.                                          | GET    |
| [Update Banner X campaign](/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md)                   | 요청 본문에 캠페인 ID와 업데이트된 캠페인 데이터를 제공하여 기존 Banner X 캠페인을 업데이트합니다.                   | PATCH  |
| [Update Banner X campaign approval state](/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | 지정된 배너 X 캠페인의 승인 상태를 업데이트합니다.                                                  | POST   |
| [Retrieve list of all Banner X campaigns](/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md)     | 캠페인 이름, 플레이스먼트 ID, 팀 ID, 승인 상태 등을 포함하여 지정된 필터 및 매개변수를 기반으로 배너 X 캠페인 목록을 조회합니다. | GET    |

#### 배너 캠페인

| 엔드포인트                                                                                                                                       | 설명                                      | Method |
| ------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ------ |
| [Create a banner campaign](/retail-media-interface/partner/ko/campaign-management-api/bannercampaign/createbannercampaign-1.md)             | 요청 본문에 제공된 세부 정보를 사용하여 새 배너 캠페인을 생성합니다. | POST   |
| [Get banner campaign details](/retail-media-interface/partner/ko/campaign-management-api/bannercampaign/getbannercampaign-1.md)             | 지정된 캠페인 ID에 대한 배너 캠페인 세부 정보를 조회합니다.     | GET    |
| [Update banner campaign](/retail-media-interface/partner/ko/campaign-management-api/bannercampaign/updatebannercampaign.md)                 | 캠페인 ID를 사용하여 기존 배너 캠페인을 업데이트합니다.        | PATCH  |
| [Update banner campaign approval state](/retail-media-interface/partner/ko/campaign-management-api/bannercampaign/approvebannercampaign.md) | 지정된 배너 캠페인의 승인 상태를 업데이트합니다.             | POST   |

#### 캠페인 파일

| 엔드포인트                                                                                                                         | 설명                                          | Method |
| ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ------ |
| [Upload a campaign file](/retail-media-interface/partner/ko/campaign-management-api/creativeassets/uploadfile.md)             | 다양한 유형의 캠페인 파일을 업로드합니다.                     | POST   |
| [Retrieve campaign file URL](/retail-media-interface/partner/ko/campaign-management-api/creativeassets/getcampaignfileurl.md) | 지정된 파일 ID 및 파일 유형을 사용하여 캠페인 파일의 URL을 조회합니다. | POST   |

#### 콘텐츠 표준

| 엔드포인트                                                                                                                                                                     | 설명                                                                       | Method |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ------ |
| [Get Banner X content standard details](/retail-media-interface/partner/ko/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md)                 | 조회합니다 Banner X 지정된 콘텐츠 표준 ID에 대한 콘텐츠 표준 세부 정보를 조회합니다.                    | GET    |
| [Retrieve list content standards for Banner X campaigns](/retail-media-interface/partner/ko/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | 네임스페이스, 이름, 콘텐츠 표준 ID와 같은 지정된 매개변수를 기반으로 Banner X 캠페인의 콘텐츠 표준 목록을 조회합니다. | GET    |
| [Get banner content standard details](/retail-media-interface/partner/ko/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md)                      | 지정된 콘텐츠 표준 ID에 대한 배너 콘텐츠 표준 세부 정보를 조회합니다.                                | GET    |
| [Retrieve list content standards for banner campaigns](/retail-media-interface/partner/ko/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md)    | 네임스페이스, 이름, 콘텐츠 표준 ID와 같은 지정된 매개변수를 기반으로 배너 캠페인의 콘텐츠 표준 목록을 조회합니다.       | GET    |

#### 캠페인

| 엔드포인트                                                                                                                                      | 설명                                                                                   | Method |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------ |
| [Retrieve list of all campaigns](/retail-media-interface/partner/ko/campaign-management-api/campaign/listcampaigns-1.md)                   | 캠페인 이름, 캠페인 유형, 플레이스먼트 ID, 팀 ID, 승인 상태 등을 포함하여 지정된 필터 및 매개변수를 기반으로 캠페인 목록을 조회합니다.    | POST   |
| [Retrieve campaign history](/retail-media-interface/partner/ko/campaign-management-api/campaign/getcampaignhistory.md)                     | 캠페인 ID를 사용하여 캠페인 이력을 조회합니다.                                                          | GET    |
| [Retrieve minimum bid details for keywords](/retail-media-interface/partner/ko/campaign-management-api/campaign/retrievekeywordsminbid.md) | 검색 및 카테고리 & 검색 플레이스먼트 유형 캠페인의 지정된 키워드 배열에 대한 개별 최소 입찰가 세부 정보 및 전체 캠페인 최소 입찰가를 조회합니다. | POST   |
| [Retrieve minimum bid details for category](/retail-media-interface/partner/ko/campaign-management-api/campaign/retrievecategoryminbid.md) | 카테고리 플레이스먼트 유형 캠페인에 대한 개별 최소 입찰가 세부 정보 및 전체 캠페인 최소 입찰가를 조회합니다.                       | POST   |

## 크리에이티브 에셋 관리

### 크리에이티브 에셋이란 무엇인가요?

크리에이티브 에셋은 배너 및 Banner X 캠페인에 사용되는 이미지입니다. 적절한 표시와 성과를 보장하려면 이러한 에셋이 특정 기술 요구 사항을 충족해야 합니다.

### 업로드 가이드라인:

* 파일 크기 < 4 MB
* 파일 유형: PNG, JPEG, JPG, GIF, SVG 및 PDF
* 한 번에 하나의 파일만 가능
* 팀 ID, 슬롯 ID 및 콘텐츠 표준 ID는 필수 항목입니다
* 파일의 완전한 절대 경로를 제공합니다.

{% hint style="info" %}
크리에이티브 자산 업로드는 위 캠페인 관리 섹션에 나열된 캠페인 파일 엔드포인트를 통해 처리됩니다.
{% endhint %}

## 콘텐츠 표준 관리

### 콘텐츠 표준이란 무엇인가요?

콘텐츠 표준은 웹사이트나 디지털 플랫폼의 지정된 공간 내에서 배너 또는 Banner X 광고가 표시되어야 하는 방식을 규정하는 지침 및 기술 매개변수입니다. 표준에는 차원 및 크기, 파일 형식 및 크기, 해상도 및 품질, 위치 지정 및 정렬, 콘텐츠 제한 사항, 상호작용성과 같은 매개변수가 포함됩니다.

### 팀 및 사용자 관리

#### 팀이란 무엇인가요?

팀은 사용자들의 집합체이며 공급업체(광고주) 또는 리테일러 팀으로 분류됩니다. 공급업체 팀은 일반적으로 캠페인을 생성하는 반면, 리테일러는 캠페인을 검토하고 관리 작업을 수행합니다. 시스템의 사용자는 여러 팀에 속하거나 하나에만 속할 수 있습니다. 일반적으로 팀에는 연관된 사용자, 캠페인, 지갑이 있습니다.

#### Team

| 엔드포인트                                                                                           | 설명                                                          | Method |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------ |
| [Create team](/retail-media-interface/partner/ko/team-user-api/team/createteam-1.md)            | 새 팀을 생성합니다.                                                 | POST   |
| 팀 업데이트                                                                                          | team\_id로 지정된 팀의 상세 정보를 업데이트합니다.                            | PATCH  |
| 모든 팀 목록 조회                                                                                      | name, namespace\_id, seller\_id와 같은 매개변수를 제공하여 팀 목록을 조회합니다. | GET    |
| [Get team for specified ID](/retail-media-interface/partner/ko/team-user-api/team/getteam-1.md) | 멤버를 포함하여 특정 팀에 대한 상세 정보를 조회합니다.                             | GET    |
| 초대 토큰으로 팀에 합류                                                                                   | 유효하고 만료되지 않은 초대 토큰을 사용하여 사용자가 팀에 합류할 수 있도록 합니다.             | POST   |

#### User

| 엔드포인트                                                                                                        | 설명                                                   | Method |
| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- | ------ |
| [Invite a user to the team](/retail-media-interface/partner/ko/team-user-api/user-1/createuserteaminvite.md) | 지정된 팀에 합류하도록 사용자에게 초대를 보냅니다.                         | POST   |
| 사용자 ID를 사용하여 사용자 상세 정보 조회                                                                                    | 현재 로그인한 사용자의 상세 정보를 조회합니다. Epsilon Retail Media 플랫폼. | GET    |
| [Retrieve user details](/retail-media-interface/partner/ko/team-user-api/user-1/getusersforteam.md)          | 제공된 팀 ID를 기반으로 사용자 상세 정보를 조회합니다.                     | GET    |
| [Update current user detail](/retail-media-interface/partner/ko/team-user-api/user-1/updateuserprofile.md)   | 현재 로그인한 사용자의 상세 정보를 수정합니다. Epsilon Retail Media 플랫폼. | PATCH  |
| [Modify user permission](/retail-media-interface/partner/ko/team-user-api/user-1/modifyuserpermission.md)    | 사용자 ID와 팀 ID를 모두 제공하여 사용자의 권한을 업데이트합니다.              | PATCH  |
| [Upload a file](/retail-media-interface/partner/ko/team-user-api/user-1/uploadfile-1.md)                     | 사용자 프로필 및 팀의 로고를 업로드합니다.                             | POST   |
| [Retrieve file URL](/retail-media-interface/partner/ko/team-user-api/user-1/getfileurl.md)                   | 지정된 파일 ID를 사용하여 팀 또는 사용자 로고의 URL을 조회합니다.             | POST   |
| 사용자 제거                                                                                                       | 팀에서 사용자를 제거합니다.                                      | DELETE |

### 청구 및 지갑 관리

#### 지갑이란 무엇인가요?

지갑은 결제 목적(예: 집행된 광고에 대한 비용 지불)을 위해 광고주의 자금을 저장합니다.

#### 지갑

| 엔드포인트                                                                                                             | 설명                                                                  | Method |
| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------ |
| [Create a wallet](/retail-media-interface/partner/ko/billing-api/wallet/createwallet.md)                          | 지정된 네임스페이스 내에 지갑을 생성하고 팀 ID를 사용하여 팀과 연결합니다.                         | POST   |
| [Update a wallet](/retail-media-interface/partner/ko/billing-api/wallet/updatewallet-1.md)                        | 지정된 네임스페이스 및 teamId 내의 지갑을 업데이트합니다.                                 | PATCH  |
| [Retrieve wallet by ID](/retail-media-interface/partner/ko/billing-api/wallet/getwallet-1.md)                     | 고유 식별자인 {id}를 사용하여 특정 지갑의 상세 정보를 조회합니다.                             | GET    |
| [List all wallets](/retail-media-interface/partner/ko/billing-api/wallet/listwallets.md)                          | 팀 ID, 지갑 이름, 지갑 ID, 외부 ID 등을 포함하여 지정된 필터 및 매개변수를 기반으로 지갑 목록을 조회합니다. | GET    |
| [Get the balance of a specific wallet](/retail-media-interface/partner/ko/billing-api/wallet/getwalletbalance.md) | 지정된 지갑의 현재 잔액을 조회합니다.                                               | GET    |
| [Manage funds to a specific wallet](/retail-media-interface/partner/ko/billing-api/wallet/managefunds.md)         | 특정 지갑의 자금 운영을 관리합니다.                                                | POST   |

#### 지출

| 엔드포인트                                                                                                       | 설명                                            | Method |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------ |
| [Retrieve campaign spend details](/retail-media-interface/partner/ko/billing-api/spend/getcampaignspend.md) | 사용 가능한 잔액 및 지출 한도를 기반으로 특정 캠페인의 남은 예산을 계산합니다. | POST   |

### 대량 작업

#### 캠페인

| 엔드포인트                                                                                                                                  | 설명                                           | Method |
| -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------ |
| [Create campaigns in bulk](/retail-media-interface/partner/ko/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md)         | 캠페인 유형을 기반으로 동시에 여러 캠페인(최대 1,000개)을 생성합니다.   | POST   |
| [Update campaigns in bulk](/retail-media-interface/partner/ko/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md)       | 지정된 네임스페이스 내의 캠페인을 업데이트합니다.                  | PATCH  |
| [Update campaign approval state](/retail-media-interface/partner/ko/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | 지정된 네임스페이스 내의 캠페인을 승인하거나 거절합니다.              | POST   |
| 대량 작업 상태 조회                                                                                                                            | 대량 작업 ID를 사용하여 대량 캠페인 작업의 상태 및 상세 정보를 조회합니다. | GET    |

#### 지갑

| 엔드포인트                                                                                                                                   | 설명                                   | Method |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------ |
| [Create wallets in bulk](/retail-media-interface/partner/ko/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md)                | 조직 내에서 한 번에 여러 지갑을 생성합니다(최대 1,000개). | POST   |
| [Retrieve bulk wallet operation status](/retail-media-interface/partner/ko/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | 대량 ID를 사용하여 대량 지갑 작업의 상태를 조회합니다.     | GET    |
| [Update wallets in bulk](/retail-media-interface/partner/ko/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md)                | 여러 지갑을 동시에 업데이트합니다.                  | PATCH  |

#### Team

| 엔드포인트                                                                                                                                 | 설명                              | Method |
| ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ------ |
| [Create teams in bulk](/retail-media-interface/partner/ko/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md)                | 조직에 대한 대량 팀을 생성합니다.             | POST   |
| [Update teams in bulk](/retail-media-interface/partner/ko/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md)                | 여러 팀을 동시에 업데이트합니다.              | PATCH  |
| [Retrieve bulk team operation status](/retail-media-interface/partner/ko/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | 대량 ID를 사용하여 대량 팀 작업의 상태를 조회합니다. | GET    |

### 추천 검색어

#### 추천 검색어란 무엇인가요?

추천 검색어는 검색어 단계에서 캠페인을 생성할 때 사용자에게 제시되는, 카탈로그 제품을 특정 용어에 연결하여 리테일러가 파일을 통해 제공하는 용어의 집합입니다. 자세한 내용은 추천 검색어를 참조하세요.

| 엔드포인트                                                                                                                                            | 설명                                                                  | Method |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | ------ |
| [Lists all suggested search terms](/retail-media-interface/partner/ko/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | 카탈로그 ID, 제품 코드 등과 같은 지정된 매개변수를 기반으로 타겟팅 추천 검색어 카탈로그의 추천 검색어를 조회합니다. | GET    |

## 모범 사례

원활하고 효율적이며 안정적인 통합을 위해 다음 모범 사례를 따르세요. Epsilon Retail Media 파트너 API:

* 프로덕션 배포 전에는 항상 샌드박스에서 테스트하세요.
* 여러 작업에는 대량 엔드포인트를 사용하세요.
* 오류 응답에서 특정 데이터 문제를 확인하세요.
* 더 빠른 데이터 업로드를 위해 압축된 파일을 사용하세요.
* 액세스 토큰은 만료되었을 때만 새로 고치세요.
* 요청을 제출하기 전에 필수 필드를 검증합니다.

## 오류 처리

파트너 API는 강력한 예외 처리를 지원하기 위해 구조화된 JSON 오류 응답을 반환합니다.

* **HTTP 상태 코드**: 표준 오류 코드(400, 401, 403, 500 등)
* **오류 코드**: 특정 오류 식별자.
* **메시지**: 사람이 읽을 수 있는 오류 설명.
* **필드 위반**: 데이터 입력 문제에 대한 특정 필드 검증 오류입니다.

자세한 오류 처리 정보는 다음을 참조하세요. [오류 처리](/retail-media-interface/partner/ko/partner-api-overview/error-handling.md).

## 지원 및 리소스

| 리소스                                                                                                                 | 설명                               |
| ------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [Frequently asked questions](/retail-media-interface/partner/ko/partner-api-overview/frequently-asked-questions.md) | API 사용 및 연동과 관련된 일반적인 질문과 답변입니다. |
| 릴리스 노트                                                                                                              | API의 최근 업데이트 또는 변경 사항에 대한 요약입니다. |
| [Glossary](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1)                             | API 문서 전반에서 사용되는 주요 용어의 정의입니다.   |


---

# 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/partner/ko/partner-api-overview/epsilon-retail-media-partner-apis-overview-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.