Einstiegshife Data Onboarding

In diesem Abschnitt:

expand all

Ihre Verkaufsdaten hochladen


Um historische Verkaufsdaten hochzuladen und Ihre Verkaufsdaten synchron zu halten, öffnen Sie Ihren Emarsys Account und gehen Sie zu Predict > Dashboard; in der Box LIVE EVENTS des Abschnitts Data Collection klicken Sie Upload data. Damit gelangen Sie auf die Seite Sales data.

Hier können Sie Ihre Verkaufsdaten manuell oder über ein HTTP API hochladen. Der Upload von Verkaufsdaten erfolgt inkrementell, das heißt, neuere Uploads werden zu den bestehenden Verkaufsdaten hinzugefügt und überschreiben diese nicht.

Inhalt

Datei der Verkaufsdaten formatieren

Als Datei für die Verkaufsdaten erwartet das System eine .csv-Datei mit UTF-8-Kodierung, ähnlich dem Produktkatalog (wenn Sie nicht sicher sind, wie die Datei aussehen soll, können Sie am Ende dieser Seite eine Beispieldatei herunterladen). Jeder Eintrag in der Datei ist eine Bestellzeile, die mit einem gekauften Einzelartikel korrespondieren sollte. Es gibt eine Reihe von Standardspalten, die für das Reporting wichtig sind; darüber hinaus können Sie eigene - benutzerdefinierte - Spalten hinzufügen.

Standardspalten

