> 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/sk/data-api/catalog-products-2/syncing-catalog-products-via-file.md). # Synchronizácia katalógu a produktov prostredníctvom súboru Epsilon Retail Media podporuje dva typy formátov na synchronizáciu produktových dát prostredníctvom súboru: * TSV * CSV Táto časť popisuje štruktúry jednotlivých formátov súborov pre produktové dáta, ktoré spracovávame v Epsilon Retail Media. ## Maximálna veľkosť súboru Epsilon Retail Media dokáže podporovať súbory katalógov s 10 miliónmi produktov alebo menej na jedného maloobchodníka, čo umožňuje spracovať katalógy väčšiny trhovísk. {% hint style="info" %} Máte viac ako 10 miliónov produktov? Ak váš katalóg presahuje tento objem, Epsilon Retail Media môže posúdiť, či je veľkosť vášho katalógu podporovateľná. Upozorňujeme, že to môže vyžadovať aj komerčné úpravy {% endhint %} ## Súbory TSV/CSV Nižšie uvedená tabuľka znázorňuje názvy stĺpcov a popis stĺpcov pre produkty v súbore TSV/CSV. V tejto tabuľke tiež špecifikujeme povinné stĺpce, ktoré sa musia v súbore poskytnúť. Ak je stĺpec povinný, musia byť poskytnuté všetky hodnoty v danom stĺpci a jeho riadkoch. {% hint style="warning" %} ️ TSV bez úvodzoviek Súbory TSV nemôžu byť vo formáte s úvodzovkami. Pri synchronizácii cez TSV sa uistite, že synchronizujete súbory bez úvodzoviek. {% endhint %} ### Názvy stĺpcov a popisy produktových dát v súboroch TSV/CSV | Názov stĺpca | Povinné/voliteľné | Dátový typ | Popis | Príklad | | ------------------------ | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `product_code` | Povinné |

Text
Max 50 znakov

| Kód na identifikáciu produktu vo vašom systéme. Toto pole je identické s poľami gtin a item pri synchronizácii cez API a XML súbor. | F153212AN1 | | `name` | Povinné |

Text
Max 150 znakov

| Názov produktu. | SS Sticker Tee - Kids | | `image_url` | Povinné |

Url
Max 2048 znakov

| Hypertextový odkaz na obrázok produktu. Musí to byť platná URL. | | | `inventory` | Povinné |

Číslo
Odporúča sa 32-bitové celé číslo bez znamienka

| Skladová zásoba produktu. Ak je hodnota 0, reklamy na tento produkt sa nebudú zobrazovať. | 1 | | `description` | Povinné |

Text
Max 5000 znakov

| Popis produktu. | Vďaka vyšívaným jetelovým logám Trefoil a lemovaným 3 prúžkom v kontrastnej bielej farbe sú teplákové šortky Sport čerstvou ponukou od Adidas Originals. | | `KEY (as a value)` | Vyžaduje sa pre umiestnenia kategórií a širokého zobrazenia (broad display) |

Text
Max 1000 znakov na stĺpec

|

Ak sa používa tento typ stĺpca, maloobchodníci musia poskytnúť hodnotu pre \.

V súbore TSV môžete mať niekoľko stĺpcov s touto syntaxou.

| Názov stĺpca môže byť „brand“ a hodnota bunky v stĺpci môže byť „green-fairy“. Výsledkom bude filter "brand:green-fairy" na produkte. | | `subClassName` |

Zastarané.
Vyžaduje sa pre umiestnenia krížového/navýšeného predaja (cross/upsell) produktov

|

Text
Max 750 znakov

|

Názov podtriedy/kategórie, v ktorej sa príslušný produkt nachádza.

Podtriedy umožňujú lepšie cieľové zameranie produktov, napr. produkt maslo môže cieliť na chlieb, ale nebude cieliť na náplasti.

| Cheese | | `xSellSubClassName` |

Zastarané.
Vyžaduje sa pre umiestnenia krížového/navýšeného predaja (cross/upsell) produktov

|

Text
Max 750 znakov

| Názvy podtried/kategórií, v rámci ktorých môže príslušný produkt cieliť na produkty. | Breads, Spreads, Crackers | | `price` | Voliteľné |

Číslo
Odporúčajú sa 2 desatinné miesta

| Cena produktu. | 30.00 | | `brand` | Povinné |

Text
Max 70 znakov

| Značka produktu. | Tommy Hilfiger | | `type` | Povinné |

Text
Max 750 znakov

| Typ produktu. | Clothing | | `retailer_taxonomy` | Vyžaduje sa pre rozšírené prisudzovanie (enhanced attribution). Medzi znakmi nesmú byť `>` žiadne medzery |

Text
Max 750 znakov

| Vaša individuálna taxonómia maloobchodníka pre produkt. | Men>Men's Clothing>Sweaters | | `google_taxonomy` | Vyžaduje sa pre rozšírené prisudzovanie (enhanced attribution), ak `retailer_taxonomy` nie je možné poskytnúť |

