> 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/feature-integrations/integrating-parent-products.md).

# Integrando produtos pai

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

## O que é um produto filho?

Alguns produtos têm relações pai/filho. Existe um produto pai, e várias variações são os produtos filhos. Os anunciantes querem otimizar as campanhas no nível do produto filho para garantir que estão promovendo os produtos mais relevantes e de melhor desempenho para os clientes.

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

Outros produtos não terão essas relações e, portanto, não verão nenhuma alteração ou impacto na plataforma.

## Recursos da UI

### Seleção de produtos

Ao selecionar produtos, os produtos pai/filho serão agrupados.

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

Você pode clicar em um produto pai e ele se expandirá para mostrar os produtos filhos. Isso permitirá que seus anunciantes otimizem para um nível único de produto filho na campanha.

### Relatórios

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

Os relatórios na plataforma serão agrupados automaticamente pelo produto pai quando um produto tiver um `productCollection` associado a ele.

Nas exportações em CSV da plataforma, há uma nova coluna "Parent Code" para os códigos de produto, que preencherá o valor de `productCollection` .

Se filtrar por código de produto na UI, as métricas do produto pai ficarão em branco, e o produto pai poderá ser clicado para mostrar os relatórios de quaisquer produtos filhos.

## Requisitos de integração

### Atualizando produtos

Quando você sincroniza produtos com o Epsilon Retail Media, há um novo campo `productCollection` no pedido POST para seus produtos.

```http
POST $BASE_URL/v1/catalog-products?teamId=<YOUR_TEAM_ID> HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogProducts": [
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965543",
            "productCollection": "abc-123",
            "inventory": 50,
            "price": "19.99",
            "tags": [
                 "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
            ],
            "filters": [
                 "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"
            ]
        }
    ]
```

Quando este campo estiver presente, as tabelas de seleção de produtos e relatórios serão agregadas no nível da coleção de produtos para todos os produtos que tiverem o mesmo `productCollection`.

Se você estiver sincronizando por arquivo, há uma coluna `product_collection` que você pode preencher opcionalmente por produto.

### Renderização de anúncios

Não são necessárias alterações ao renderizar anúncios do Epsilon Retail Media. O `gtin` que você recebe na resposta da API será o do produto "filho", e você precisará renderizá-lo em seu site para seus clientes.


---

# 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/feature-integrations/integrating-parent-products.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.
