> 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/data-api/catalog-products-2/syncing-catalog-products-via-file.md). # Sincronizzazione di catalogo e prodotti tramite file Epsilon Retail Media supporta due tipi di formato per la sincronizzazione dei dati sui prodotti tramite file: * TSV * CSV Questa sezione descrive le strutture di ciascun formato file per i dati dei prodotti che elaboriamo in Epsilon Retail Media. ## Dimensione massima del file Epsilon Retail Media è in grado di supportare file di catalogo fino a 10 milioni di prodotti per rivenditore, consentendo la maggior parte dei cataloghi di dimensioni da marketplace. {% hint style="info" %} Hai più di 10 milioni di prodotti? Se il tuo catalogo supera questo volume, Epsilon Retail Media può valutare se la dimensione del tuo catalogo è supportabile. Tieni presente che ciò potrebbe richiedere anche modifiche commerciali {% endhint %} ## File TSV/CSV La tabella seguente illustra i nomi delle colonne e la descrizione delle colonne per i prodotti in un file TSV/CSV. In questa tabella indichiamo anche le colonne obbligatorie che devono essere fornite in un file. Quando una colonna è obbligatoria, tutti i valori nella colonna devono essere forniti nelle sue righe. {% hint style="warning" %} ️ TSV senza virgolette I file TSV non possono essere nel formato tra virgolette. Durante la sincronizzazione tramite TSV, assicurati di sincronizzare file senza virgolette. {% endhint %} ### Nomi delle colonne e descrizioni dei dati di prodotto nei file TSV/CSV | Nome colonna | Obbligatorio/facoltativo | Tipo di dato | Descrizione | Esempio | | ------------------------ | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `product_code` | Obbligatorio |

Testo
Max 50 caratteri

| Un codice per identificare il prodotto nel tuo sistema. Questo campo è identico ai campi gtin e item nella sincronizzazione via API e file XML. | F153212AN1 | | `name` | Obbligatorio |

Testo
Max 150 caratteri

| Il nome del prodotto. | SS Sticker Tee - Kids | | `image_url` | Obbligatorio |

Url
Max 2048 caratteri

| Un collegamento ipertestuale all'immagine di un prodotto. Deve essere un URL valido. | | | `inventory` | Obbligatorio |

Numero
Si consiglia un intero non firmato a 32 bit

| L'inventario del prodotto. Se il valore è 0, gli annunci del prodotto non verranno pubblicati per il prodotto. | 1 | | `description` | Obbligatorio |

Testo
Max 5000 caratteri

| La descrizione del prodotto. | Con Trifogli ricamati e 3-Stripes con profilo bianco a contrasto, gli Sport Sweat Shorts sono una nuova proposta di Adidas Originals. | | `KEY (as a value)` | Obbligatorio per i posizionamenti di categoria e display generico |

Testo
Max 1000 caratteri per colonna

|

Se si utilizza questo tipo di colonna, i rivenditori devono fornire un valore per \.

È possibile avere diverse colonne con questa sintassi in un file TSV.

| Il nome della colonna può essere “brand” e il valore della cella nella colonna può essere “green-fairy”. Ciò comporterà un filtro di "brand:green-fairy" sul prodotto. | | `subClassName` |

Deprecato.
Obbligatorio per i posizionamenti di vendita incrociata/up-selling di prodotti

|

Testo
Max 750 caratteri

|

Il nome della sottocategoria/categoria in cui si trova il prodotto pertinente.

Le sottocategorie consentono un targeting del prodotto migliore, ad es. un prodotto a base di burro può targettizzare il pane, ma non targettizzerà i cerotti.

| Cheese | | `xSellSubClassName` |

Deprecato.
Obbligatorio per i posizionamenti di vendita incrociata/up-selling di prodotti

|

Testo
Max 750 caratteri

| I nomi delle sottocategorie/categorie in cui il prodotto pertinente è in grado di targettizzare i prodotti. | Breads, Spreads, Crackers | | `price` | Facoltativo |

Numero
Si consigliano 2 cifre decimali

| Il prezzo di un prodotto. | 30.00 | | `brand` | Obbligatorio |

Testo
Max 70 caratteri

| Il marchio del prodotto. | Tommy Hilfiger | | `type` | Obbligatorio |

Testo
Max 750 caratteri

| Il tipo di prodotto. | Clothing | | `retailer_taxonomy` | Obbligatorio per l'attribuzione avanzata. Non deve contenere spazi tra `>` i caratteri |

Testo
Max 750 caratteri

