Einführung in Custom Text Feeds
Custom Text Feeds bieten eine flexible Lösung zur Verteilung von Produktdaten in Textformat. Diese Feed-Art ermöglicht es Händlern, ihre Produktinformationen in einem einfachen, zeilenbasierten Format zu strukturieren und an verschiedene Verteilungskanäle zu übermitteln. Im Gegensatz zu standardisierten Formaten wie XML oder JSON ermöglichen Text Feeds eine schnelle Implementierung und erfordern weniger technische Komplexität.
Diese Dokumentation richtet sich an Händler, die ihre Produktdaten über Custom Text Feeds bereitstellen möchten. Sie erfahren, wie Sie Ihre Produktinformationen korrekt strukturieren, welche Felder erforderlich sind und wie Sie die Feed-Qualität optimieren.
Grundstruktur und Feldanforderungen
Ein Custom Text Feed basiert auf einer zeilenorientierten Struktur, bei der jede Zeile einen Datensatz (in der Regel ein Produkt) darstellt. Die Felder innerhalb einer Zeile werden durch Trennzeichen wie Tabulatoren, Kommas oder andere definierte Zeichen getrennt.
Erforderliche Felder
Folgende Felder sind typischerweise in einem Custom Text Feed erforderlich oder empfohlen:
| Feldname | Datentyp | Erforderlich | Beschreibung |
|---|---|---|---|
| id | String | Ja | Eindeutige Produktkennung |
| title | String | Ja | Produktname oder Titel |
| description | String | Nein | Detaillierte Produktbeschreibung |
| price | Dezimalzahl | Ja | Verkaufspreis in der angegebenen Währung |
| link | URL | Ja | Direkter Link zur Produktseite |
| image_link | URL | Ja | Link zum Produktbild |
| availability | String | Ja | Verfügbarkeitsstatus (in stock, out of stock, preorder) |
| brand | String | Nein | Herstellername oder Marke |
| condition | String | Nein | Produktzustand (new, refurbished, used) |
| product_type | String | Nein | Produktkategorie oder Typ |
| mpn | String | Nein | Herstellerteilnummer |
| gtin | String | Nein | Europäische Artikelnummer oder Barcode |
| item_group_id | String | Nein | Gruppierungskennung für Varianten |
| google_product_category | String | Nein | Google-Produktkategorie-ID |
Trennzeichenkonvention
Die Wahl des Trennzeichens beeinflusst die Verarbeitung des Feeds erheblich. Häufig verwendete Trennzeichen sind:
- Tab-Zeichen (\t): Ideal für Daten, die Kommas enthalten
- Komma (,): Standard bei CSV-ähnlichen Formaten
- Senkrechtstrich (|): Geeignet, wenn Daten Kommas und Tabs enthalten
Die Trennzeichenwahl muss bei der Feed-Konfiguration explizit angegeben werden, um Parsing-Fehler zu vermeiden.
Praktische Feldmapping-Richtlinien
Produktidentifikation
Das id Feld muss eindeutig sein und konsistent bleiben. Verwenden Sie interne Produktnummern oder SKUs, die sich nicht ändern. Wenn Sie mehrere Varianten eines Produkts haben, nutzen Sie das item_group_id Feld, um diese zu gruppieren. Jede Variante erhält eine eigene eindeutige id, während die item_group_id identisch bleibt.
Beispiel:
- Produkt: Laufschuhe Modell X
- Varianten: Größe 40, 41, 42
- Jede Variante hat eigene id (z.B. SKU-40, SKU-41, SKU-42)
- Alle teilen item_group_id (z.B. MODEL-X)
Produktbeschreibungen
Das title Feld sollte prägnant sein und die wichtigsten Produktmerkmale enthalten. Verwenden Sie keine Sonderzeichen oder Zeilenumbrüche, da diese das Parsing stören. Begrenzen Sie die Länge auf 150 Zeichen für optimale Darstellung in den meisten Kanälen.
Das description Feld kann umfassendere Informationen enthalten. Vermeiden Sie HTML-Tags oder Formatierungen, die nicht vom Feed-System verarbeitet werden. Nutzen Sie stattdessen strukturierte Textinformation.
Preisgestaltung und Verfügbarkeit
Das price Feld muss als Dezimalzahl formatiert sein. Verwenden Sie einen Punkt als Dezimaltrennzeichen, nicht ein Komma. Geben Sie nur den Preis ohne Währungssymbol an. Die Währung wird in der Feed-Konfiguration separat definiert.
Beispiel korrektes Format: 29.99
Beispiel falsches Format: €29,99
Das availability Feld muss exakt einem der unterstützten Werte entsprechen. Häufige Werte sind:
- in stock: Produkt ist verfügbar
- out of stock: Produkt ist ausverkauft
- preorder: Produkt kann vorbestellt werden
Falsche oder abweichende Werte führen zu Ablehnungen oder Nicht-Anzeige des Produkts.
Bilder und Links
Das image_link Feld muss auf ein direktes Bild verweisen (z.B. .jpg, .png). Verwenden Sie vollständige URLs mit https-Protokoll. Bilder sollten mindestens 100x100 Pixel groß sein, idealerweise 800x800 Pixel oder größer. Testen Sie alle URLs vor dem Feed-Upload, um sicherzustellen, dass sie erreichbar sind.
Das link Feld verweist auf die Produktseite im Shop. Auch hier sind vollständige URLs erforderlich. Der Link sollte direkt zum Produkt führen, nicht zur Kategorie oder Startseite.
Klassifizierung und Kategorisierung
Das google_product_category Feld muss eine gültige Google-Kategorie-ID enthalten. Diese IDs sind numerisch und entsprechen der Google-Produkttaxonomie. Falsche oder ungültige Kategorien führen zu Listungsproblemen.
Das product_type Feld kann Ihre interne Kategorisierung widerspiegeln und hilft bei der Filterung und Suche.
Häufige Fehlerquellen und deren Auswirkungen
Fehlerhafte oder unvollständige Feldwerte führen zu konkreten Problemen bei der Listung:
- Fehlende Pflichtfelder: Produkte werden nicht indexiert oder angezeigt
- Ungültige Preisformate: Preis wird nicht erkannt, Produkt wird abgelehnt
- Defekte Links oder Bilder: Listung wird deaktiviert oder mit Warnungen angezeigt
- Ungültige Verfügbarkeitswerte: Falsche Verfügbarkeitsinformation wird angezeigt
- Ungültige Zeichenkodierung: Feed wird nicht verarbeitet
Praktische Implementierung
Feed-Vorbereitung
- Exportieren Sie Ihre Produktdaten aus Ihrem Shop-System in ein Textformat
- Überprüfen Sie, dass alle erforderlichen Felder vorhanden sind
- Validieren Sie Datenformate (Preise, URLs, Verfügbarkeit)
- Entfernen Sie Sonderzeichen aus Feldwerten, die Parsing-Probleme verursachen
- Definieren Sie das Trennzeichen eindeutig
- Speichern Sie die Datei in UTF-8 Kodierung
Feed-Upload und Validierung
Nach der Vorbereitung laden Sie den Feed hoch und führen eine Validierung durch. Das System prüft:
- Dateiformat und Zeichenkodierung
- Vorhandensein erforderlicher Felder
- Gültigkeit der Feldwerte
- Eindeutigkeit der Produkt-IDs
- Erreichbarkeit von URLs
Validierungsfehler müssen behoben werden, bevor der Feed aktiv wird.
Laufende Optimierung
Überwachen Sie regelmäßig die Feed-Performance:
- Prüfen Sie, wie viele Produkte aktiv sind und wie viele abgelehnt wurden
- Analysieren Sie Ablehnungsgründe und beheben Sie diese
- Aktualisieren Sie Preise und Verfügbarkeit regelmäßig
- Testen Sie neue Produkte vor dem vollständigen Upload
Zusammenfassung
Custom Text Feeds ermöglichen eine flexible und schnelle Verteilung von Produktdaten. Der Erfolg hängt von korrekter Feldstrukturierung, validen Datenformaten und konsistenter Wartung ab. Achten Sie auf die Einhaltung aller Feldanforderungen, verwenden Sie konsistente Datenformate und validieren Sie Ihren Feed vor dem Upload. Regelmäßige Überwachung und Optimierung stellen sicher, dass Ihre Produkte korrekt indexiert und angezeigt werden. Bei Fragen zur Feldmapping oder technischen Integration konsultieren Sie die Dokumentation Ihres spezifischen Verteilungskanals.