Text
Max 750 znakov

| Štandardná taxonómia Google pre produkt. Viac informácií nájdete tu: | Odevy a doplnky > Oblečenie > Topy | | `global_identifier` | Povinné |

Text
Max 50 znakov

| Globálny identifikátor produktu. | 08719108994761 | | `global_identifier_type` | Povinné | Text | Typ globálneho identifikátora. | GTIN | | `custom_payload` | Vyžaduje sa len v prípade, ak je to odporúčané. | Pole bajtov zakódované v Base64 | Toto pole obsahuje vlastný payload, ktorý by mal byť preposlaný do generovania reklamy. Pole by malo obsahovať platný objekt JSON serializovaný do poľa bajtov a zakódovaný v Base64. Objekt JSON by mal spĺňať schému. | Pozrite si časť o vlastných payloadoch. | | `hfss` | Voliteľné | Boolean | Používa sa na označenie, či je produkt HFSS alebo nie. Toto sa ďalej využíva v Epsilon Retail Mediapoužívateľskom rozhraní. Pozrite si naše [Dokumentácia HFSS](/retail-media-interface/integration/sk/feature-integrations/placement-level-product-type-blocking-hfss-support.md) pre viac informácií. | true | | `seller_id` | Voliteľné |

Text
Max 50 znakov

|

Unikátne ID predajcu. Vyžaduje sa len pri registrácii predajcov na trhovisku (marketplace). Pri produktoch mimo trhoviska je možné nechať prázdne.

Pre integráciu seller\_ids existujú ďalšie požiadavky, pozrite si prosím Marketplace sellerId pre viac informácií.

