> 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/sv/data-api/catalog-products-2/syncing-catalog-products-via-file.md). # Synkronisera katalog och produkter via fil Epsilon Retail Media stöder två formattyper för synkronisering av produktdata via fil: * TSV * CSV Det här avsnittet beskriver strukturerna för varje filformat för den produktdata vi behandlar i Epsilon Retail Media. ## Minsta/maximal filstorlek Epsilon Retail Media kan stödja katalogfiler på 10 M produkter eller färre per återförsäljare, vilket möjliggör kataloger i de flesta marknadsplatsstorlekar. {% hint style="info" %} Har du över 10 M produkter? Om din katalog överskrider denna volym, Epsilon Retail Media kan utvärdera om din katalogstorlek kan stödjas. Observera att detta även kan kräva kommersiella justeringar {% endhint %} ## TSV/CSV-filer Tabellen nedan illustrerar kolumnnamnen och beskrivningen av kolumnerna för produkter i en TSV/CSV-fil. I den här tabellen anger vi även de obligatoriska kolumner som krävs i en fil. När en kolumn krävs måste alla värden i kolumnen anges i dess rader. {% hint style="warning" %} ️ Ociterad TSV TSV-filer kan inte vara i citerat format. Vid synkronisering via TSV ska du se till att du synkroniserar ociterade filer. {% endhint %} ### Kolumnnamn och beskrivningar av produktdata i TSV/CSV-filer | Kolumnnamn | Obligatorisk/valfri | Datatyp | Beskrivning | Exempel | | ------------------------ | ---------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `product_code` | Obligatorisk |

Text
Max 50 tecken

| En kod för att identifiera produkten i ditt system. Detta fält är identiskt med fälten gtin och item i API- och XML-filsynkronisering. | F153212AN1 | | `name` | Obligatorisk |

Text
Max 150 tecken

| Produktens namn. | SS Sticker Tee - Kids | | `image_url` | Obligatorisk |

Url
Max 2048 tecken

| En hyperlänk till bilden av en produkt. Måste vara en giltig URL. | | | `inventory` | Obligatorisk |

Nummer
32-bitars osignerat heltal rekommenderas

| Produktens lagersaldo. Om värdet är 0 kommer produktannonser inte att visas för produkten. | 1 | | `description` | Obligatorisk |

Text
Max 5000 tecken

| Beskrivningen av produkten. | Med broderade trefoil-logotyper och konturerade 3-Stripes i kontrasterande vitt är Sport Sweat Shorts ett fräscht tillskott från Adidas Originals. | | `KEY (as a value)` | Krävs för kategori- och breda displayplaceringar |

Text
Max 1000 tecken per kolumn

|

Om denna typ av kolumn används måste återförsäljare ange ett värde för \.

Du kan ha flera kolumner med denna syntax i en TSV-fil.

| Kolumnnamnet kan vara ”brand” och värdet på cellen i kolumnen kan vara ”green-fairy”. Detta resulterar i ett filter på "brand:green-fairy" för produkten. | | `subClassName` |

Föråldrad.
Krävs för korsförsäljnings-/merförsäljningsplaceringar av produkter

|

Text
Max 750 tecken

|

Namnet på den underklass/kategori som den relevanta produkten tillhör.

Underklasser möjliggör bättre produktinriktning, t.ex. kan en smörprodukt riktas mot bröd, men den kommer inte att riktas mot plåster.

| Cheese | | `xSellSubClassName` |

Föråldrad.
Krävs för korsförsäljnings-/merförsäljningsplaceringar av produkter

|

Text
Max 750 tecken

| Namnen på de underklasser/kategorier som den relevanta produkten kan rikta in sig på produkter inom. | Breads, Spreads, Crackers | | `price` | Valfri |

Nummer
2 decimaler rekommenderas

| Priset på en produkt. | 30.00 | | `brand` | Obligatorisk |

Text
Max 70 tecken

| Produktens varumärke. | Tommy Hilfiger | | `type` | Obligatorisk |

Text
Max 750 tecken

| Produkttypen. | Clothing | | `retailer_taxonomy` | Krävs för utökad attribuering. Måste inte ha några mellanslag mellan `>` tecken |

Text
Max 750 tecken

| Din individuella återförsäljartaxonomi för produkten. | Men>Men's Clothing>Sweaters | | `google_taxonomy` | Krävs för utökad attribuering om `retailer_taxonomy` inte kan tillhandahållas |

