> 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/api-overview/integration-workflow-options-1.md).

# Opções de fluxo de trabalho de integração de anúncios para varejistas

Epsilon's Retail Media A integração padrão garante que seu site ofereça uma experiência de usuário fluida, apresentando anúncios relevantes rapidamente aos clientes. Como varejista, você só precisa sincronizar seu catálogo de produtos e dados de clientes com Epsilon's Retail Media. É importante notar que Epsilon Retail Media é integrado por meio do backend do varejista. A integração garante que anúncios relevantes sejam exibidos em seu site, aprimorando a experiência de compra do usuário ao mesclar anúncios com o conteúdo orgânico. Aqui estão algumas das principais vantagens:

1. **Experiência de usuário aprimorada**: Os anúncios são integrados perfeitamente ao conteúdo orgânico, proporcionando uma experiência de navegação fluida.
2. **Relevância**: Os anúncios são contextualmente relevantes, aumentando o engajamento do usuário.
3. **Eficiência**: A entrega rápida do conteúdo do anúncio melhora o tempo de carregamento da página.
4. **Relatórios**: Obtenha informações detalhadas sobre impressões de anúncios, cliques e pedidos.

## Integração padrão

O fluxo de trabalho de integração padrão envolve as seguintes etapas:

1. Sincronizar dados
2. Veicular anúncios
3. Relatar ações

{% hint style="info" %}
Os clientes não veem os anúncios até que eles sejam mesclados em uma lista final. Isso garante que eles recebam informações completas e precisas.
{% endhint %}

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

### Fluxo de trabalho

Aqui está a série de eventos:

#### Antes de veicular os anúncios

