Diese Anleitung erklärt, wie eine XML-Datei mit dem gesamten Produktkatalog erstellt wird, die für die Synchronisierung Ihrer Produkte mit Werbe- und Verkaufsplattformen wie Google Merchant Center, TikTok Shop oder Facebook Catalog unerlässlich ist.
Da die Feed-Erstellung über eine spezifische Webadresse (URL) erfolgt, wird die Konfiguration durch Hinzufügen von Parametern zur URL vorgenommen.
1. Aufbau der Basis-URL
Um den Feed zu generieren, müssen Sie eine bestimmte URL Ihrer Website aufrufen. Die Basis-URL hängt vom Format und der Zielplattform ab.
1. Identifizieren Sie Ihre Domain (z.B. https://ihrewebsite.com).
2. Fügen Sie den Feed-Pfad hinzu /api/plugin/ecommerceFeeds/.
3. Wählen Sie den zu generierenden Feed-Typ:
| Plattform | Feed-Typ | Beispiel Basis-URL |
|---|---|---|
| Google Merchant / Standard | standard.xml | https://ihrewebsite.com/api/plugin/ecommerceFeeds/standard.xml |
| TikTok Shop | tiktok.xml | https://ihrewebsite.com/api/plugin/ecommerceFeeds/tiktok.xml |
> Hinweis: Wenn Sie diese URL ohne zusätzliche Parameter aufrufen, wird der vollständige Feed aller aktiven Produkte generiert.
2. Erweiterte Feed-Konfiguration (Filter und Varianten)
Sie können den Inhalt des Feeds anpassen, indem Sie Konfigurationsparameter nach einem Fragezeichen (?) in der Basis-URL hinzufügen.
2.1. Einbindung von Varianten (Größe, Farbe, Marke)
Wenn Ihre Produkte Varianten haben (z.B. Größen oder Farben), müssen Sie angeben, welche Attribute auf die Standardfelder von Google/TikTok (color, size, brand) abgebildet werden sollen.
Sie müssen die numerische ID des Attributs identifizieren, das Größe, Farbe usw. in Ihrem Produktverwaltungssystem repräsentiert.
| Zweck | Parameter | Beispiel (wenn ID 5 Farbe ist) |
|---|---|---|
| Farbe | v[c]=ID_ATTRIBUTE | ?v[c]=5 |
| Größe | v[s]=ID_ATTRIBUTE | ?v[s]=12 |
| Marke | v[b]=ID_ATTRIBUTE | ?v[b]=8 |
Beispiel-URL mit Varianten:
Wenn Sie die Varianten Größe (ID 12) und Farbe (ID 5) einbinden möchten:
.../tiktok.xml?v[s]=12&v[c]=5
2.2. Filterung nach Kategorie
Es ist möglich, Produkte basierend auf Kategorien einzuschließen oder auszuschließen, indem Sie die Kategorie-IDs verwenden.
| Zweck | Parameter | Beispiel |
|---|---|---|
| Kategorien einschließen | include_cats=ID1,ID2 | ?include_cats=1,2,5 |
| Kategorien ausschließen | exclude_cats=ID1,ID2 | ?exclude_cats=10,11 |
2.3. Zuordnung benutzerdefinierter Labels (Custom Labels)
Benutzerdefinierte Labels (customlabel0 bis customlabel4) sind nützlich zur Organisation von Produkten in Werbekampagnen. Diese Labels können folgendermaßen gemappt werden:
- Kategorien: Um die Kategorienehierarchie des Produkts einzufügen.
- Attribute: Um den Wert eines bestimmten Attributs (numerische ID) einzufügen.
- Fester Text: Um einen festen String einzufügen.
| Label | Parameter | Beispielwert | Beschreibung |
|---|---|---|---|
customlabel0 | c[0] | categories | Fügt den vollständigen Kategorienpfad ein. |
customlabel1 | c[1] | 15 | Fügt den Wert des Attributs mit ID 15 ein. |
customlabel2 | c[2] | Sommer2024 | Fügt den festen String "Sommer2024" ein. |
3. Generierung des endgültigen Feeds
Um den Feed zu generieren, fügen Sie die vollständige URL in Ihren Browser ein (oder geben sie an die Zielplattform weiter).
Beispiel einer vollständigen URL (TikTok Shop):
Generiert den Feed für TikTok Shop unter Einbeziehung der Varianten Größe (ID 12) und Farbe (ID 5) sowie Zuordnung von customlabel0 zum Kategorienpfad:
https://ihrewebsite.com/api/plugin/ecommerceFeeds/tiktok.xml?v[s]=12&v[c]=5&c[0]=categories
Nach dem Öffnen der URL verarbeitet das System die Daten und liefert direkt die XML-Datei (oder CSV bei Bedarf), die Sie speichern oder für die automatische Synchronisation verwenden können.
> Wichtig: Der Erstellungsprozess des Feeds kann mehrere Sekunden dauern (bis zu 120 Sekunden je nach Anzahl der Produkte), um Unterbrechungen zu vermeiden.
