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

# Integración de productos primarios

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

## ¿Qué es un producto secundario?

Algunos productos tienen relaciones primario/secundario. Existe un producto primario y, a continuación, varias variaciones son los productos secundarios. Los anunciantes quieren optimizar las campañas a nivel de producto secundario para asegurarse de que promocionan los productos más relevantes y con mejor rendimiento ante los clientes.

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

Otros productos no tendrán estas relaciones y, por lo tanto, no verán ningún cambio ni impacto en la plataforma.

## Funcionalidades de la interfaz de usuario

### Selección de productos

Al seleccionar productos, los productos primarios/secundarios se agruparán.

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

Puede hacer clic en un producto primario y se desplegará para mostrar los productos secundarios. Esto permitirá a sus anunciantes optimizar a un nivel único de producto secundario en la campaña.

### Informes

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

Los informes dentro de la plataforma se agruparán automáticamente por producto primario cuando un producto tenga un `productCollection` asociado.

En las exportaciones CSV de la plataforma, para los códigos de producto hay una nueva columna "Código primario", que completará el valor de `productCollection` .

Si se filtra por código de producto en la interfaz de usuario, las métricas del producto primario aparecerán en blanco, y se puede hacer clic en el producto primario para mostrar los informes de cualquier producto secundario.

## Requisitos de integración

### Actualización de productos

Al sincronizar productos con Epsilon Retail Media, hay un nuevo campo `productCollection` en la solicitud POST para sus productos.

```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"
            ]
        }
    ]
```

Cuando este campo esté presente, la selección de productos y las tablas de informes se agregarán a nivel de colección de productos para todos los productos que tengan el mismo `productCollection`.

Si realiza la sincronización por archivo, hay una columna `product_collection` que puede completar opcionalmente por producto.

### Renderización de anuncios

No se necesitan cambios al renderizar anuncios desde Epsilon Retail Media. El `gtin` que reciba en la respuesta de la API será el del producto "secundario", y tendrá que renderizarlo en su sitio web para sus 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/es/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.