Feld Erforderlich Typ Beispiel Beschreibung
item Ja String BOOK0012 Der eindeutige Produktidentifikator; er muss exakt mit dem Inhalt der Spalte item des Produktkatalogs übereinstimmen.
price Ja Float 110.30 Der Gesamtpreis der entsprechenden Artikel (der Preis pro Einheit multipliziert mit der Menge) in der Währung, die im Abschnitt Account Details Ihres Predict Dashboard definiert ist.
order Ja String 111-U8 Der eindeutige Identifikator der Bestellung (eine Bestellung kann mehrere Bestellzeilen enthalten).
timestamp Ja Timestamp T14:02: Das Datum (und optional die Uhrzeit) der Transaktion (UTC-Zeitzone). Wenn nur das Datum angegeben ist (z.B. 2016-06-06), wird die Uhrzeit mit 00:00:00 angenommen.
customer Ja (entweder email oder customer String 12343-14B Der anonyme eindeutige Identifikator des Kunden, der die Bestellung vornimmt, wenn Ihr CRM einen solchen verwendet. Das muss ein externer Schlüssel (external key) sein, der auf das Feld externalID in Ihrer Emarsys-Datenbank verweist.
email email oder customer Email sportscar_fanatic@gmail.com Die E-Mail-Adresse des Kunden, der die Bestellung vornimmt, wenn Sie Ihre Kunden mittels E-Mail-Adresse identifizieren. Verwenden Sie diese Spalte nicht, wenn die Spalte customer bereits vorhanden ist. Bitte beachten Sie, dass aus Gründen des Datenschutzes die E-Mail-Adressen in den hochgeladenen historischen Verkaufsdaten verschlüsselt gespeichert werden; auf dieser Basis können die ursprünglichen E-Mail-Adressen nicht wiederhergestellt werden.
quantity Ja Float 5 Quantität (Anzahl) der gekauften Artikel.

Benutzerdefinierte Spalten

Zusätzlich zu den angegebenen Standardspalten kann es optional auch benutzerdefinierte Spalten geben. Die Namen von benutzerdefinierten Spalten haben ein Präfix in Form eines einzelnen Zeichens, das ihren Typ angibt, gefolgt von einem Unterstrich (_) und dem Namen der benutzerdefinierten Spalte. Benutzerdefinierte Spalten können leer sein. Wenn sie jedoch Daten des falschen Typs enthalten, wird die Datei bei der Validierung Fehler aufweisen.

Muster Spaltenname Typ Beispiel Spaltenname
i_* Integer i_customer_age
f_* Float f_customer_height
t_* Timestamp t_date_of_manufacture
s_* String s_book_author

Feldtypen

Typ Format
Integer Normales Integer, keine Dezimalstelle oder Tausendertrennzeichen.
Float Verwendet einen Punkt (.) als Dezimalzeichen und kein Tausendertrennzeichen.
Timestamp Datum im Format JJJJ-MM-TT oder Zeitstempel im Format JJJJ-MM-TTTHH:MM:SSZ, z.B. 2016-06-06 oder 2016-06-06T14:02:00Z. Wenn nur ein Datum angegeben ist, wird als Uhrzeit 00:00:00 angenommen.
String Optionale Zeichenkette (quoted string), ", um auf ein Anführungszeichen in einem Feld ein Escape anzuwenden, verdoppeln Sie es: "".
Email Format der E-Mail-Adresse, z.B.: j@j.com

Beispiele für Verkaufsdaten

Das folgende Beispiel zeigt Bestellungen für einen Schuhhandel mit zwei benutzerdefinierten Spalten:

item,price,order,timestamp,customer,quantity,s_color,f_size,t_published 103-nike-1,24.95,112343,2016-06-06T14:02:00Z,093275854,1,blue,14.5, 105-adidas-66,99.95,112343,2016-06-06,493027334,3,black,14.5,2016-09-20T15:00:00Z 107-nike-24,50.99,66234,2016-06-06T17:00:00Z,672985375,1,pink,12.5,2016-08-01

Ihre historischen Verkaufsdaten hochladen

Sobald Sie sicher sind, dass die Datei mit Ihren Verkaufsdaten so formatiert ist wie oben beschrieben, sollten Sie die Datei über das Predict Dashboard hochladen. Sie können ein und dieselbe Datei mehrmals hochladen, es werden dabei keine Daten dupliziert.

Sie können für diesen ersten Upload auch das API verwenden (siehe unten); für das Hochladen historischer Verkaufsdaten im Onboarding-Prozess ist jedoch der manuelle Upload die bevorzugte Vorgehensweise, weil Sie dabei die Datei überprüfen und etwaige Fehler direkt korrigieren können. Gehen Sie dazu wie folgt vor:

  • Auf der Seite Sales data klicken Sie Validate/upload file.
  • Suchen Sie nach der Datei mit den historischen Daten und wählen Sie diese aus.
  • Emarsys überprüft zuerst die Datei und ladet sie dann hoch.

Falls das System bei der Überprüfung Probleme erkennt, werden die entsprechenden Warnungen und Fehlermeldungen umgehend angezeigt:

upload-sales-data-error

Verkaufsdaten synchron halten

Sobald Sie Ihren ersten Upload vorgenommen haben, synchronisieren die Web Extend Scripts das Emarsys-System mit den täglichen Aktivitäten in Ihrem Webshop; Sie müssen aber trotzdem einen Zeitplan definieren, auf dessen Basis dann jene Verkaufsdaten synchronisiert werden, die Web Extend nicht erfasst. Das können beispielsweise Retouren oder Stornierungen sein, ebenso wie Offline-Daten aus dem stationären Handel. Zu diesem Zweck haben wir für Sie ein einfach zu bedienendes HTTP API eingerichtet.

Der Upload der Verkaufsdaten erfolgt, indem ein POST Request an folgenden Endpunkt gesendet wird:

  • https://admin.scarabresearch.com/hapi/merchant//sales-data/api

steht für die 16-stellige Merchant-ID, die Sie von Emarsys erhalten haben. Der Request sollte einen Authorization Header mit folgendem Wert enthalten:

  • Bearer

ist ein Sicherheitstoken, das Sie erhalten, wenn Sie den Button Show API upload details auf der Seite Sales Data des Predict Dashboard klicken.

Der Response hat einen HTTP Status Code von 200, wenn der Upload akzeptiert wurde (möglicherweise mit Warnungen), oder er hat den Status Code 400, wenn der Upload abgelehnt wurde, weil Format oder Inhalt der Verkaufsdaten ungültig sind. Die vollständigen Fehlermeldungen und Warnungen können auf der Seite Sales Data des Predict Dashboard angezeigt werden. Bei einem ungültigen oder fehlenden Sicherheitstoken wird ein Response mit dem Status 401 zurückgegeben.