> 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/audience-targeting-new/integration-option-2-sync-customers-audience.md).
# 옵션 2: 고객 및 오디언스 동기화
### 개요
클린 룸 또는 자체 관리 오디언스 세그먼트를 보유한 리테일러는 고객 및 세그먼트 데이터를 동기화하여 주요 광고주 및 일반 오디언스를 위한 맞춤형 오디언스 전달을 활성화할 수 있습니다. 이 연동에는 CDP를 사용하여 고객/세그먼트 정보를 Epsilon에 제공하는 작업이 포함됩니다. API 또는 파일 방식 중 하나를 사용합니다.
### 연동 요구 사항
* 표준 온사이트 연동에는 (가능한 경우) 모든 관련 접점에 걸쳐 고객 ID가 포함되어야 합니다.
* API 또는 파일 피드를 통한 고객의 고객 ID 피드입니다.
* API 또는 파일 피드를 통한 세그먼트 피드입니다.
### 작동 방식
CDP 또는 오디언스 플랫폼은 고객 및 세그먼트 데이터를 다음에 제공합니다: Epsilon 파일 업로드 또는 API를 사용합니다. 광고 요청에 포함된 고객 ID는 오디언스 세그먼트 및 관련 캠페인과 매칭됩니다. 이를 통해 맞춤형 또는 일반 오디언스 정의를 기반으로 정확한 타겟팅이 가능해집니다.
### 연동 예시
**광고 요청 예시**: 고객 ID가 포함된 광고 요청:
```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
```
{% hint style="info" %}
귀하의 광고 요청에는 다음이 포함되어야 합니다. `customerId`, 파일 또는 API를 통해 연동하는지 여부와 관계없이.
{% endhint %}
### 피드 파일 동기화 연동 (권장)
파일로 고객 및 세그먼트를 동기화할 때 두 개의 파일이 필요합니다.
* 세그먼트 파일
* 고객 파일
#### 세그먼트 파일
세그먼트 파일은 UI에 표시되는 세그먼트 ID, 이름 및 설명을 제공하는 데 사용됩니다. 또한 세그먼트를 볼 수 있는 특정 team\_ids를 지정하여 특정 광고주를 위한 세그먼트를 큐레이팅하는 데 사용할 수도 있습니다.
| segment\_id | name | description | team\_ids |
| ----------------- | ---------------------------- | -------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | 고액 지출 구매자 | 주평균 구매액이 상위 15%에 속하는 구매자입니다. | |
| general-segment-2 | 실속형 구매자 | 가성비 중심 상품의 장바구니 비중이 더 높은 구매자입니다. | |
| general-segment-3 | 정기 구매자 | 평균적으로 매주 쇼핑하는 구매자입니다. | |
| custom-segment-1 | 사용자 지정: 최근 구매 이력이 있는 BrandCo | 최근 30일 이내에 BrandCo를 구매한 고객입니다. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
세그먼트 참조 가이드 보기 [여기](/retail-media-interface/integration/ko/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).
#### 고객 파일
고객 파일은 단일 고객을 생성하고 세그먼트에 연결하는 데 사용되며, 다음 항목만 제공하면 됩니다: `customer_id` 및 `segment_ids`
| customer\_id | segments |
| ------------ | ------------------------------------------- |
| cust\_12345 | \["general-segment-3", "general-segment-4"] |
| cust\_67890 | \["general-segment-3"] |
고객 참조 가이드 보기 [여기](/retail-media-interface/integration/ko/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).
{% hint style="info" %}
고객당 최대 100개의 세그먼트입니다.
한 고객에 대해 100개 이상의 세그먼트를 동기화하는 경우 다음으로 문의하세요. Epsilon. 고객당 100개 세그먼트를 초과하는 경우 광고 요청의 세그먼트 풀링이 줄어들고 요청 내 세그먼트가 잘릴 수 있습니다.
{% endhint %}
### API 동기화 연동
API로 고객 및 세그먼트를 동기화할 때 완료해야 하는 작업은 세 가지입니다.
1. 세그먼트 생성
2. 선택 사항: 매니저 세그먼트 액세스
3. 고객 생성
4. 고객-세그먼트 연결 관리
#### API를 통해 세그먼트 생성하기
가장 먼저 해야 할 일은 고객을 연결할 세그먼트를 생성하는 것입니다.
UI에 표시되는 세그먼트 ID, 이름, 설명 및 리테일러 팀을 제공해야 합니다.
{% hint style="info" %}
중요: 세그먼트 API는 Partner API에서 사용하는 bearer 인증을 사용합니다. bearer 토큰을 생성하여 사용해야 합니다. 자세히 알아보기: [인증 요청](https://help.citrusad.com/retail-media-interface/partner/ko/partner-api-authentication/authenticating-requests).
{% endhint %}
```http
POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer
{
"segment":{
"segmentId": "general-segment-4",
"sourceId": "DEFAULT_SOURCE_ID",
"name": "Value Shoppers",
"description": "Shoppers that have a higher basket % of value driven products.",
"retailerTeamId": "13c84def-41cb-4f99-a3fc-6788264f79fe"
}
}
```
세그먼트 생성 엔드포인트에 대한 참조 보기 [여기](https://help.citrusad.com/retail-media-interface/partner/ko/audience-segment-api/segment/createsegment).
#### 선택 사항: 세그먼트 액세스 관리
manage-access 기능을 사용하여 선택한 광고주가 세그먼트를 볼 수 있도록 액세스 권한을 제공하여 특정 광고주를 위한 세그먼트를 큐레이팅할 수 있습니다.
```http
POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer
{
"accessTeamIds":[
"90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
]
}
```
특정 세그먼트에 대한 액세스 관리 엔드포인트 참조 보기 [여기](https://help.citrusad.com/retail-media-interface/partner/ko/audience-segment-api/segment/manageaccess).
#### API를 통해 고객 생성하기
{% hint style="info" %}
고객 API는 Integration API에서 사용하는 기본 인증을 사용합니다.
{% endhint %}
```http
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"customers": [
{
"id": "cust_12345"
},
{
"id": "cust_67890"
}
}
]
}
```
완료되면 고객을 연결할 세그먼트도 생성해야 합니다. 요청당 최대 100명의 고객을 생성할 수 있습니다.
고객 생성 또는 업데이트 API 명세서 보기 [여기](/retail-media-interface/integration/ko/integration/create-or-update-a-customer.md).
#### API를 통해 고객을 세그먼트에 연결
세그먼트를 생성한 후 /customers/manage-segments API를 사용하여 고객을 세그먼트에 연결합니다.
```http
POST $BASE_URL/v1/customers/manage-segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"customerId": "cust_12345",
"teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe",
"segments": {
"segmentIds":[
"general-segment-4","general-segment-3"
]
}
}
```
{% hint style="info" %}
이 요청의 teamId는 리테일러 팀 ID입니다.
{% endhint %}
여기에서 세그먼트 및 고객을 관리하는 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/integration/ko/data-api/audience-targeting-new/integration-option-2-sync-customers-audience.md?ask=&goal=
```
`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.