| La tua tassonomia del prodotto specifica del rivenditore. | Men>Men's Clothing>Sweaters | | `google_taxonomy` | Obbligatorio per l'attribuzione avanzata se `retailer_taxonomy` non può essere fornito |

Testo
Max 750 caratteri

| La tassonomia standard Google del prodotto. Maggiori informazioni sono disponibili qui: | Abbigliamento e accessori > Abbigliamento > Top | | `global_identifier` | Obbligatorio |

Testo
Max 50 caratteri

| L'identificatore globale del prodotto. | 08719108994761 | | `global_identifier_type` | Obbligatorio | Testo | Il tipo di identificatore globale. | GTIN | | `custom_payload` | Non richiesto se non consigliato. | Array di byte codificato in Base64 | Questo campo contiene un payload personalizzato che deve essere trasmesso alla generazione dell'annuncio. Il campo deve contenere un oggetto JSON valido serializzato in un array di byte e codificato in Base64. L'oggetto JSON deve essere conforme a uno schema. | Vedere la sezione sui payload personalizzati. | | `hfss` | Facoltativo | Booleano | Utilizzato per indicare se un prodotto è HFSS o meno. Questo viene ulteriormente sfruttato nell'interfaccia utente di Epsilon Retail Media. Visualizza il nostro [Documentazione HFSS](/retail-media-interface/integration/it/feature-integrations/placement-level-product-type-blocking-hfss-support.md) per ulteriori informazioni. | true | | `seller_id` | Facoltativo |

Testo
Max 50 caratteri

|

L'ID univoco del venditore. Richiesto solo se si esegue l'onboarding di venditori del marketplace. Può essere lasciato vuoto per i prodotti non del marketplace.

Ci sono requisiti aggiuntivi per integrare seller\_ids, fare riferimento a sellerId del Marketplace per ulteriori informazioni.

| aes-de4-ss | Di seguito è possibile vedere un file di esempio rappresentato come tabella: | `product_code` | `name` | `image_url` | `inventory` | `description` | `filter:Category` | `filter:Size` | `filter:Country` | `groups` | `price` | `brand` | `type` | `retailer_taxonomy` | `google_taxonomy` | `global_identifier` | seller\_id | subClassName | xSellSubClassName | | -------------- | --------------------------------------------- | ------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ------------- | ---------------- | ----------------------------------- | ------- | ----------- | -------- | --------------------------------- | ------------------------------------------------------------------------------- | ------------------- | ----------------- | ----------------- | ----------------- | | 80591101 | Confezione regalo Absinthe Green Fairy 500 mL | | `20` | Questa confezione regalo con assenzio e cucchiaio Green Fairy è il regalo perfetto per ogni amante dell'assenzio o dei cocktail. Metti una zolletta di zucchero sul cucchiaio e versa l'assenzio sopra per bere questo distillato nel modo autentico! | Regali, Alcolici, Confezioni regalo | 500ml | Repubblica Ceca | Regali, Alcolici, Confezioni regalo | `5.00` | Green Fairy | Alcolici | Regali>Alcolici>Confezioni regalo | Cibi, bevande e tabacco>Bevande>Bevande alcoliche>Liquori e distillati>Assenzio | 8594001443079 | 7328s-dmie3-9jdae | Confezioni regalo | Liquori | {% hint style="info" %} I file TSV non possono essere nel formato tra virgolette. {% endhint %} ## Aggiornamento delle immagini dei prodotti Epsilon memorizza nella cache gli URL delle immagini per garantire prestazioni coerenti e ridurre le richieste al server delle immagini. Se aggiorni un'immagine senza modificarne l'URL, devi attivare esplicitamente un aggiornamento in Epsilon. Per fare questo: * Rimuovi l'image\_url esistente dal prodotto. * Invia di nuovo lo stesso image\_url una volta completato l'aggiornamento. In alternativa, se il tuo server di immagini lo supporta, puoi forzare un aggiornamento aggiungendo una stringa di query (ad esempio, una versione o un timestamp) all'URL esistente. Ciò farà sì che Epsilon ricarichi l'immagine.. {% hint style="info" %} Le immagini vengono utilizzate solo nell'interfaccia utente Le immagini dei prodotti non vengono servite nelle risposte pubblicitarie. Eventuali aggiornamenti delle immagini influiscono solo sul modo in cui il prodotto viene visualizzato nell'interfaccia utente di Epsilon mentre si verifica l'aggiornamento della cache. {% endhint %} ## File XML - pianificata la deprecazione {% hint style="danger" %} ️ Deprecato per i nuovi clienti Quanto segue è fornito per i clienti legacy che utilizzano ancora il formato XML. Per l'onboarding del nuovo catalogo, supportiamo i formati TSV e CSV documentati sopra, che offrono una maggiore flessibilità dei file e l'opportunità di sincronizzare il file più volte al giorno. {% endhint %} Epsilon Retail Media ha definito un elenco di tag utilizzati per descrivere un documento XML per i prodotti. La tabella seguente illustra i tag e le relative descrizioni. Il tag "item" viene utilizzato per descrivere un prodotto in un documento XML. Tutti gli altri tag per gli altri campi devono essere scritti all'interno di questo tag. | Tag XML | Obbligatorio/facoltativo | Descrizione | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `item` | Obbligatorio | Questo tag viene utilizzato per descrivere un prodotto. Tutti gli altri tag XML per un prodotto devono trovarsi all'interno di questo tag. Un documento XML per i prodotti deve contenere un elenco di tag item. Questo campo è identico ai campi gtin e product\_code nella sincronizzazione dei file API e TSV. | | `id` | Obbligatorio | Un codice per identificare il prodotto nel sistema. Equivalente di `product_code` nei file TSV. Questo campo è identico ai campi gtin e item nella sincronizzazione dei file API e XML. | | `title` | Obbligatorio | Il nome del prodotto. | | `image_link` |

