> 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/cs/data-api/catalog-products-2/syncing-products-via-api.md). # Synchronizace produktů přes API ## Standardní synchronizace produktů Jakmile je váš katalog vytvořen, můžete do něj synchronizovat produkty. Níže uvedený příklad popisuje standardní kontext pro synchronizaci produktů: ```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 případě úspěchu bude vrácen následující 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 kontextu lze prázdné hodnoty nebo hodnoty null u skupin a zisku ignorovat. ## Synchronizace informací o poloze Můžete také synchronizovat filtry pro různé lokality, kde jsou vaše produkty na prodejně. To je užitečné pro optimalizaci informací o vašich meziproduktech na úrovni prodejny/lokality. ```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 případě úspěchu bude vrácen následující 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 } ] } ``` ## Synchronizace informací HFSS Při synchronizaci produktů budete muset odeslat filtr `hfss:true` or `hfss:false`. To umožňuje Epsilon Retail Media správně filtrovat naše rozhraní. ```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" %} Potřebujete se dozvědět více o HFSS? Přečtěte si publikaci britské vlády zde: {% endhint %} ## Synchronizace více produktů Pokud synchronizujete více produktů, můžete v jedno požadavku sekvenčně odeslat až 100 produktů. Příklad kontextu pro synchronizaci dvou produktů je uveden níže: ```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 případě úspěchu bude vrácen následující 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" ] } ] } ``` ## Aktualizace zásob produktu Chcete-li aktualizovat zásoby produktu, budete muset produkt znovu synchronizovat pomocí Epsilon Retail Media. Při synchronizaci označte zásoby produktu na `0`. Příklad je uveden níže: ```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" ] } ] } ```
## Aktualizace obrázků produktů Epsilon ukládá URL adresy obrázků do vyrovnávací paměti, aby byl zajištěn konzistentní výkon a snížil se počet požadavků na váš obrázkový server. Pokud aktualizujete obrázek bez změny jeho URL adresy, musíte v Epsilonvyvolat obnovení explicitně. Chcete-li to provést: * Odeberte stávající image\_url z produktu. * Po dokončení aktualizace znovu odešlete stejnou image\_url. Případně, pokud to váš obrázkový server podporuje, můžete vynutit obnovení přidaným dotazovacího řetězce (například verze nebo časového razítka) ke stávající URL adrese. To způsobí, že Epsilon obrázek znovu načte.. {% hint style="info" %} Obrázky se používají pouze v uživatelském rozhraní Obrázky produktů se v reklamních odpovědích neposkytují. Jakékoli aktualizace obrázků ovlivní pouze to, jak se produkt zobrazuje v uživatelském rozhraní Epsilon , zatímco probíhá obnovení vyrovnávací paměti. {% endhint %} ## Získání produktů Jakmile máte produkt v katalogu, můžete chtít později získat jeho aktuální informace. Chcete-li to provést, můžete odeslat HTTP požadavek **GET** ve tvaru URL **`v1/catalog-products/catalogId/`**. Koncový bod je schopen přijmout jeden kód produktu na požadavek. Zástupný požadavek je nastíněn níže: ```http GET $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` Měli byste obdržet aktuální informace načtené v systému Epsilon Retail Media pro daný kód produktu. Příklad je níže {% hint style="info" %} Odeslání aktualizace produktu není v systému Epsilon Retail Media okamžité, úplné načtení aktualizace produktu v Epsilon Retail Media může trvat krátkou dobu. Nebuďte znepokojeni, pokud informace o produktu nejsou při načítání podrobností okamžitě aktualizovány. {% endhint %} ## Mazání produktů Chcete-li odebrat produkt z katalogu, pošlete HTTP požadavek DELETE v následujícím formátu, jakmile již produkt není potřeba. ### Parametry požadavku Koncový bod přijímá jeden kód produktu na požadavek, typicky vaše GTIN ID. ```http DELETE $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Mazání produktů s ID prodejce Pokud produkt obsahuje ID prodejce, uveďte jej při mazání produktu jako parametr dotazu: ```http DELETE $BASE_URL/v1/catalog-products//?sellerId=abc123> HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Doba zpracování Zpracování smazání produktu může trvat 30 minut až jednu hodinu. {% hint style="info" %} Důležité Pokud je produkt vyprodaný, nastavte jeho zásoby na 0 místo jeho smazání. Smazáním produktu se odebere možnost pro zadavatele reklamy jej vybrat na platformě Epsilon Retail Media , a to i v případě, že je znovu skladem. {% endhint %} ### Řešení chyb Pokud obdržíte chybu "product not found" (produkt nenalezen), pravděpodobně to znamená, že produkt nebyl načten do systému Epsilon Retail Media . --- # 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/cs/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.