> 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-3-sync-audiences-only.md).
# 옵션 3: 오디언스만 동기화
### 개요
고객 식별자를 공유할 수 없는 조직의 경우 세그먼트 피드를 동기화하고 광고 요청에 세그먼트 ID를 전달하여 오디언스를 활성화할 수 있습니다. 이러한 개인정보 보호 우선 방식을 사용하면 고객 수준의 데이터를 노출하지 않고 맞춤 오디언스 및 일반 오디언스 타겟팅을 모두 수행할 수 있습니다. 타겟팅된 활성화를 지원하려면 광고 요청에 세그먼트 식별자가 포함되어야 합니다.
### 연동 요구 사항
* 세그먼트 피드는 지정된 광고주 팀이 사용할 수 있는 오디언스 세그먼트를 명시해야 합니다.
* 광고 요청에는 각 고객에 대한 관련 세그먼트 ID가 포함되어야 합니다.
### 작동 방식
CDP 또는 오디언스 플랫폼은 파일 업로드 또는 API를 통해 Epsilon 에 세그먼트 피드를 제공합니다. 광고 요청에 포함된 세그먼트 ID는 오디언스를 캠페인에 매칭하는 데 사용됩니다. 고객과 세그먼트 간의 매핑은 리테일러의 백엔드 시스템 내부에서 유지됩니다.
### 연동 예시
**광고 요청 예시**: 세그먼트 ID가 포함된 광고 요청:
```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"audience": {
"segments": [
{
"segmentIds": [
"segment-1"
]
},
{
"sourceId": "RETAILER_SOURCE_2",
"segmentIds": [
"general-segment-4","general-segment-3"
]
}
]
},
"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" %}
여러 소스에서 세그먼트를 동기화하고 계신가요?
그런 경우, `sourceId` 의 세그먼트 객체에도 해당 값을 제공해야 합니다. 이 값은 세그먼트의 소스를 참조하기 위해 귀사와 Epsilon 간에 합의된 값입니다. 예시로 `customer-cdp-1`가 있습니다.
단일 소스/CDP에서만 동기화하는 경우에는 `segmentIds` 의 `segment` 배열에 포함하여 보내기만 하면 됩니다.
{% endhint %}
### 피드 파일 동기화 연동 (권장)
세그먼트를 동기화할 때 하나의 파일만 필요합니다.
#### 세그먼트 파일
세그먼트 파일은 UI에 표시되는 세그먼트 ID, 이름 및 설명을 제공하는 데 사용됩니다. 또한 세그먼트를 볼 수 있는 특정 team\_ids를 지정하는 데 사용할 수 있으므로 특정 광고주를 위한 세그먼트를 큐레이팅할 수 있습니다.
| segment\_id | name | description | team\_ids |
| ----------------- | -------------------------- | --------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | 고지출 구매자 | 주평균 구매액이 상위 15%에 속하는 구매자입니다. | |
| general-segment-2 | 실속형 구매자 | 가성비 중심 상품의 장바구니 비중이 더 높은 구매자입니다. | |
| general-segment-3 | 재방문 구매자 | 평균적으로 매주 구매하는 구매자입니다. | |
| custom-segment-1 | Custom: 최근 구매율이 높은 BrandCo | 최근 30일 이내에 BrandCo 제품을 구매한 고객입니다. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
여기서 세그먼트 레퍼런스 가이드를 확인하세요
### API 동기화 연동
API로 고객 및 세그먼트를 동기화할 때 완료해야 하는 작업은 한두 가지입니다.
1. 세그먼트 생성
2. 선택 사항: 세그먼트 액세스 관리자
#### API를 통한 세그먼트 생성
광고 요청 전에 고객-세그먼트 관계를 관리하므로 세그먼트만 전송하면 됩니다.
UI에 표시되는 세그먼트 ID, 이름, 설명 및 리테일러 팀을 제공해야 합니다.
{% hint style="info" %}
세그먼트 API는 파트너 API에서 사용하는 베어러 (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).
API를 통해 세그먼트를 동기화하는 경우. 이 `sourceId` 은(는) 광고 요청과 정렬됩니다.
{% hint style="info" %}
광고 요청당 최대 100개의 세그먼트.
100개 이상의 세그먼트를 동기화하는 경우 다음으로 문의하세요. Epsilon. 고객당 세그먼트 수가 100개를 초과하면 광고 요청의 세그먼트 풀링이 축소되고 요청 내 세그먼트가 잘릴 수 있습니다.
잘림 현상이 발생하는 경우 아래와 같이 광고 응답에 `metadata.warnings`필드가 나타나고 채워집니다.
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### 선택 사항: 세그먼트 액세스 관리
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).
---
# 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-3-sync-audiences-only.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.