Erste Schritte
Dieser Ablauf führt neue Händler von der Kontoerstellung bis zu einem geprüften Shop-Ereignis. Am Ende verfügen Sie über einen aktiven Shop, einen standortgebundenen API-Schlüssel, das Browser-SDK und sichtbare Daten in Analytics.
Der Browser sendet eine erfolgreiche Anfrage an POST /api/v1/events/batch auf Ihrer Upsurge-Domain, und Analytics zeigt Aktivität für den verbundenen Shop.
Voraussetzungen
Sie benötigen:
- die Berechtigung, einen Upsurge-Arbeitsbereich zu erstellen oder einen bestehenden zu verwenden;
- die Shop-Domain, einschließlich der genauen Staging-Domain für Tests;
- die Berechtigung, ein Skript im Shop einzubinden;
- einen sicheren Ort, um den einmal angezeigten Standort-API-Schlüssel zu speichern.
Für die Installation per Browser-Skript ist kein Paketmanager erforderlich.
Der Einrichtungsablauf
| Schritt | Aufgabe | Ergebnis |
|---|---|---|
| 1 | Konto und Arbeitsbereich erstellen | Das Händler-Dashboard ist verfügbar. |
| 2 | Shop verbinden | Der Standort und sein aktiver API-Schlüssel existieren. |
| 3 | Browser-SDK installieren und initialisieren | Upsurge erfasst automatisch den ersten Seitenaufruf. |
| 4 | Erstes Ereignis senden und prüfen | Das Tracking ist durchgängig bestätigt. |
| 5 | Ein Produkt zur Aktivierung auswählen | Sie können eine Kampagne oder einen Workflow erstellen. |
Die drei Bezeichner
Arbeitsbereich : Das Händlerkonto, dem Standorte, Benutzer, Kampagnen, Workflows, Integrationen und Analytics gehören.
Standort : Ein registrierter Shop mit Domain. Kampagnen und Analytics können auf einen Standort begrenzt werden.
Standort-API-Schlüssel : Der Schlüssel ordnet Browser-SDK- und öffentliche API-Anfragen einem Standort zu. Der vollständige Wert wird nur bei Erstellung oder Erneuerung angezeigt.
Nach Verlassen der einmaligen Anzeige ist nur noch das Präfix sichtbar. Eine Erneuerung widerruft den vorherigen aktiven Schlüssel; Installationen mit dem alten Wert funktionieren dann nicht mehr.
Nächster Schritt
Nutzen Sie Event-Tracking für den vollständigen Commerce-Ereignissatz, Overlays für Onsite-Erlebnisse, Chatbots für einen Einkaufsassistenten oder die API-Referenz für direkte Integrationen.
Bei Problemen hilft die Fehlerbehebung. Nicht übersetzte Detailseiten werden vorübergehend in der geprüften englischen Fassung angezeigt.