> 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/hu/data-api/catalog-products-2/syncing-products-via-api.md). # Termékek szinkronizálása API-n keresztül ## Standard termékszinkronizálás A katalógus létrehozása után szinkronizálhatja a termékeket abba. Az alábbi példa egy standard kontextust vázol fel a termékek szinkronizálásához: ```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" ] } ] } ``` Siker esetén a következő objektum tér vissza: ```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 } ] } ``` Ebben a kontextusban a csoportok és a nyereség üres vagy null értékei figyelmen kívül hagyhatók. ## Helyadatok szinkronizálása Szűrőket is szinkronizálhat a különböző helyekhez, ahol a termékei az üzletekben találhatók. Ez hasznos a termékinformációk üzlet/helyszín szintű optimálásához. ```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" ] } ] } ``` Siker esetén a következő objektum tér vissza: ```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 } ] } ``` ## HFSS-információk szinkronizálása A termékszinkronizálás során el kell küldenie a következők szűrőjét: `hfss:true` or `hfss:false`. Ez lehetővé teszi a(z) Epsilon Retail Media számára, hogy megfelelően szűrje a felületünket. ```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" %} Többet szeretne tudni a HFSS-ről? Tekintse meg az Egyesült Királyság kormányának kiadványát itt: {% endhint %} ## Több termék szinkronizálása Ha több terméket szinkronizál, kérésenként legfeljebb 100-at sorolhat be. Két termék szinkronizálására mutat példát az alábbi kontextus: ```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" } ] } ``` Siker esetén a következő objektum tér vissza: ```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" ] } ] } ``` ## Termékkészlet frissítése Egy termék készletének frissítéséhez újra kell szinkronizálnia a terméket a következőkkel: Epsilon Retail Media. A szinkronizálás során jelölje meg a termék készletét a következőre: `0`. Egy példát az alábbiakban vázolunk: ```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" ] } ] } ```
## Termékképek frissítése Epsilon gyorsítótárazza a kép-URL-eket a konzisztens teljesítmény biztosítása és a képszerver felé indított kérések csökkentése érdekében. Ha úgy frissít egy képet, hogy nem változtatja meg annak URL-jét, kifejezetten frissítést kell indítania a következőkben: Epsilon. Ehhez tegye a következőket: * Távolítsa el a meglévő image\_url-t a termékből. * Küldje el újra ugyanazt az image\_url-t a frissítés befejezése után. Alternatív megoldásként, ha a képszervere támogatja, kikényszerítheti a frissítést egy lekérdezési karakterlánc (például egy verzió vagy időbélyeg) hozzáadásával a meglévő URL-hez. Ez a következőt eredményezi: Epsilon hogy újratöltse a képet. {% hint style="info" %} A képek csak a felhasználói felületen használatosak A termékképek nem jelennek meg a hirdetési válaszokban. A képfrissítések csak azt befolyásolják, hogyan jelenik meg a termék a következőkben: Epsilon UI, miközben a gyorsítótár frissítése történik. {% endhint %} ## Termékek lekérése Miután egy termék szerepel a katalógusában, előfordulhat, hogy később le szeretné kérni annak aktuális információit. Ehhez egy **GET** http-kérést indíthat a következő url-formátummal: **`v1/catalog-products/catalogId/`**. A végpont kérésenként egy termékkódot képes fogadni. Egy helyőrző kérést az alábbiakban vázolunk: ```http GET $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` Meg kell kapnia a következőkben bevitt aktuális információkat: Epsilon Retail Media rendszerben a termékkódhoz. Egy példa alább látható {% hint style="info" %} A termékfrissítések elküldése nem azonnali a következőkben: Epsilon Retail Media rendszerben, eltarthat egy rövid ideig, amíg a(z) Epsilon Retail Media teljesen beviszi a termékfrissítést. Ne aggódjon, ha a részletek lekérésekor a termékinformációk nem frissülnek azonnal. {% endhint %} ## Termékek törlése Ha el szeretne távolítani egy terméket a katalógusából, küldjön egy DELETE HTTP-kérést a következő formátumban, ha a termékre már nincs szükség. ### Kérés paraméterei A végpont kérésenként egy termékkódot fogad el, ami jellemzően az Ön GTIN azonosítója. ```http DELETE $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Termékek törlése eladói azonosítóval Ha a termék tartalmaz eladói azonosítót, adja meg azt lekérdezési paraméterként a termék törlésekor: ```http DELETE $BASE_URL/v1/catalog-products//?sellerId=abc123> HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Feldolgozási idő A termékek törlésének feldolgozása 30 perc és egy óra közötti időt vehet igénybe. {% hint style="info" %} Fontos Ha egy termék nincs raktáron, állítsa a készletét 0-ra a törlése helyett. A termék törlése megszünteti a hirdetők azon lehetőségét, hogy kiválasszák azt a következőkben: Epsilon Retail Media platformon, még akkor is, ha újra raktáron van. {% endhint %} ### Hibakezelés Ha "product not found" hibát kap, az valószínűleg azt jelenti, hogy a terméket nem vitték be a következőkbe: Epsilon Retail Media rendszer. --- # 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/hu/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.