> 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/it/feature-integrations/integrating-parent-products.md).
# Integrazione dei prodotti padre
## Che cos'è un prodotto figlio?
Alcuni prodotti hanno relazioni padre/figlio. Esiste un prodotto padre e poi diverse variazioni rappresentano i prodotti figli. Gli inserzionisti vogliono ottimizzare le campagne a livello di prodotto figlio per assicurarsi di promuovere ai clienti i prodotti più pertinenti e con le migliori prestazioni.
Altri prodotti non avranno queste relazioni e pertanto non vedranno modifiche o impatti nella piattaforma.
## Funzionalità dell'interfaccia utente
### Selezione dei prodotti
Durante la selezione dei prodotti, i prodotti padre/figlio verranno raggruppati.
È possibile fare clic su un prodotto padre per espanderlo e mostrare i prodotti figli. Ciò consentirà ai tuoi inserzionisti di ottimizzare la campagna a un livello di singolo prodotto figlio.
### Reportistica
La reportistica integrata nella piattaforma raggrupperà automaticamente per prodotto padre quando a un prodotto è associato un `productCollection` associato.
Nelle esportazioni CSV dalla piattaforma, per i codici prodotto è presente una nuova colonna "Parent Code", che popolerà il valore `productCollection` valore.
Se si filtra per codice prodotto nell'interfaccia utente, le metriche del prodotto padre risultano vuote ed è possibile fare clic sul prodotto padre per mostrare la reportistica per qualsiasi prodotto figlio.
## Requisiti di integrazione
### Aggiornamento dei prodotti
Quando si sincronizzano i prodotti con Epsilon Retail Media, è presente un nuovo campo `productCollection` nella richiesta POST per i tuoi prodotti.
```http
POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"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 questo campo è presente, le tabelle di selezione dei prodotti e di reportistica si aggregheranno a livello di collezione di prodotti per tutti i prodotti che hanno lo stesso `productCollection`.
Se si effettua la sincronizzazione tramite file, è presente una colonna `product_collection` che è possibile popolare facoltativamente per ciascun prodotto.
### Rendering degli annunci
Non sono necessarie modifiche per il rendering degli annunci da Epsilon Retail Media. Il `gtin` che ricevi nella risposta dell'API sarà quello del prodotto "figlio" e dovrai eseguirne il rendering sul tuo sito web per i tuoi clienti.
---
# 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/it/feature-integrations/integrating-parent-products.md?ask=&goal=
```
`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.