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 mit Verkaufsdaten formatieren
- Ihre historischen Verkaufsdaten hochladen
- Verkaufsdaten synchron halten
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 |
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: "". |
| 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-01Ihre 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:
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.
- Hier können Sie ein Beispiel für eine Verkaufsdaten-Importdatei herunterladen.