| aes-de4-ss | Príklad súboru reprezentovaný ako tabuľka si môžete pozrieť nižšie: | `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 Gift Pack 500mL | | `20` | Tento darčekový balíček Green Fairy Absinth & Spoon je ideálnym darčekom pre každého milovníka absintu alebo koktailov. Položte kocku cukru na lyžičku a prelejte cez ňu Absinth, aby ste si vychutnali tento alkoholický nápoj autentickým spôsobom! | Darčeky, Alkoholické, Darčekové balenia | 500ml | Česká republika | Darčeky, Alkoholické, Darčekové balenia | `5.00` | Green Fairy | Alkohol | Darčeky>Alkoholické>Darčekové balenia | Potraviny, nápoje a tabak>Nápoje>Alkoholické nápoje>Lihoviny a destiláty>Absint | 8594001443079 | 7328s-dmie3-9jdae | Darčekové balíčky | Alkohol | {% hint style="info" %} Súbory TSV nemôžu byť vo formáte s úvodzovkami. {% endhint %} ## Aktualizácia obrázkov produktov Epsilon ukladá URL adresy obrázkov do vyrovnávacej pamäte s cieľom zaistiť konzistentný výkon a znížiť počet požiadaviek na váš obrázkový server. Ak aktualizujete obrázok bez zmeny jeho URL adresy, musíte ručne spustiť obnovenie v Epsilon. Ak to chcete urobiť: * Odstráňte existujúcu image\_url z produktu. * Po dokončení aktualizácie znova odoslite rovnakú image\_url. Prípadne, ak to váš obrázkový server podporuje, môžete vynútiť obnovenie pridaním dopytového reťazca (napríklad verzie alebo časovej pečiatky) k existujúcej URL adrese. To spôsobí, že Epsilon znova načíta obrázok.. {% hint style="info" %} Obrázky sa používajú iba v používateľskom rozhraní Obrázky produktov sa neposkytujú v odpovediach na reklamu. Akékoľvek aktualizácie obrázkov ovplyvnia iba to, ako sa produkt zobrazuje v Epsilon používateľskom rozhraní, kým prebieha obnovenie vyrovnávacej pamäte. {% endhint %} ## Súbory XML – plánované zastavenie podpory {% hint style="danger" %} ️ Zastavená podpora pre nových zákazníkov Nižšie uvedené informácie sú určené pre existujúcich zákazníkov, ktorí stále využívajú formát XML. Pre onboarding nového katalógu podporujeme formáty TSV a CSV popísané vyššie, ktoré poskytujú väčšiu flexibilitu súborov, ako aj možnosť synchronizovať súbor viackrát denne. {% endhint %} Epsilon Retail Media definuje zoznam značiek, ktoré sa používajú na opis dokumentu XML pre produkty. Nižšie uvedená tabuľka zobrazuje značky a ich opisy. Značka „item“ sa používa na opis produktu v dokumente XML. Všetky ostatné značky pre ostatné polia musia byť zapísané vo vnútri tejto značky. | Značky XML | Povinné/voliteľné | Popis | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `item` | Povinné | Táto značka sa používa na opis produktu. Všetky ostatné značky XML pre produkt musia byť vo vnútri tejto značky. Dokument XML pre produkty musí obsahovať zoznam značiek item. Toto pole je identické s poľami gtin a product\_code pri synchronizácii cez API a súbor TSV. | | `id` | Povinné | Kód na identifikáciu produktu vo vašom systéme. Ekvivalent k `product_code` v súboroch TSV. Toto pole je identické s poľami gtin a item pri synchronizácii cez API a súbor XML. | | `title` | Povinné | Názov produktu. | | `image_link` |

Povinné
Max 50 znakov

| Hypertextový odkaz na obrázok produktu. Musí to byť platná URL. | | `brand` |

Povinné
Max 70 znakov

| Značka produktu. | | `availability` |

Povinné
Odporúča sa 32-bitové celé číslo bez znamienka

| Táto značka slúži na opis skladových zásob produktu. Hodnota musí byť číslo. | | `description` |

Povinné
Max 5000 znakov

| Táto značka slúži na opis popisu produktu. | | `price` |

Voliteľné
Odporúčajú sa 2 desatinné miesta

| Táto značka slúži na opis ceny produktu. Ak je hodnota vo vnútri značky uvedená, musí to byť číslo. | | `type` |

Voliteľné
Max 750 znakov

| Typ produktu. | | `retailer_taxonomy` |

Vyžaduje sa pre rozšírené priraďovanie. Vyžaduje sa aj pre kategóriové integrácie.
Max 750 znakov

| Vaša individuálna taxonómia produktov predajcu. Naps. Muži>Pánske oblečenie>Svetre | | `google_taxonomy` |

Vyžaduje sa pre rozšírené prisudzovanie (enhanced attribution), ak retailer\_taxonomy nie je možné poskytnúť
Max 750 znakov

| Štandardná taxonómia Google pre produkt. Viac informácií nájdete tu: | | `global_identifier` |

Povinné
Max 50 znakov

| Globálny identifikátor pre produkt. Naps. `08719108994761` | | `global_identifier_type` | Povinné | Typ globálneho identifikátora. Naps. `GTIN` | | `custom_payload` | Vyžaduje sa len v prípade, ak je to odporúčané. | Toto pole obsahuje vlastný payload, ktorý by mal byť preposlaný do generovania reklamy. Pole by malo obsahovať platný objekt JSON serializovaný do poľa bajtov a zakódovaný v Base64. Objekt JSON by mal spĺňať schému. | | `hfss` | Voliteľné | Používa sa na označenie, či je produkt HFSS alebo nie. Toto sa ďalej využíva v Epsilon Retail Mediapoužívateľskom rozhraní. Pozrite si naše [Dokumentácia HFSS](/retail-media-interface/integration/sk/feature-integrations/placement-level-product-type-blocking-hfss-support.md) pre viac informácií. | | `seller_id` |

Voliteľné
Max 50 znakov

|

Unikátne ID predajcu. Vyžaduje sa len pri registrácii predajcov na trhovisku (marketplace). Pri produktoch mimo trhoviska je možné nechať prázdne.

Pre integráciu seller\_ids existujú ďalšie požiadavky, pozrite si prosím Marketplace sellerId pre viac informácií.

| Príklad platného dokumentu XML so značkami je uvedený nižšie: ```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 ``` ## Vlastné dáta (Custom payloads) ### Čo sú vlastné dáta (custom payloads)? Vlastné dáta sú polia, ktoré prechádzajú v nezmenenom stave („as-is“) od spracovania katalógu až po zobrazovanie reklamy. Na pole sa neaplikujú žiadne transformácie. Na poli sa však vykonáva validácia na základe JSON Schema (). Špecifikácia vlastných dát je k dispozícii prostredníctvom odkazu nižšie (zápis JSON Schema): V odpovedi na reklamu na produkt sa integrátorovi vracia presná hodnota custom payload v poli s názvom `customPayload`. Príklad platného obsahu (payloadu) je uvedený nižšie: ```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" %} Iba súbor Upozorňujeme, že vlastné obsahy (payloady) sú podporované len pri synchronizácii produktov prostredníctvom súboru. {% endhint %} ### Vlastné obsahy (payloady) pri generovaní reklamy Pri vracaní produktových reklám sa vlastný obsah predáva ako súčasť vygenerovanej reklamy. Vrátené obsahy reklám budú obsahovať dodatočné pole `customPayload` ktoré bude obsahovať objekt JSON zodpovedajúci rovnakej špecifikácii ako informácie poskytnuté vo feede. Príklad odpovede môže byť: ```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" %} Keďže vlastné obsahy (payloady) predstavujú dodatočnú záťaž pre našu službu generovania reklám, upozorňujeme, že integrácie vlastných obsahov nepodliehajú Epsilon Retail Media SLA, pokiaľ nie je uvedené inak. {% 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/sk/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.