> 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-3-sync-audiences-only.md).
# Opção 3: Sincronizar apenas públicos-alvo
### Visão geral
Para organizações incapazes de compartilhar identificadores de clientes, a ativação de públicos-alvo pode ser realizada sincronizando feeds de segmentos e passando IDs de segmento em solicitações de anúncio. Essa abordagem focada na privacidade permite o direcionamento tanto de públicos personalizados quanto gerais sem expor dados ao nível do cliente. As solicitações de anúncio devem incluir identificadores de segmento para dar suporte à ativação direcionada.
### Requisitos de integração
* O feed de segmentos deve especificar quais segmentos de público-alvo estão disponíveis para as equipes de anunciantes designadas.
* As solicitações de anúncio devem incluir o(s) ID(s) de segmento relevante(s) para cada cliente.
### Como funciona
A CDP ou plataforma de público-alvo fornece Epsilon com um feed de segmentos por meio de upload de arquivo ou API. Os IDs de segmento incluídos nas solicitações de anúncio são usados para corresponder públicos-alvo a campanhas. O mapeamento entre clientes e segmentos é mantido internamente dentro dos sistemas de backend do varejista.
### Exemplos de integração
**Exemplo de solicitação de anúncio**: Solicitação de anúncio contendo IDs de segmento:
```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" %}
Você está sincronizando segmentos de várias fontes?
Se estiver, você também precisará fornecer o `sourceId` no objeto de segmento. Este valor é acordado entre você e Epsilon para referenciar a fonte do segmento. Um exemplo pode ser `customer-cdp-1`.
Se você estiver sincronizando de apenas uma fonte/CDP, precisará enviar apenas o `segmentIds` no `segment` array.
{% endhint %}
### Integração de sincronização por arquivo de feed (Recomendado)
Ao sincronizar segmentos, exigimos apenas um arquivo.
#### 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 valor | Compradores com uma compra média semanal entre os 15% principais. | |
| general-segment-2 | Compradores em busca de ofertas | Compradores que têm uma porcentagem maior do carrinho composta por produtos focados em custo-benefício. | |
| general-segment-3 | Compradores recorrentes | Compradores que compram todas as semanas, em média. | |
| custom-segment-1 | Personalizado: Recência de compra alta BrandCo | Clientes que compraram BrandCo nos últimos 30 dias. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Veja o Guia de Referência de Segmento aqui
### Integração de sincronização por API
Ao sincronizar clientes e segmentos por API, há uma ou duas operações que precisam ser concluídas.
1. Criar segmentos
2. Opcional: gerenciar acesso a segmentos
#### Criação de segmentos via API
Como você está gerenciando o relacionamento entre cliente e segmento antes da solicitação de anúncio, você só precisa enviar os segmentos.
Você precisa fornecer um ID de segmento que é exibido na UI, um nome, uma descrição, bem como sua equipe do varejista.
{% hint style="info" %}
A API de segmentos usa autorização do tipo bearer usada pela API do parceiro. 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"
}
}
```
Veja 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).
Se estiver sincronizando segmentos via API. Isso `sourceId` se alinha com a solicitação de anúncio.
{% hint style="info" %}
Máximo de 100 segmentos por solicitação de anúncio.
Se você estiver sincronizando mais de 100 segmentos, entre em contato com Epsilon . Se você exceder 100 segmentos por cliente, as solicitações de anúncio podem ter um agrupamento reduzido de segmentos e truncar os segmentos na solicitação.
Em caso de truncamentos, você verá o `metadata.warnings`campo na resposta do anúncio aparecer e ser preenchido, conforme abaixo:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Opcional: gerenciar acesso a segmentos
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"
]
}
```
Veja 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).
---
# 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-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.