> 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/brand-pages/brand-page-retailer-integration-guide/integration-architecture.md).

# Arquitetura de integração

## Componentes de integração

**Componentes necessários**

1. Cliente da API – Busca o conteúdo da página da marca.
2. Renderizador de conteúdo – Exibe módulos no seu site. Trata módulos e campos que possam estar ausentes ou vazios sem gerar erros; recorre a alternativas ou oculta blocos de UI quando dados opcionais do criativo estiverem ausentes.
3. Manipulador de rastreamento – Compõe URLs de rastreamento a partir de `trackingTemplates` e por espaço `trackers.<slot>params`, depois dispara eventos C2S e/ou S2S.
4. Proxy reverso – Roteia o rastreamento através do seu domínio.

Esta seção descreve a sequência de tempo de execução de alto nível para veiculação e rastreamento.

## Fluxo de integração

**Opções de rastreamento (Escolha uma)**

| Método                 | Quando usar                                                                                                                                                                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| (Client-to-Server) C2S | Implementação web padrão: pixels de impressão baseados no navegador mais redirecionamentos de clique ou beacons de evento (cliques e adicionar ao carrinho). Esta abordagem é fortemente recomendada pela Epsilon para a maioria dos varejistas. |
| (Server-to-Server) S2S | Use quando sua arquitetura exigir o disparo de eventos no lado do servidor, quando os pixels no lado do cliente forem não confiáveis ou quando você desejar uma confirmação no lado do servidor além do C2S.                                     |

{% hint style="info" %}
**Um proxy reverso é necessário apenas para o rastreamento C2S (navegador). As chamadas S2S vão diretamente para o Epsilon host de rastreamento usando URLs que você compõe a partir de `trackingTemplates.server`** **`+`** **`trackers.<slot>params` (mesma receita do C2S, sem `BASEURL`). Não roteie chamadas S2S através de um proxy reverso nem modifique o host ou caminho do modelo.**
{% endhint %}

<br>


---

# 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/brand-pages/brand-page-retailer-integration-guide/integration-architecture.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.