> 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/customer-data.md).

# Sincronização de dados do cliente para segmentação de público-alvo

Para capacitar anunciantes ou varejistas a direcionar públicos-alvo específicos, Epsilon Retail Media requer acesso aos dados do cliente. Este guia explica como enviar dados do cliente para o Epsilon Retail Media, permitindo um direcionamento eficaz de público-alvo. A sincronização de dados pode ser realizada via API ou upload de arquivo.

## Abordagem de direcionamento de clientes

Epsilon Retail MediaO direcionamento de clientes do é baseado em `key:value` combinações a partir de dados proprietários do varejista. Esta abordagem é mais adequada para a ingestão de dados qualitativos de grupos de clientes específicos, como idade ou tipo de cliente, em vez de públicos comportamentais (por exemplo, comprou o produto XYZ nos últimos Y dias).

## Direcionamento de público-alvo específico por posicionamento

Para aumentar a eficácia do direcionamento de público-alvo, você pode aproveitar o direcionamento de público-alvo específico por posicionamento. Esse recurso permite que os varejistas ativem o direcionamento de público-alvo por posicionamentos individuais, otimizando métricas de desempenho como taxas de clique (CTR) e taxas de conversão ao adaptar o direcionamento ao contexto e público específicos de cada posicionamento.

* **Controle granular**: Os varejistas podem ativar o direcionamento de público-alvo para posicionamentos específicos, permitindo um direcionamento refinado em contextos como o checkout, mantendo um alcance amplo em posicionamentos como a busca.
* **Maior flexibilidade**: Permite a exclusão de certos posicionamentos do direcionamento de público-alvo para otimizar o alcance e o desempenho.
* **Métricas de desempenho aprimoradas**: Um direcionamento de público-alvo mais relevante em posicionamentos específicos pode levar a melhores taxas de clique (CTR) e de conversão.
* **Interface amigável**: Uma nova interface facilita a configuração simples do direcionamento de público-alvo específico por posicionamento, concedendo aos varejistas maior controle e flexibilidade.

## Como funciona

Os varejistas devem enviar Epsilon Retail Media cada ID de cliente (em formato hash) juntamente com os critérios de direcionamento, seja por meio de um arquivo ou de uma API. Epsilon Retail Media em seguida, cria as perguntas correspondentes na interface do usuário (UI), alinhadas com os dados fornecidos por você. Esse alinhamento permite que os anunciantes foquem suas campanhas de forma eficaz, direcionando-as aos clientes certos no momento ideal.

### Exemplo de feed de dados

Abaixo está um exemplo de como os dados se alinham com o sistema de direcionamento do Epsilon Retail Media:

<figure><img src="/files/CeTOxgdgUXQTckNKcDhX" alt="" width="100%"><figcaption></figcaption></figure>

O exemplo de feed a seguir alinha-se com o exemplo acima:

| `customer_id` | `customer_targeting:type` | `customer_targeting:age-range` |
| ------------- | ------------------------- | ------------------------------ |
| ABC123        | retail                    | 21-30                          |
| ACE246        | corporate                 | 31-40                          |
| ZYX987        | retail                    | 41-50                          |
| 123XBA        | corporate                 | 41-50                          |

{% hint style="info" %}
Faixas etárias

Ao sincronizar faixas etárias como critérios de direcionamento, garanta que elas sejam fornecidas como valores consistentes em faixas estritas.
{% endhint %}

## Limitações

* Ao ativar múltiplos critérios de direcionamento, cada seleção funciona como uma condição OU (OR). Por exemplo, selecionar "Retail", "21-30" e "31-40" resulta no direcionamento de clientes que se enquadram em qualquer uma destas categorias: \[Retail] OU \[21-30] OU \[31-40]. Com base no exemplo de feed acima, apenas o cliente 123XBA não seria direcionado.
* Não especificar todos os valores de direcionamento para um ID de cliente pode degradar a qualidade da campanha. Para obter mais informações, consulte [exemplos detalhados de comportamento](/retail-media-interface/integration/pt-br/data-api/customer-data/in-depth-behaviour-examples.md).
* Cada cliente só pode ser atribuído com um único atributo por `customer_targeting` critério:
  * No exemplo acima, um `customerId` não pode ser atribuído com "Retail" e "Corporate", o que significa que você não pode criar um grupo de direcionamento de "Categorias recentes" ou similar, pois cada cliente terá apenas um valor atribuído.
  * Recomendamos o uso de dados qualitativos, pois são mais orientados a respostas únicas por usuário (por exemplo, idade: 18-25).
* O direcionamento de público-alvo é habilitado por tipo de anúncio, não por posicionamento.
* O direcionamento de público-alvo não pode ser habilitado no mesmo tipo de anúncio que as campanhas de posicionamento fixo.


---

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