> 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/de/data-api/catalog-products-2/syncing-products-via-api.md). # Produkte über API synchronisieren ## Standardmäßige Produktsynchronisierung Sobald Ihr Katalog erstellt wurde, können Sie Produkte damit synchronisieren. Das folgende Beispiel beschreibt einen Standardkontext für die Synchronisierung von Produkten: ```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" ] } ] } ``` Bei Erfolg wird das folgende Objekt zurückgegeben: ```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 } ] } ``` In diesem Kontext können leere oder Null-Werte für Gruppen und Gewinn ignoriert werden. ## Synchronisieren von Standortinformationen Sie können auch Filter für verschiedene Standorte synchronisieren, an denen Ihre Produkte auf Lager sind. Dies ist nützlich für die Optimierung Ihrer Produktinformationen auf Filial-/Standortebene. ```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" ] } ] } ``` Bei Erfolg wird das folgende Objekt zurückgegeben: ```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 } ] } ``` ## Synchronisieren von HFSS-Informationen Bei Ihrer Produktsynchronisierung müssen Sie einen Filter von `hfss:true` or `hfss:false`senden. Dies ermöglicht Epsilon Retail Media unsere Benutzeroberfläche entsprechend zu filtern. ```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" %} Möchten Sie mehr über HFSS erfahren? Lesen Sie die Veröffentlichung der britischen Regierung hier: {% endhint %} ## Synchronisieren mehrerer Produkte Wenn Sie mehrere Produkte synchronisieren, können Sie bis zu 100 pro Anfrage nacheinander verarbeiten. Ein Beispielkontext für die Synchronisierung von zwei Produkten ist unten dargestellt: ```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" } ] } ``` Bei Erfolg wird das folgende Objekt zurückgegeben: ```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" ] } ] } ``` ## Aktualisieren des Produktbestands Um den Bestand eines Produkts zu aktualisieren, müssen Sie das Produkt erneut synchronisieren mit Epsilon Retail Media. Kennzeichnen Sie bei Ihrer Synchronisierung den Bestand des Produkts auf `0`. Ein Beispiel ist unten dargestellt: ```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" ] } ] } ```
## Aktualisieren von Produktbildern Epsilon speichert Bild-URLs im Cache, um eine gleichbleibende Leistung zu gewährleisten und Anfragen an Ihren Bildserver zu reduzieren. Wenn Sie ein Bild aktualisieren, ohne dessen URL zu ändern, müssen Sie explizit eine Aktualisierung auslösen in Epsilon. Gehen Sie dazu wie folgt vor: * Entfernen Sie die vorhandene image\_url aus dem Produkt. * Senden Sie dieselbe image\_url erneut, sobald das Update abgeschlossen ist. Alternativ können Sie, sofern Ihr Bildserver dies unterstützt, eine Aktualisierung erzwingen, indem Sie eine Abfragezeichenfolge (z. B. eine Version oder einen Zeitstempel) an die vorhandene URL anhängen. Dies veranlasst Epsilon , das Bild neu zu laden.. {% hint style="info" %} Bilder werden nur in der Benutzeroberfläche verwendet Produktbilder werden nicht in Anzeigenantworten bereitgestellt. Alle Bildaktualisierungen wirken sich nur darauf aus, wie das Produkt in der Epsilon -Benutzeroberfläche erscheint, während die Cache-Aktualisierung erfolgt. {% endhint %} ## Abrufen von Produkten Sobald Sie ein Produkt in Ihrem Katalog haben, möchten Sie möglicherweise die aktuellen Informationen dazu zu einem späteren Zeitpunkt abrufen. Dazu können Sie eine **GET**-HTTP-Anfrage in der URL-Form **`v1/catalog-products/catalogId/`** stellen. Der Endpunkt kann einen Produktcode pro Anfrage akzeptieren. Eine Beispielanfrage ist unten dargestellt: ```http GET $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` Sie sollten die aktuellen Informationen erhalten, die im Epsilon Retail Media -System für den Produktcode erfasst wurden. Ein Beispiel finden Sie unten {% hint style="info" %} Das Senden einer Produktaktualisierung erfolgt nicht sofort im Epsilon Retail Media -System, es kann eine kurze Zeit dauern, bis Epsilon Retail Media eine Produktaktualisierung vollständig erfasst hat. Seien Sie nicht beunruhigt, wenn die Informationen eines Produkts beim Abrufen von Details nicht sofort aktualisiert werden. {% endhint %} ## Löschen von Produkten Um ein Produkt aus Ihrem Katalog zu entfernen, senden Sie eine DELETE-HTTP-Anfrage im folgenden Format, wenn das Produkt nicht mehr benötigt wird. ### Anfrageparameter Der Endpunkt akzeptiert einen Produktcode pro Anfrage, in der Regel Ihre GTIN-ID. ```http DELETE $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Löschen von Produkten mit Verkäufer-ID Wenn das Produkt eine Verkäufer-ID enthält, geben Sie diese beim Löschen des Produkts als Abfrageparameter an: ```http DELETE $BASE_URL/v1/catalog-products//?sellerId=abc123> HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Verarbeitungszeit Das Löschen von Produkten kann zwischen 30 Minuten und einer Stunde dauern. {% hint style="info" %} Wichtig Wenn ein Produkt nicht auf Lager ist, setzen Sie seinen Bestand auf 0, anstatt es zu löschen. Das Löschen eines Produkts nimmt Werbetreibenden die Möglichkeit, es in der Epsilon Retail Media -Plattform auszuwählen, selbst wenn es wieder auf Lager ist. {% endhint %} ### Fehlerbehandlung Wenn Sie den Fehler "Produkt nicht gefunden" erhalten, bedeutet dies wahrscheinlich, dass das Produkt noch nicht in das Epsilon Retail Media -System aufgenommen wurde. --- # 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/de/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.