**Sincronizar dados do produto**: Sincronize seu catálogo de produtos com Epsilon Retail Media usando a [API](https://developers.citrusad.com/integration/docs/use-apis) ou uma [sincronização de arquivos](https://developers.citrusad.com/integration/docs/use-apis)diária. Opcionalmente, sincronize seus dados de clientes com Epsilon Retail Media usando a API ou uma sincronização de arquivos diária.

#### Quando os anúncios são veiculados

1. **O cliente visita seu site**: Um cliente abre seu site e navega até uma página específica onde Epsilon’s Retail Media está integrado.
2. **O site solicita dados**: Seu site solicita dados do seu servidor backend com base no contexto da página (por exemplo, `customerId`, `sessionId`, `dtmCookieID`, `productFilters`).
3. O backend solicita anúncios a Epsilon Retail Media: Seu servidor backend chama a Epsilon Retail Media API, solicitando anúncios relevantes ao contexto da página do cliente.
4. **Epsilon Retail Media Retorna anúncios relevantes**: Epsilon Retail Media retorna os anúncios mais relevantes para a solicitação, incluindo códigos de produtos e URLs para anúncios de banner.
5. **Mesclar anúncios com conteúdo orgânico**: Seu servidor backend mescla a resposta de anúncios de Epsilon Retail Media com o conteúdo orgânico do seu site.
6. **Veicular todo o conteúdo ao cliente**: Seu servidor envia os anúncios combinados e o conteúdo orgânico para o navegador do cliente em uma única resposta.

#### Depois que os anúncios são veiculados

1. **Relatar impressões**: Quando o cliente visualiza um anúncio, uma impressão é relatada a Epsilon Retail Media para o indivíduo adId.
2. **Relatar cliques**: Quando o cliente clica em um anúncio, um clique é relatado a Epsilon Retail Media para o indivíduo `adId`.
3. **Relatar pedidos**: Quando o cliente conclui uma compra, os detalhes do pedido (itens, preços, quantidades) junto com `customerId`, `sessionId`, `dtmCookieId` são relatados a Epsilon Retail Media.

## Opções flexíveis de integração

Epsilon Retail Media também oferece dois métodos adicionais de integração adaptados para atender às diferentes necessidades e preferências dos varejistas. Cada método tem suas vantagens e desvantagens exclusivas, permitindo que os varejistas escolham a abordagem mais adequada com base em seus requisitos específicos e capacidades técnicas.

### Abordagem 1: Solicitações individuais do navegador

Esta abordagem envolve chamadas de backend separadas para produtos orgânicos e anúncios, reduzindo modificações no backend e garantindo que os usuários sempre vejam as listagens mais atualizadas. Aqui estão alguns dos benefícios para os varejistas ao usar esta abordagem:

* **Tempo de desenvolvimento reduzido**: Mais fácil de implementar com alterações mínimas no backend, economizando tempo e recursos de desenvolvimento.
* **Listagens atualizadas**: Garante que o conteúdo de anúncio mais recente seja exibido, potencialmente aumentando a relevância do anúncio e o engajamento do usuário.

#### Fluxo de trabalho

Aqui está a série de eventos:

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

#### Quando os anúncios são veiculados

No caso de solicitações do navegador, a veiculação de anúncios difere da integração padrão da seguinte forma:

**Tratamento de solicitações**

* As listagens de produtos ficam ocultas do usuário até que as listagens orgânicas sejam mescladas com as listagens do Epsilon Retail Media .
* Em vez de fazer com que seu serviço de backend existente solicite dados diretamente de Epsilon Retail Media, agora você usa um novo serviço do varejista.
* O serviço do varejista faz a chamada de backend para Epsilon Retail Media com as informações de posicionamento relevantes.
* Mesmo que você entre em contato com seu servidor backend e com Epsilon Retail Media separadamente antes de mesclar, você ainda precisa coletar todos os detalhes de produto necessários para os códigos de produto fornecidos na resposta do Epsilon Retail Media .

**Mesclando e veiculando conteúdo**

* O navegador mescla as listagens orgânicas e o Epsilon Retail Media .
* Após a mesclagem, o navegador veicula o conteúdo combinado ao cliente.

### Abordagem 2: Mesclagem após a exibição ao cliente

Esta abordagem mostra o conteúdo orgânico primeiro e mescla os anúncios depois, exigindo alterações mínimas no backend e garantindo que os usuários recebam acesso ininterrupto às listagens orgânicas.

#### Fluxo de trabalho

Nesta abordagem, você segue um fluxo de trabalho semelhante ao anterior; no entanto, você veicula os resultados de produtos orgânicos ao cliente assim que eles estiverem disponíveis. Depois que os resultados orgânicos forem exibidos, você mescla e reordena os resultados assim que receber o conteúdo do Epsilon Retail Media. Esse método de integração provavelmente levará menos tempo para ser implementado, pois exige recursos mínimos de desenvolvimento.

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

#### Quando os anúncios são exibidos

Listagens orgânicas são mostradas inicialmente, e a Epsilon Retail Media resposta é mesclada assim que o navegador a recebe. Ocasionalmente, as listagens orgânicas são mostradas ao usuário antes da mesclagem e reordenação dos anúncios de produtos. Quando Epsilon Retail Media fornece a você uma lista de códigos de produtos, você ainda precisa buscar todas as informações detalhadas relevantes para cada um desses produtos.

## Comparação dos métodos de integração

Aqui está uma rápida comparação de todos os diferentes métodos de integração que você pode usar:

|                            | Integração padrão                                                         | Solicitações individuais do navegador                          | Mesclagem após a exibição ao cliente                                                     |
| -------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Fluxo de trabalho          | Solicitação única ao backend, mesclar antes de exibir                     | Solicitações separadas para produtos orgânicos e anúncios      | Conteúdo orgânico exibido primeiro, anúncios mesclados posteriormente                    |
| Modificações no backend    | O serviço de backend existente manipula Epsilon Retail Media solicitações | Novo serviço de backend para Epsilon Retail Media solicitações | Mudanças mínimas nos serviços de backend existentes                                      |
| Esforço de desenvolvimento | Moderado                                                                  | Menor                                                          | Mínimo                                                                                   |
| Mesclagem de anúncios      | O backend mescla anúncios com conteúdo orgânico                           | O navegador mescla anúncios com conteúdo orgânico              | O navegador mescla anúncios com conteúdo orgânico                                        |
| Exibição de anúncios       | Anúncios exibidos com conteúdo orgânico                                   | Anúncios exibidos com conteúdo orgânico                        | Anúncios exibidos com conteúdo orgânico                                                  |
| Vantagens                  | - Integração perfeita - Processamento unificado no backend                | - Menos modificação no backend - Lógica de anúncios separada   | - Integração rápida - Alterações mínimas no backend                                      |
| Desvantagens               | - Esforço de desenvolvimento moderado - Lógica de anúncios unificada      | - Serviço de backend adicional - Lógica de anúncios separada   | - Potencial atraso na exibição de anúncios - Anúncios mesclados após o conteúdo orgânico |


---

# 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/api-overview/integration-workflow-options-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.