> 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/pt-br/data-api/audience-targeting-new/integration-option-2-sync-customers-audience.md).
# Opção 2: Sincronizar clientes e público-alvo
### Visão geral
Varejistas com clean rooms ou segmentos de público-alvo autogerenciados podem sincronizar dados de clientes e segmentos para permitir a entrega de público-alvo personalizado para os principais anunciantes e públicos em geral. Esta integração envolve o uso do seu CDP para fornecer informações de clientes/segmentos para Epsilon. Seja por API ou arquivo.
### Requisitos de integração
* A integração padrão no site deve incluir o ID do cliente em todos os pontos de contato relevantes (onde disponível).
* Feed de ID de cliente de clientes, por API ou feed de arquivo.
* Feed de segmento por API ou feed de arquivo.
### Como funciona
O CDP ou plataforma de público-alvo fornece dados de clientes e segmentos para Epsilon usando upload de arquivo ou API. Os IDs de cliente incluídos nas solicitações de anúncio são correspondidos aos segmentos de público-alvo e campanhas associadas. Isso possibilita um direcionamento preciso com base em definições de público-alvo personalizadas ou gerais.
### Exemplos de integração
**Exemplo de solicitação de anúncio**: Solicitação de anúncio contendo ID de cliente:
```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" %}
Sua solicitação de anúncio deve conter `customerId`, independentemente de você estar integrando via arquivo ou API.
{% endhint %}
### Integração de sincronização de arquivo de feed (recomendada)
Ao sincronizar clientes e segmentos por arquivo, exigimos dois arquivos:
* Arquivo de segmento
* Arquivo de cliente
#### Arquivo de segmento
Um arquivo de segmento é usado para fornecer um ID de segmento que é exibido na UI, um nome e uma descrição. Ele também pode ser usado para especificar quaisquer team\_ids específicos que possam visualizar um segmento, permitindo que você curar segmentos para anunciantes específicos.
| segment\_id | name | description | team\_ids |
| ----------------- | ---------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | Compradores de alto gasto | Compradores com uma compra média semanal entre os 15% principais. | |
| general-segment-2 | Compradores focados em valor | Compradores que têm uma % maior de produtos focados em valor no carrinho. | |
| general-segment-3 | Compradores recorrentes | Compradores que compram todas as semanas, em média. | |
| custom-segment-1 | Personalizado: Alta recência de compra BrandCo | Clientes que compraram BrandCo nos últimos 30 dias. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Consulte o Guia de referência de segmento [aqui](/retail-media-interface/integration/pt-br/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).
#### Arquivo de cliente
Seu arquivo de cliente é usado para criar um único cliente e vinculá-lo a segmentos; você só precisa fornecer `customer_id` e `segment_ids`
| customer\_id | segments |
| ------------ | ------------------------------------------- |
| cust\_12345 | \["general-segment-3", "general-segment-4"] |
| cust\_67890 | \["general-segment-3"] |
Consulte o Guia de referência do cliente [aqui](/retail-media-interface/integration/pt-br/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).
{% hint style="info" %}
Máximo de 100 segmentos por cliente.
Se você estiver sincronizando mais de 100 segmentos para um cliente, entre em contato com Epsilon. Se você exceder 100 segmentos por cliente, as solicitações de anúncio podem ter um agrupamento de segmentos reduzido e truncar segmentos na solicitação.
{% endhint %}
### Integração de sincronização por API
Ao sincronizar clientes e segmentos por API, há três operações que precisam ser concluídas.
1. Criar segmentos
2. Opcional: gerenciar acesso ao segmento
3. Criar clientes
4. Gerenciar vinculação de cliente-segmento
#### Criando segmentos via API
A primeira coisa que você deve fazer é criar seus segmentos para vincular clientes.
Você precisa fornecer um ID de segmento que é exibido na UI, um nome, descrição, bem como sua equipe de varejista.
{% hint style="info" %}
Importante: A API de segmentos usa a autorização do tipo bearer usada pela Partner API. Você precisará gerar um token bearer e usá-lo. Saiba mais: [Solicitações de autenticação](https://help.citrusad.com/retail-media-interface/partner/pt-br/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"
}
}
```
Consulte a referência para o endpoint Criar um segmento [aqui](https://help.citrusad.com/retail-media-interface/partner/pt-br/audience-segment-api/segment/createsegment).
#### Opcional: gerenciar acesso ao segmento
Você pode usar a função manage-access para fornecer acesso a anunciantes selecionados para ver o segmento, permitindo que você curar segmentos para anunciantes específicos.
```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"
]
}
```
Consulte a referência para o endpoint Gerenciar acesso a um segmento específico [aqui](https://help.citrusad.com/retail-media-interface/partner/pt-br/audience-segment-api/segment/manageaccess).
#### Criando clientes via API
{% hint style="info" %}
A API de clientes usa a autorização básica usada pela 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"
}
}
]
}
```
Quando concluído, você também precisa criar segmentos para vincular os clientes. Você pode criar até 100 clientes por solicitação.
Consulte a especificação da API para Criar ou atualizar um cliente [aqui](/retail-media-interface/integration/pt-br/integration/create-or-update-a-customer.md).
#### Vincule clientes a segmentos via API
Após criar os segmentos, use a API /customers/manage-segments para vincular clientes aos segmentos
```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" %}
O teamId nesta requisição é o ID da sua equipe de varejista.
{% endhint %}
Veja a especificação da API para gerenciar segmentos e clientes aqui.
---
# 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/pt-br/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.