Text
Max 750 tecken

| Standardtaksonomin för Google för produkten. Mer information finns här: | Kläder & Accessoarer > Kläder > Överdelar | | `global_identifier` | Obligatorisk |

Text
Max 50 tecken

| Den globala identifieraren för produkten. | 08719108994761 | | `global_identifier_type` | Obligatorisk | Text | Typen av global identifierare. | GTIN | | `custom_payload` | Krävs inte om det inte rekommenderas. | Base64-kodad byte-array | Detta fält innehåller en anpassad nyttolast som ska skickas vidare till annonsgenereringen. Fältet ska innehålla ett giltigt JSON-objekt serialiserat till en byte-array och Base64-kodat. JSON-objektet ska följa ett schema. | Se avsnittet om anpassade nyttolaster. | | `hfss` | Valfri | Boolesk | Används för att ange om en produkt är HFSS eller inte. Detta utnyttjas ytterligare i Epsilon Retail Medias användargränssnitt. Se vår [HFSS-dokumentation](/retail-media-interface/integration/sv/feature-integrations/placement-level-product-type-blocking-hfss-support.md) för mer information. | true | | `seller_id` | Valfri |

Text
Max 50 tecken

|

Det unika ID:t för säljaren. Krävs endast vid onboarding av marknadsplatssäljare. Kan lämnas blankt för produkter som inte är från en marknadsplats.

Det finns ytterligare krav för att integrera seller\_ids, vänligen se Marknadsplats sellerId för mer information.

