3. März 2022

Außerplanmäßige Änderungen

Marketing API

Produktpaletten

Änderung an den Katalogsuchfiltern

Wir haben zum 3. März 2022 die Funktionsweise bestimmter Filter zum Erstellen von Produktpaletten in deinem Katalog geändert. Diese Änderungen wirken sich darauf aus, welche Artikel aufgenommen werden, wenn du eine Produktpalette erstellst.

Chronik
Das Feld- und Operatorenverhalten wird sich in 90 Tagen ändern. Wenn Paletten in deinem Katalog die betroffenen Filter nach dem 1. Juni 2022 weiterhin verwenden, ändern sich unter Umständen die enthaltenen Artikel in diesen Paletten. Möglicherweise werden dann also in deinen Werbeanzeigen oder Shops, die diese Produktauswahl verwenden, andere Artikel angezeigt. Außerdem geben alle Anfragen, die diese Filter verwenden, möglicherweise eine andere Artikelpalette zurück.

Weitere Informationen zu Produktpalettenfiltern findest du hier.

Welche Operatoren verändern sich

Operator	Änderung
`contains` / `not_contains`	Ihre Abfrage muss jetzt mit einem ganzen Wort übereinstimmen, nicht nur mit einem Teil eines Wortes. Beispielsweise gibt `name: {"contains": "red car"}` alle Produkte zurück, die die beiden Wörter „red car“ und „red fast car“ enthalten, aber nicht „red carpet“. Begriffe, die mit Bindestrich geschrieben werden, gelten als eigenständige Wörter. Wenn du beispielsweise `name: {"contains": "shirt"}` abfragst, werden sowohl „shirt“ als auch „T-shirt“ gefunden. Jedes Wort in deiner Abfrage muss eine Übereinstimmung ergeben, allerdings spielt die Reihenfolge dabei keine Rolle. Wenn du beispielsweise `name: {"contains": "jeans blue"}` abfragst, wird „blue cropped jeans“ gefunden, aber nur „jeans“ oder „blue“ nicht.
`lt`	Die Filteroption ist nicht mehr für `custom_label`-Felder verfügbar.
`lte`	Die Filteroption ist nicht mehr für `custom_label`-Felder verfügbar.
`gt`	Die Filteroption ist nicht mehr für `custom_label`-Felder verfügbar.
`gte`	Die Filteroption ist nicht mehr für `custom_label`-Felder verfügbar.
`starts_with`	Diese Filteroption ist jetzt nur für das Produktkategoriefeld verfügbar. Für andere Felder solltest du das Feld `contains` verwenden.

Welche Felder verändern sich

Feld	Beschreibung
`custom_label_0`	Der Wert für eine benutzerdefinierte Kennung eines Produktartikels, eines Hotels, eines Reiseziels, eines Fahrzeugs oder eines Immobilieninserats. Der Wert wird als String behandelt. Numerische Operatoren (`gt`, `gte`, `lt`, `lte`) sind nicht für dieses Feld verfügbar. Stattdessen solltest du das `custom_number_0 field` verwenden, welches Ganzzahlen unterstützt.
`custom_label_1`	Der Wert für eine benutzerdefinierte Kennung eines Produktartikels, eines Hotels, eines Reiseziels, eines Fahrzeugs oder eines Immobilieninserats. Der Wert wird als String behandelt. Numerische Operatoren (`gt`, `gte`, `lt`, `lte`) sind nicht für dieses Feld verfügbar. Stattdessen solltest du das Feld `custom_number_1` verwenden, welches Ganzzahlen unterstützt.
`custom_label_2`	Der Wert für eine benutzerdefinierte Kennung eines Produktartikels, eines Hotels, eines Reiseziels, eines Fahrzeugs oder eines Immobilieninserats. Der Wert wird als String behandelt. Numerische Operatoren (`gt`, `gte`, `lt`, `lte`) sind nicht für dieses Feld verfügbar. Stattdessen solltest du das Feld `custom_number_1` verwenden, welches Ganzzahlen unterstützt.
`custom_label_3`	Der Wert für eine benutzerdefinierte Kennung eines Produktartikels, eines Hotels, eines Reiseziels, eines Fahrzeugs oder eines Immobilieninserats. Der Wert wird als String behandelt. Numerische Operatoren (`gt`, `gte`, `lt`, `lte`) sind nicht für dieses Feld verfügbar. Stattdessen solltest du das Feld `custom_number_3` verwenden, welches Ganzzahlen unterstützt.
`custom_label_4`	Der Wert für eine benutzerdefinierte Kennung eines Produktartikels, eines Hotels, eines Reiseziels, eines Fahrzeugs oder eines Immobilieninserats. Der Wert wird als String behandelt. Numerische Operatoren (`gt`, `gte`, `lt`, `lte`) sind nicht für dieses Feld verfügbar. Stattdessen solltest du das Feld `custom_number_4` verwenden, welches Ganzzahlen unterstützt.
`custom_number_0`	Der benutzerdefinierte Ganzzahlen-Wert für einen Produktartikel, ein Hotel, ein Reiseziel, ein Fahrzeug oder ein Immobilieninserat.
`custom_number_1`	Der benutzerdefinierte Ganzzahlen-Wert für einen Produktartikel, ein Hotel, ein Reiseziel, ein Fahrzeug oder ein Immobilieninserat.
`custom_number_2`	Der benutzerdefinierte Ganzzahlen-Wert für einen Produktartikel, ein Hotel, ein Reiseziel, ein Fahrzeug oder ein Immobilieninserat.
`custom_number_3`	Der benutzerdefinierte Ganzzahlen-Wert für einen Produktartikel, ein Hotel, ein Reiseziel, ein Fahrzeug oder ein Immobilieninserat.
`custom_number_4`	Der benutzerdefinierte Ganzzahlen-Wert für einen Produktartikel, ein Hotel, ein Reiseziel, ein Fahrzeug oder ein Immobilieninserat.

Offset-Paginierung

Der Endpunkt GET /{product-catalog-id}/products?filter=.....&offset=...&limit=...&bulk_pagination=false ist nun auf 2.000 Ergebnisse limitiert.

Was verändert sich

Wir haben derzeit keine Beschränkungen für „offset“ + „limit“. Ab heute dürfen „offset“ + „limit“ zusammen nicht größer als 2.000 Ergebnisse sein, wenn bulk_pagination = false ist. Beispiel:

„offset“ = 1.000, „limit“ = 1.500 funktioniert nicht, da „offset“ + „limit“ = 2.500
„offset“ = 100, „limit“ = 1500 funktioniert, da „offset“ + „limit“ = 1600

Um eine Paginierung eines Katalogs ohne Beschränkungen durchzuführen, solltest du bulk_pagination = true verwenden.