Inhalt:
Ihren ersten Upload vornehmen
Wenn Sie ein Smart Insight Kunde sind, können Sie sich nach wie vor dafür entscheiden, Ihre Salesdaten zu unseren SFTP-Servern hochzuladen. Bitte beachten Sie jedoch, dass es sich dabei um eine Legacy-Option handelt, die im Vergleich zur Verwendung des Sales Data API mehrere Nachteile aufweist. Wenn Sie die Verwendung unserer SFTP dennoch vorziehen, kontaktieren Sie bitte den Emarsys Support.
Sobald Ihre Salesdatendatei bereit und unseren Spezifikationen gemäß formatiert ist, laden Sie die Datei über die Seite Sales Data hoch.
Um die Seite Sales Data zu öffnen, gehen Sie zu Admin > Data Sources; im Bereich Sales Data klicken Sie entweder Set up sales data uploads (für einen ersten Datei-Upload) oder Manage sales data (wenn Sie bereits zumindest eine Datei mit Salesdaten hochgeladen haben).
Duplizierte Daten
- Wenn Sie dieselbe Datei öfter als einmal hochladen, werden keine Daten dupliziert, vorausgesetzt, der Dateiname bleibt unverändert.
- Wenn Sie dieselbe Datei mit einem anderen Namen (z. B. mit einer aktualisierten Timestamp) hochladen oder unterschiedliche Dateien hochladen, welche dieselben Bestellungen enthalten, werden die Daten dupliziert.
Die Spalten im Header Ihrer Salesdatendatei müssen genau jene Reihenfolge haben, die im Rahmen der Smart Insight Onboarding Implementierung festgelegt wurde. Ist dies nicht der Fall, wird der Upload fehlschlagen.
Die Spalten werden in der festgelegten Reihenfolge ganz oben auf der Seite Sales Data angezeigt, zum Beispiel:
Achten Sie darauf, dass die erforderlichen Felder mit Groß- und Kleinbuchstaben eingegeben werden, sonst erkennt das System sie nicht. „Preis“ ist nicht dasselbe wie „preis“. „Preis“ wird als benutzerdefiniertes Feld erkannt und bekommt ein Präfix, z. B. „f_“, also „f_Preis“. In diesem Fall fehlt das Preisfeld.
Der manuelle Upload über die Seite Sales Data ist die bevorzugte Vorgehensweise für den ersten Upload historischer Salesdaten während des Onboarding, weil Sie dabei die Datei überprüfen und etwaige Fehler sofort korrigieren können. Gehen Sie dazu wie folgt vor:
- Auf der Seite Sales Data klicken Sie Validate/upload file.
- Suchen Sie nach der Salesdatendatei und wählen Sie diese aus.
- Bei Problemen werden Warnungen und Fehlermeldungen angezeigt. Beheben Sie diese und versuchen Sie, neuerlich hochzuladen.
- Wenn keine Probleme angezeigt werden, finalisieren Sie den Upload, indem Sie Activate upload klicken.
Sie können Ihre Salesdatendatei nicht hochladen, solange diese Fehler enthält; die Fehler müssen zuerst behoben werden.
Regelmäßige Updates einrichten
Wenn Sie ein Smart Insight Kunde sind, können Sie sich nach wie vor dafür entscheiden, Ihre Salesdaten zu unseren SFTP-Servern hochzuladen. Bitte beachten Sie jedoch, dass es sich dabei um eine Legacy-Option handelt, die im Vergleich zur Verwendung des Sales Data API mehrere Nachteile aufweist. Wenn Sie die Verwendung unserer SFTP dennoch vorziehen, kontaktieren Sie bitte den Emarsys Support.
Sobald Sie Ihre historischen Salesdaten in einem einmaligen Vorgang hochgeladen haben, müssen Sie regelmäßige Updates einrichten. Am einfachsten lassen sich regelmäßige automatisierte Salesdatenimporte nach Emarsys über das Sales Data API durchführen.
Öffnen Sie die Seite Sales Data, indem Sie zu Admin > Data Sources gehen; im Bereich Sales Data klicken Sie Manage sales data. Dann klicken Sie Show API upload details; damit werden alle Informationen angezeigt, die Sie benötigen, um den Import mit minimalem Aufwand einrichten zu können.
Der Upload von Salesdaten erfolgt inkrementell, das heißt, neuere Uploads werden zu den bestehenden Salesdaten hinzugefügt und überschreiben diese nicht.
Duplizierte Daten
Das Problem kann auf zwei Arten gelöst werden:
- Teilen Sie den Inhalt der Datei auf 2 Dateien auf und laden Sie diese noch einmal hoch, oder
- duplizieren Sie eine der Zeilen in der Datei und laden Sie diese noch einmal hoch.
Beide Vorgehensweisen führen dazu, dass in Smart Insight Daten dupliziert werden. Um dieses Problem zu lösen, müssen Sie die Smart Insight Datenbank bereinigen und ihre -sauberen - historischen Salesdaten noch einmal hochladen.
Sales Data API - Spezifikationen
Endpoint
POST https://admin.scarabresearch.com/hapi/merchant/<merchant-id>/sales-data/api
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
| merchant-id | string | Ihre 16-stellige Merchant-ID, die Sie von Emarsys erhalten haben. |
Header-Parameter
Der Request sollte einen Authorization Header mit folgendem Wert enthalten:
Bearer <token>
<token> ist ein Sicherheitstoken, das Sie erhalten, wenn Sie den Button Show API upload details auf der Seite Sales Data klicken.
Request-Body
Sie müssen die .csv-Datei mit den Salesdaten als binäre Payload (data-binary) im Request-Body hochladen. Informationen zum akzeptierten Format erhalten Sie in: Ihre Salesdatendatei formatieren
Request-Beispiel (curl)
curl --request POST \ --header 'Authorization: Bearer <token> \ --header 'Content-type: text/csv' \ --header 'Accept: text/plain' \ --data-binary @/myhome/salesdata-2018-03-26.csv \ https://admin.scarabresearch.com/hapi/merchant/<id>/sales-data/api
Livestreaming
Standardmäßig bündeln, validieren und übergeben unsere Server die Events in stündlichen Batches. Wenn das API nicht nach jedem Kaufevent in einem eigenen Request aufgerufen wird (und auch nicht öfter als alle 5 Minuten), können Sie den Parameter ?live=false zur Endpoint URL anfügen. Damit werden die Salesdaten mit einer höheren Frequenz als einmal stündlich verarbeitet.
Komprimierung
Die gzip-Komprimierung wird unterstützt. Um Dateien mit gzip-Komprimierung hochzuladen, verwenden Sie den Header Content-Encoding: gzip.
Responses
| HTTP-Code | Meldung |
|---|---|
| 200 | Upload is accepted (with possible warnings). --- Upload wurde akzeptiert (mit möglichen Warnungen). |
| 200 | Event(s) queued by Live API. See the status within one hour at Emarsys > Admin > Data Sources > Sales Data --- Event(s) vom Live API gereiht. Der Status kann in spätestens einer Stunde unter Emarsys > Admin > Data Sources > Sales Data eingesehen werden. |
| 400 | Upload is rejected due to errors. --- Upload wurde aufgrund von Fehlern zurückgewiesen. |
| 401 | Security token is invalid or missing. --- Das Sicherheits-Token ist ungültig oder fehlt. |