| aes-de4-ss | Ett exempel på en fil representerad som en tabell kan ses nedan: | `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 | Green Fairy Absinth Presentförpackning 500ml | | `20` | Denna Green Fairy Absinth & Sked Presentförpackning är den perfekta presenten för alla absint- eller cocktailälskare. Placera en sockerbit på skeden och häll absinten över toppen för att dricka denna spritdryck på det autentiska sättet! | Gåvor, Alkoholhaltigt, Presentförpackningar | 500ml | Tjeckien | Gåvor, Alkoholhaltigt, Presentförpackningar | `5.00` | Green Fairy | Alkohol | Gåvor>Alkoholhaltigt>Presentförpackningar | Mat, Drycker & Tobak>Drycker>Alkoholhaltiga drycker>Spritdrycker>Absint | 8594001443079 | 7328s-dmie3-9jdae | Presentförpackningar | Sprit drycker | {% hint style="info" %} TSV-filer kan inte vara i citat-formaterat format. {% endhint %} ## Uppdatera produktbilder Epsilon cachar bild-URL:er för att säkerställa konsekvent prestanda och minska anropen till din bildserver. Om du uppdaterar en bild utan att ändra dess URL måste du uttryckligen utlösa en uppdatering i Epsilon. För att göra detta: * Ta bort den befintliga image\_url från produkten. * Skicka om samma image\_url när uppdateringen är klar. Alternativt, om din bildserver stöder det, kan du tvinga fram en uppdatering genom att lägga till en frågesträng (till exempel en version eller tidsstämpel) till den befintliga URL:en. Detta gör att Epsilon läser in bilden igen.. {% hint style="info" %} Bilder används endast i användargränssnittet Produktbilder skickas inte i annonssvar. Alla bilduppdateringar påverkar endast hur produkten visas i Epsilon användargränssnittet medan cacheuppdateringen sker. {% endhint %} ## XML-filer – planeras att avvecklas {% hint style="danger" %} ️ Föråldrad för nya kunder Nedanstående tillhandahålls för befintliga kunder som fortfarande använder XML-format. För ny katalog-onboarding stöder vi TSV- och CSV-format som dokumenteras ovan, vilket ger större filflexibilitet samt möjlighet att synkronisera filen flera gånger per dag. {% endhint %} Epsilon Retail Media har definierat en lista över taggar som används för att beskriva ett XML-dokument för produkter. Tabellen nedan visar taggarna och deras beskrivningar. Taggen ”item” används för att beskriva en produkt i ett XML-dokument. Alla andra taggar för de andra fälten måste skrivas inuti denna tagg. | XML-taggar | Obligatorisk/valfri | Beskrivning | | ------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `item` | Obligatorisk | Denna tagg används för att beskriva en produkt. Alla andra XML-taggar för en produkt måste finnas inuti denna tagg. Ett XML-dokument för produkter måste innehålla en lista med item-taggar. Detta fält är identiskt med fälten gtin och product\_code vid synkronisering via API och TSV-fil. | | `id` | Obligatorisk | En kod för att identifiera produkten i ditt system. Motsvarighet till `product_code` i TSV-filer. Detta fält är identiskt med fälten gtin och item vid synkronisering via API och XML-fil. | | `title` | Obligatorisk | Produktens namn. | | `image_link` |

Obligatorisk
Max 50 tecken

| En hyperlänk till bilden av en produkt. Måste vara en giltig URL. | | `brand` |

Obligatorisk
Max 70 tecken

| Produktens varumärke. | | `availability` |

Obligatorisk
32-bitars osignerat heltal rekommenderas

| Denna tagg är till för att beskriva lagret för en produkt. Värdet måste vara ett nummer. | | `description` |

Obligatorisk
Max 5000 tecken

| Denna tagg är till för att beskriva en beskrivning av en produkt. | | `price` |

Valfri
2 decimaler rekommenderas

| Denna tagg är till för att beskriva priset på en produkt. Om värdet inuti taggen anges måste det vara ett nummer. | | `type` |

Valfri
Max 750 tecken

| Produkttypen. | | `retailer_taxonomy` |

Krävs för förbättrad attribuering. Krävs även för kategoriintegrationer.
Max 750 tecken

| Din individuella återförsäljartaxonomi för produkten. t.ex. Herr>Herrkläder>Tröjor | | `google_taxonomy` |

Krävs för utökad attribuering om retailer\_taxonomy inte kan tillhandahållas
Max 750 tecken

| Standardtaksonomin för Google för produkten. Mer information finns här: | | `global_identifier` |

Obligatorisk
Max 50 tecken

| Den globala identifieraren för produkten. t.ex. `08719108994761` | | `global_identifier_type` | Obligatorisk | Typen av global identifierare. t.ex. `GTIN` | | `custom_payload` | Krävs inte om det inte rekommenderas. | Detta fält innehåller en anpassad nyttolast som ska skickas vidare till annonsgenereringen. Fältet ska innehålla ett giltigt JSON-objekt serialiserat till en byte-array och Base64-kodat. JSON-objektet ska följa ett schema. | | `hfss` | Valfri | Används för att ange om en produkt är HFSS eller inte. Detta utnyttjas ytterligare i Epsilon Retail Medias användargränssnitt. Se vår [HFSS-dokumentation](/retail-media-interface/integration/sv/feature-integrations/placement-level-product-type-blocking-hfss-support.md) för mer information. | | `seller_id` |

Valfri
Max 50 tecken

|

Det unika ID:t för säljaren. Krävs endast vid onboarding av marknadsplatssäljare. Kan lämnas blankt för produkter som inte är från en marknadsplats.

Det finns ytterligare krav för att integrera seller\_ids, vänligen se Marknadsplats sellerId för mer information.

| Ett exempel på ett giltigt XML-dokument med taggarna beskrivs nedan: ```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 ``` ## Anpassade nyttolaster ### Vad är anpassade nyttolaster? Anpassade nyttolaster är fält som skickas vidare ”som de är” från katalogingestion till annonsvisning. Inga transformeringar kommer att tillämpas på fältet. Validation baserad på JSON Schema () utförs dock på fältet. Specifikationen för nyttolasten tillhandahålls via länken nedan (JSON Schema-notation): I produktannonssvaret returneras den exakta anpassade nyttolasten till integratören i ett fält med namnet `customPayload` Ett exempel på en giltig nyttolast tillhandahålls nedan: ```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" %} Endast fil Observera att anpassade nyttolaster endast stöds vid synkronisering av produkter via fil. {% endhint %} ### Anpassade nyttolaster i skapande av annonser När produktannonser returneras skickas den anpassade nyttolasten med som en del av den skapade annonsen. De returnerade annonsnyttolasterna kommer att innehålla ett ytterligare fält `customPayload` som kommer att innehålla ett JSON-objekt som följer samma specifikation som informationen i flödet. Ett exempel på ett svar kan vara: ```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" %} Eftersom anpassade nyttolaster innebär ytterligare arbetsbelastning för vår tjänst för skapande av annonser, observera att integrationer för anpassade nyttolaster inte omfattas av Epsilon Retail Media SLA, om inte annat anges. {% 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/sv/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.