Obbligatorio
Max 50 caratteri

| Un collegamento ipertestuale all'immagine di un prodotto. Deve essere un URL valido. | | `brand` |

Obbligatorio
Max 70 caratteri

| Il marchio del prodotto. | | `availability` |

Obbligatorio
Si consiglia un intero non firmato a 32 bit

| Questo tag serve per descrivere l'inventario di un prodotto. Il valore deve essere un numero. | | `description` |

Obbligatorio
Max 5000 caratteri

| Questo tag serve per descrivere la descrizione di un prodotto. | | `price` |

Facoltativo
Si consigliano 2 cifre decimali

| Questo tag serve per descrivere il prezzo di un prodotto. Se il valore all'interno del tag viene fornito, deve essere un numero. | | `type` |

Facoltativo
Max 750 caratteri

| Il tipo di prodotto. | | `retailer_taxonomy` |

Richiesto per l'attribuzione avanzata. Richiesto anche per le integrazioni delle categorie.
Max 750 caratteri

| La tua tassonomia del rivenditore individuale del prodotto. ad es. Uomo>Abbigliamento uomo>Maglioni | | `google_taxonomy` |

Obbligatorio per l'attribuzione avanzata se retailer\_taxonomy non può essere fornito
Max 750 caratteri

| La tassonomia standard Google del prodotto. Maggiori informazioni sono disponibili qui: | | `global_identifier` |

Obbligatorio
Max 50 caratteri

| L'identificatore globale per il prodotto. ad es. `08719108994761` | | `global_identifier_type` | Obbligatorio | Il tipo di identificatore globale. ad es. `GTIN` | | `custom_payload` | Non richiesto se non consigliato. | Questo campo contiene un payload personalizzato che deve essere trasmesso alla generazione dell'annuncio. Il campo deve contenere un oggetto JSON valido serializzato in un array di byte e codificato in Base64. L'oggetto JSON deve essere conforme a uno schema. | | `hfss` | Facoltativo | Utilizzato per indicare se un prodotto è HFSS o meno. Questo viene ulteriormente sfruttato nell'interfaccia utente di Epsilon Retail Media. Visualizza il nostro [Documentazione HFSS](/retail-media-interface/integration/it/feature-integrations/placement-level-product-type-blocking-hfss-support.md) per ulteriori informazioni. | | `seller_id` |

Facoltativo
Max 50 caratteri

|

L'ID univoco del venditore. Richiesto solo se si esegue l'onboarding di venditori del marketplace. Può essere lasciato vuoto per i prodotti non del marketplace.

Ci sono requisiti aggiuntivi per integrare seller\_ids, fare riferimento a sellerId del Marketplace per ulteriori informazioni.

