Für die Übergabe Ihrer Produktdaten an die Emarsys Marketing Plattform können Sie das Format 'Google Product Feed' (GPF) verwenden, das von uns automatisch in unser natives CSV-Format konvertiert wird. Wenn Sie bereits eine GPF-Produktdatei haben, können Sie diese wahrscheinlich ohne weitere Anpassungen verwenden; Sie sollten jedoch sicherstellen, dass der GPF alle für Emarsys erforderlichen Produktdatenfelder enthält.
Inhalt
Voraussetzungen
- Eine in UTF-8 codierte GPF-Datei.
Wenn Ihre GPF-Datei über 400 MB groß ist, kontaktieren Sie bitte den Emarsys Support, bevor Sie im Web-UI die Update-Termine festlegen.
Wir empfehlen dringend, in der GPF-Produktdatei im XML-Format keine Leerzeichen zu verwenden (z. B. Zeilenumbruch, Zwischenraum, Tabstopp); es sei denn, sie sind explizit erforderlich. GPF-Dateien – sofern sie im XML-Format eingesetzt werden - funktionieren am besten ohne zusätzliche Leerzeichen. XML-Dateispezifikationen finden Sie hier.
Sie müssen Ihre GPF-Datei im Google Merchant Center überprüfen, bevor Sie diese zu Emarsys hochladen. Unsere Produktdatenvalidierung umfasst nur das Emarsys CSV-Format.
Bitte achten Sie ganz besonders auf die Bezeichnungen von Spalten. Emarsys unterstützt nicht, dass mehrere Spalten dieselbe Bezeichnung tragen (z. B. additional_image_link), aber Google zeigt dies nicht als Fehler an.
Google Product Feed-Felder im Emarsys CSV-Format.
Nachstehende Tabelle zeigt, wie wir die GPF-Felder in Emarsys Produktdatenfelder konvertieren:
GPF | Emarsys CSV | In Emarsys erforderlich | Kommentare |
|---|---|---|---|
id und item_group_id | item | Ja | Emarsys verwirft Produktvarianten (d.h. ähnliche Produkte, die sich nur durch Attribute wie Größe, Farbe und Material unterscheiden) und erstellt für jede Produktgruppe einen einzigen Artikel ('item') auf erster Ebene. Das GPF-Feld item_group_id verwenden wir zur Identifizierung der Produktgruppen. Mehr Info. |
| Im Emarsys CSV erhält das Produkt auf erster Ebene die Attribute des ersten Artikels in der GPF-Produktgruppe. Siehe Beispiele weiter unten. | |||
title | title | Ja | |
link | link | Ja | |
image_link | zoom image und image | Nein | Die Original-URL wird in das Feld zoom_image eingefügt. |
| Sie wird auch für das Image-Feld verwendet, dort aber in eine URL überführt, die für E-Mail-Empfehlungen spontan ein Miniaturbild erstellt. Mehr Info. | |||
google_product_category oder product_type | category | Nein | Wenn Sie wissen wollen, wie wir Kategorien konvertieren, klicken Sie hier. |
availability | available | Nein | GPF unterstützt die 3 Werte in stock (auf Lager), out of stock (nicht auf Lager), preorder (vorbestellbar), während Emarsys nur 2 unterstützt. Sowohl in stock als auch preorder werden zu true konvertiert. |
description | description | Nein | |
sale_price | price | Nein | Wenn beide GPF-Preisfelder befüllt sind, wird das so konvertiert. |
Wenn nur sale_price befüllt ist, verwenden wir diesen Wert sowohl in price als auch in msrp des Emarsys CSV. | |||
price | msrp | Nein | Wenn beide GPF-Preisfelder befüllt sind, wird das so konvertiert. |
Wenn nur price befüllt ist, verwenden wir diesen Wert sowohl in price als auch in msrp des Emarsys CSV. | |||
brand | brand | Nein | |
custom_label_[n] | c_label_[n] | Nein | Hier erfahren Sie, welche benutzerdefinierten Felder des GPF wir unterstützen. |
Unterstützte Länder und Sprachen
Wir bemühen uns, Unterstützung für all jene Zielländer und Zielsprachen anzubieten, die auch von Google unterstützt werden. Wenn Google Ihr Land und Ihre Sprache unterstützt und Sie diese beim Upload Ihres GPF trotzdem nicht in der Dropdown-Liste im Web-UI der Emarsys Marketing Plattform finden, kontaktieren Sie bitte den Emarsys Support.
Sollten wir Ihr Land und Ihre Sprache nicht unterstützen, können Sie alternativ immer 'United States' als Standard-Gebietsschema auswählen.
Mehrere Feeds verwenden
Wir unterstützen mehrere GPF-Feeds für Emarsys Kunden, die mehrere Zielländer haben oder mehrere Sprachen verwenden; die Verwendung mehrerer Feeds für nur ein Land oder eine Sprache wird von uns jedoch nicht unterstützt.
Mehrere GPFs werden zu einer einzigen CSV-Produktdatendatei verschmolzen, und zwar auf Basis der Regeln, die wir in unseren Lokalisierungsrichtlinien festgelegt haben.
Nur jene Produkte, die in Ihrem Standard-Gebietsschema angeführt sind, werden im Zuge der Konversion zur Emarsys CSV-Datendatei hinzugefügt. Wenn Sie in anderen Gebietsschemata Produkte anbieten, welche Sie in Ihrem Standard-Gebietsschema nicht anbieten, müssen Sie diese Informationen auch in der Standard-GPF-Datei anführen und die Produktverfügbarkeit auf out of stock (nicht auf Lager) setzen. Verwenden Sie dieselbe item_group_id und Artikelnummer (SKU) in den Standard- und lokalen Produktdatendateien für dasselbe Produkt.
Wenn Sie sich bei der Vorgehensweise nicht sicher sind, kontaktieren Sie bitte den Emarsys Support.
item_group_id in lokalen Produktdatendateien wird derzeit nicht im vollen Umfang unterstützt. Benutzen Sie nicht die item_group_id, wenn Sie auch lokale Produktdatendateien verwenden. Einige der lokalen Produkte werden eventuell aus dem endgültigen Katalog entfernt (auch wenn sie in dem entsprechenden Gebiet auf Lager sind). Gruppieren sie Ihre Varianten nicht unter derselben item_group_id, sondern vergeben Sie dafür separate IDs, um die Verfügbarkeit korrekt abzubilden.
Produktkategorien
GPF unterstützt zwei Attribute für die Angabe der Kategorie, zu der ein bestimmtes Produkt gehört.
- google_product_category - Die Produktkategorien Ihrer Artikel laut Google-Produkttaxonomie. Bei diesem Feld gibt es eine wichtige Einschränkung: Es kann je Produkt nur jeweils einen Kategoriepfad enthalten. Das Feld kann entweder mit einem numerischen Wert (der standardisierten Kategorie-ID) oder dem vollständigen Pfad der Kategorie (z.B.
root > cat1 > subcat2) befüllt sein. - product_type - Die Produktkategorien, die Sie für Ihre Produkte definieren. In diesem Feld können Sie mehrere Kategoriehierarchien anführen. Bei diesem Feld gibt es eine wichtige Einschränkung: Innerhalb einzelner Werte in diesem Feld wird die Verwendung von Kommazeichen ( , ) von Google nicht unterstützt. Kommazeichen sind bei Google für die Trennung mehrerer Werte reserviert.
Beim Verarbeiten des ursprünglichen GPF und der Konvertierung in unser natives CSV-Format sehen wir uns zuerst den Inhalt des Feldes product_type an. Ist dieses befüllt, verwenden wir es in der Produktdatendatei. Nur wenn das Feld product_type nicht befüllt ist, verwenden wir das Feld google_product_category.
Wenn Sie im Feld google_product_category numerische Kategorie-IDs verwenden, werden diese zu den entsprechenden visuell lesbaren Kategoriepfaden konvertiert. So wird zum Beispiel 4745 in unserem nativen CSV-Format zu Electronics > Computers > Tablet Computers konvertiert. Bitte denken Sie beim Implementieren unserer Web Extend Datensammlungs-Scripts daran, im Befehl category immer den visuell lesbaren Kategoriepfad zu verwenden, wenn Sie den Aufruf von Kategorieseiten Ihrer Website melden.
Artikelgruppen
Die Emarsys Marketing Plattform arbeitet derzeit nur mit Produkten der ersten Ebene und verwendet keine Informationen zu SKU-Level-Varianten desselben Produkts. Google verlangt jedoch, dass Sie die Varianten des Produkts, die sich nur durch Attribute wie Größe, Farbe, Material etc. voneinander unterscheiden, als eigene Produkte in Ihrem GPF auflisten.
Vergewissern Sie sich, dass Sie das Attribut item_group_id verwenden, um verschiedene Varianten desselben Produkts in Ihrem GPF zu gruppieren; Emarsys benötigt dieses Feld, um die Produktgruppen zu identifizieren. Wenn wir Ihren GPF in das Emarsys CSV-Format konvertieren, behalten wir nur die Produktgruppen bei und verwerfen die individuellen Varianten.
Nachstehende Tabelle zeigt, wie wir Ihre GPF-Produktgruppen konvertieren:
| GPF | Emarsys CSV |
|---|---|
| id,title,item_group_id 100_40,Mens leather shoe size 40, 100 100_41,Mens leather shoe size 41, 100 100_42,Mens leather shoe size 42, 100 | item, title 100, Mens leather shoe size 40 |
Das sind die am häufigsten auftretenden Fehler, die es zu vermeiden gilt:
| GPF | Emarsys CSV | Kommentare |
|---|---|---|
| Id,title,item_group_id 100_42,Mens leather shoe size 42, 100_43,Mens leather shoe size 43, | item, title 100_42,Mens leather shoe size 42 100_43,Mens leather shoe size 43 | item_group_id fehlt, alle Produktvarianten werden in der Emarsys Produktdatenbank als eigene Artikel angeführt. |
| Id,title,item_group_id ,Mens leather shoe size 42,100 | [error] | Artikel wird verworfen, weil die id fehlt. |
| Id,title,item_group_id 100_42,Mens leather shoe size 42,100_42 | [error] | Artikel wird verworfen, weil id und item_group_id identisch sind. |
Wenn Sie in Ihrem GPF item_group_id verwenden, müssen Sie das beim Implementieren unseres Web Extend JavaScript API berücksichtigen. In diesem Fall sollten Sie sich vergewissern, dass der Wert aus diesem Feld in den Befehlen view, cart und purchase als das Attribut item übergeben wird, andernfalls kann Emarsys diese Produkte nicht identifizieren.
Benutzerdefinierte GPF-Felder
GPF unterstützt zwei Arten von benutzerdefinierten Feldern:
- benutzerdefinierte Attribute, diese beginnen mit "c: (z.B.
c:promo_offer:boolean). - benutzerdefinierte Labels, diese erhalten die Nummerierung 0-4 (z.B.
custom_label_1).
Derzeit werden nur benutzerdefinierte Labels zum Emarsys CSV konvertiert; benutzerdefinierte Attribute werden ignoriert.