> 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-products-via-api.md). # Synchronizácia produktov prostredníctvom API ## Štandardná synchronizácia produktov Po vytvorení katalógu doň môžete synchronizovať produkty. Nižšie uvedený príklad popisuje štandardný kontext synchronizácie produktov: ```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", "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" ] } ] } ``` V prípade úspechu sa vráti nasledujúci objekt: ```json { "catalogProducts": [ { "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "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" ], "groups": [], "profit": null } ] } ``` V tomto kontexte možno prázdne hodnoty alebo hodnoty null pre skupiny a zisk ignorovať. ## Synchronizácia informácií o polohách Môžete tiež synchronizovať filtre pre rôzne polohy, v ktorých sa vaše produkty nachádzajú na predajni. To je užitočné na optimalizáciu informácií o produktoch na úrovni predajne/polohy. ```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", "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","location:123","location:ABC" ] } ] } ``` V prípade úspechu sa vráti nasledujúci objekt: ```json { "catalogProducts": [ { "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "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", "location:123", "location:ABC" ], "groups": [], "profit": null } ] } ``` ## Synchronizácia informácií HFSS V rámci synchronizácie produktov budete musieť odoslať filter `hfss:true` or `hfss:false`. To umožňuje Epsilon Retail Media vhodne filtrovať naše rozhranie. ```json 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", "inventory": 50, "price": "19.99", "tags": [ "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "hfss:true","category:Health&Beauty","category:Grocery","brand:Covergirl","Special_Flag:0","location:123","location:ABC" ] } ] } ``` {% hint style="info" %} Potrebujete sa dozvedieť viac o HFSS? Pozrite si publikáciu britskej vlády tu: {% endhint %} ## Synchronizácia viacerých produktov Ak synchronizujete viacero produktov, môžete v jednej požiadavke zoradiť do sekvencie až 100 produktov. Príklad kontextu pre synchronizáciu dvoch produktov je uvedený nižšie: ```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", "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" ], "profit": "1.50" }, { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965738", "inventory": 26, "price": "8.50", "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Kelloggs Froot Loops Breakfast Cereal 500g" ], "filters": [ "brand:Kelloggs", "category:Pantry", "category:BreakfastFoods", "category:Cereals", "Special_Flag:0" ], "profit": "0.50" } ] } ``` V prípade úspechu sa vráti nasledujúci objekt: ```json { "catalogProducts": [ { "gtin": "23556578965543", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "price": 19.99, "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "groups": [], "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" ], "inventory": 50, "profit": 1.50, "tags": [ "Natural", "Lasting", "Dry Skin", "Beige" ] }, { "gtin": "23556578965736688", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "price": 8.50, "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "groups": [], "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Kelloggs Froot Loops Breakfast Cereal 500g" ], "filters": [ "brand:Kelloggs", "category:Pantry", "category:BreakfastFoods", "category:Cereals", "Special_Flag:0" ], "inventory": 26, "profit": 0.50, "tags": [ "Pantry", "BreakfastFoods", "Cereals", "Kelloggs" ] } ] } ``` ## Aktualizácia zásob produktov Ak chcete aktualizovať zásoby produktu, budete musieť produkt znova synchronizovať s Epsilon Retail Media. V synchronizácii označte zásoby produktu na `0`. Príklad je uvedený nižšie: ```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", "inventory": 0, "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" ] } ] } ```
## Aktualizácia obrázkov produktov Epsilon ukladá adresy URL obrázkov do vyrovnávacej pamäte, aby sa zaistil konzistentný výkon a znížil počet požiadaviek na váš obrázkový server. Ak aktualizujete obrázok bez zmeny jeho adresy URL, musíte explicitne spustiť obnovenie v Epsilon. Postupujte takto: * Odstráňte existujúci 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 dopytovacieho reťazca (napríklad verzie alebo časovej pečiatky) k existujúcej adrese URL. To spôsobí, že Epsilon obrázok znova načíta.. {% 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 ovplyvňujú iba to, ako sa produkt zobrazuje v Epsilon používateľskom rozhraní počas obnovovania vyrovnávacej pamäte. {% endhint %} ## Získanie produktov Keď už máte produkt v katalógu, môžete si neskôr chcieť vyžiadať jeho aktuálne informácie. Ak to chcete urobit, môžete vytvoriť http požiadavku **GET** s tvarom url **`v1/catalog-products/catalogId/`**. Koncový bod dokáže prijať jeden kód produktu na požiadavku. Nižšie je uvedená vzorová požiadavka: ```http GET $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` Mali by ste dostat aktuálne informácie spracované v Epsilon Retail Media systéme pre daný kód produktu. Príklad je nižšie {% hint style="info" %} Odoslanie aktualizácie produktu nie je v Epsilon Retail Media systéme okamžité, môže chvíľu trvať, kým Epsilon Retail Media aktualizáciu produktu plne spracuje. Neobávajte sa, ak sa informácie o produkte pri získavaní podrobností neaktualizujú okamžite. {% endhint %} ## Mazanie produktov Ak chcete produkt odstrániť z katalógu, odoslite požiadavku DELETE HTTP v nasledujúcom formáte, keď produkt už nie je potrebný. ### Parametre požiadavky Koncový bod prijíma jeden kód produktu na požiadavku, zvyčajne vaše GTIN ID. ```http DELETE $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Mazanie produktov s ID predajcu Ak produkt obsahuje ID predajcu, uveďte ho ako parameter dopytu pri mazaní produktu: ```http DELETE $BASE_URL/v1/catalog-products//?sellerId=abc123> HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Čas spracovania Vymazanie produktu môže trvať 30 minút až jednu hodinu. {% hint style="info" %} Dôležité Ak je produkt vypredaný, nastavte jeho zásoby na 0 namiesto jeho vymazania. Vymazaním produktu sa inzerentom odoberie možnosť vybrať ho v Epsilon Retail Media platforme, aj keď bude znova na sklade. {% endhint %} ### Riešenie chýb Ak dostanete chybu "product not found", pravdepodobne to znamená, že produkt nebol spracovaný v Epsilon Retail Media systéme. --- # 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-products-via-api.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.