| Di seguito viene descritto un esempio di documento XML valido con i tag: ```xml 80591011 Melissa & Doug Dinosaur Stamp Set, 4yrs+ Imagine a rugged landscape littered with volcanoes, and full of dinosaurs roaming around https://www.retailer.com/productImages/image1.jpg £9.99 Melissa & Doug Food Cupboard 10 true 87086011 Waitrose Splits Strawberry Ice Lollies Strawberry splits; Suitable for vegetarians. Strawberry splits vanilla flavoured ice cream with a fruity strawberry ice coating. Our fundamental belief is that few things in life are more important than the food you buy. Good quality is essential. https://www.retailer.com/productImages/image2.jpg £1.25 Waitrose Frozen Ice Cream Ice Cream Lollies 20 Waitrose false 432un3-sd32s-ssaar ``` ## Payload personalizzati ### Cosa sono i payload personalizzati? I payload personalizzati sono campi che vengono trasmessi "così come sono" dall'ingestione del catalogo all'erogazione dell'annuncio. Nessuna trasformazione verrà applicata al campo. Tuttavia, sul campo viene eseguita una convalida basata su Schema JSON (). La specifica del payload viene fornita tramite il collegamento sottostante (notazione Schema JSON): Nella risposta dell'annuncio del prodotto, l'esatto payload personalizzato viene restituito all'integratore in un campo denominato `customPayload`. Di seguito viene fornito un esempio di payload valido: ```json { "id": "102013703", "upc": "4400000463", "name": "Bee Farms Honey - 14.4 Oz", "nutrientName": [ "Kosher" ], "description": "Honey", "brand": "Bee Farms", "imageUrl": "https://www.retailer.com/products/1/image.png", "productUrl": "https://www.retailer.com/products/1/page.html", "aisleId": "1_22_2_3", "departmentName": "Breakfast ", "aisleName": "Breakfast spreads", "shelfName": "Honeu", "salesRank": 481, "details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.", "averageWeight": 0, "displayType": 0, "stores": [ { "storeId": "2543", "price": 3.99, "salePrice": 0.28, "pricePer": 4.99, "unitOfMeasure": "OUNCE", "restrictedFlag": false, "sellByWeight": false, "promoDescription": "I", "promoText": "Club Price: $3.99<BR>SAVE up to: $1", "promoType": "P", "offerFlag": true }, { "storeId": "2544", "price": 3.99, "salePrice": 0.28, "pricePer": 4.99, "unitOfMeasure": "OUNCE", "restrictedFlag": false, "sellByWeight": false, "promoDescription": "I", "promoText": "Club Price: $3.99<BR>SAVE up to: $1", "promoType": "P", "offerFlag": true } ] } ``` {% hint style="warning" %} Solo file Tieni presente che i payload personalizzati sono supportati solo durante la sincronizzazione dei prodotti tramite file. {% endhint %} ### Payload personalizzati nella generazione di annunci Quando vengono restituiti annunci prodotto, il payload personalizzato viene passato come parte dell'annuncio generato. I payload degli annunci restituiti conterranno un campo aggiuntivo `customPayload` che conterrà un oggetto JSON conforme alla stessa specifica delle informazioni fornite nel feed. Un esempio di risposta potrebbe essere: ```json { "ads": [ { "id": "display_SEY2W7-VZzspoirbw4ANs-r-w6YyODk5MDQ5UA==", "gtin": "4400000463", "customPayload": { "id": "102013703", "upc": "4400000463", "name": "Bee Farms Honey - 14.4 Oz", "nutrientName": [ "Kosher" ], "description": "Honey", "brand": "Bee Farms", "imageUrl": "https://www.retailer.com/products/1/image.png", "productUrl": "https://www.retailer.com/products/1/page.html", "aisleId": "1_22_2_3", "departmentName": "Breakfast ", "aisleName": "Breakfast spreads", "shelfName": "Honeu", "salesRank": 481, "details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.", "averageWeight": 0, "displayType": 0, "stores": [ { "storeId": "2543", "price": 3.99, "salePrice": 0.28, "pricePer": 4.99, "unitOfMeasure": "OUNCE", "restrictedFlag": false, "sellByWeight": false, "promoDescription": "I", "promoText": "Club Price: $3.99<BR>SAVE up to: $1", "promoType": "P", "offerFlag": true }, { "storeId": "2544", "price": 3.99, "salePrice": 0.28, "pricePer": 4.99, "unitOfMeasure": "OUNCE", "restrictedFlag": false, "sellByWeight": false, "promoDescription": "I", "promoText": "Club Price: $3.99<BR>SAVE up to: $1", "promoType": "P", "offerFlag": true } ] } , "discount": { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 }, "expiry": "2019-12-10T01:46:07.516943179Z" } ], "banners": [], "products": [] } ``` {% hint style="warning" %} Poiché i payload personalizzati rappresentano un carico di lavoro aggiuntivo per il nostro servizio di generazione di annunci, si prega di notare che le integrazioni di payload personalizzati non sono soggette a Epsilon Retail Media SLA, se non diversamente specificato. {% endhint %} --- # 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/data-api/catalog-products-2/syncing-catalog-products-via-file.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.