> 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/customer-data/syncing-customer-data-via-api-1.md).

# API를 통한 고객 데이터 동기화

## 고객 데이터를 다음으로 전송 Epsilon Retail Media

고객 데이터를 다음으로 전송하려면 Epsilon Retail Media아래와 유사한 명령을 사용하세요. 참고로 `customers` 필드의 데이터는 더미 데이터이며 여기에 예시로만 제공됩니다.

{% hint style="info" %}
모든 `customer` 객체 필드는 선택 사항입니다. 필드 값 없이 `customer` 객체를 푸시하면 새로운 `id` 이(가) 생성되므로 지정하지 마십시오 `id` 생성하는 경우 `customer` 개체.

의 모든 값 `targetingData` 필드는 자의적이며 소매업체가 구성할 수 있습니다. 자세한 내용은 참조 페이지를 방문하십시오.
{% endhint %}

```http
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customers": [
        {
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "targetingData": {
            "customer_type": "Corporate"
            }
        }
    ]
}
```

성공하면 다음 개체가 반환됩니다.

```json
{
    "customers": [
        {
            "targetingData": {
                "customer_type": "Corporate"
            },
            "gender": "Other",
            "teamId": "9be784a8-22fc-4315-a335-b7d2c2494f0a",
            "postcode": "",
            "suburb": "",
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "yearOfBirth": 0
        }
    ]
}
```

## 여러 고객 동기화

여러 고객을 동기화하는 경우 각 요청 시 최대 100개의 항목을 배치로 보낼 수 있습니다. 작성할 수 있는 요청 수에는 제한이 없습니다.

전송된 고객 페이로드 순서는 반환된 결과 순서와 동일하므로 데이터가 통합업체가 백엔드에서 유지하는 고객 표현과 일치하는 상태를 유지할 수 있습니다.

```http
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customers": [
        {
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "targetingData": {
            "customer_type": "Corporate"
            }
        },
        {
            "id": "c7792468-07ea-4cc3-9b1a-975bb43dfa02",
            "targetingData": {
            "customer_type": "Retail"
            }
        }
    ]
}
```

성공하면 다음 개체가 반환됩니다.

```json
{
    "customers": [
        {
            "targetingData": {
                "customer_type": "Corporate"
            },
            "gender": "Other",
            "teamId": "9be784a8-22fc-4315-a335-b7d2c2494f0a",
            "postcode": "",
            "suburb": "",
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "yearOfBirth": 0
        },
        {
            "targetingData": {
                "customer_type": "Retail"
            },
            "gender": "Other",
            "teamId": "9be784a8-22fc-4315-a335-b7d2c2494f0a",
            "postcode": "",
            "suburb": "",
            "id": "c7792468-07ea-4cc3-9b1a-975bb43dfa02",
            "yearOfBirth": 0
        }
    ]
}
```

{% hint style="warning" %}
`gender`,`postcode`,`suburb`,`yearOfBirth` 필드

이 필드들은 더 이상 사용되지 않으며 이전 통합을 위해서만 남아 있습니다.
{% endhint %}

### 대용량 고객 데이터 수집

통합 시 API는 한 번에 100개씩의 배치를 허용하므로 수집을 위해 첫 번째 고객 데이터 배치를 파일로 보내는 것이 좋습니다.


---

# 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/customer-data/syncing-customer-data-via-api-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.