Mit JeriCommerce können Sie Tokens für zwei Arten von Kundenlinks erstellen: Downloadlinks für den Wallet-Pass (Apple Wallet oder Google Wallet) und Sitzungslinks, die Kunden direkt in der Kunden-App anmelden.
Diese Links eignen sich zum Versenden per E-Mail oder SMS sowie zum Einfügen in die eigene Website oder App.
Das benötigen Sie ¶
- Ihren API Key – Sie finden ihn unter JeriCommerce Admin → Settings → Technical → API Keys.
- Ihre Program ID (oder den Slug) – sichtbar in den Programmeinstellungen
- Die E-Mail-Adresse des Kunden
Funktionsweise ¶
- Rufen Sie den Endpunkt Get Customer Token mit der E-Mail-Adresse des Kunden und dem gewünschten Tokentyp auf.
- Die API gibt ein
accessTokenzurück. - Kodieren Sie das Token mit Base64 und erstellen Sie die URL in einem der unten gezeigten Formate.
Downloadlinks für Wallet-Pässe ¶
Um einen Link zu erstellen, über den ein Kunde seine Treuekarte herunterladen kann, fordern Sie ein Token mit token_type=download an und erstellen Sie die folgende URL:
https://jeri.link/{program-slug}/download?token={base64Token} Wenn Kunden diesen Link öffnen, können sie zwischen Apple Wallet und Google Wallet wählen.
JeriCommerce synchronisiert diese Download-URL bereits automatisch über Integrationen. Wenn Sie Shopify oder Klaviyo verwenden, müssen Sie den Link möglicherweise nicht manuell erstellen. Weitere Informationen: Download-URL der Treuekarte mit Shopify-Profilen synchronisieren, Custom Fields mit Shopify synchronisieren und Custom Fields mit Klaviyo synchronisieren.
Sitzungslinks für die Kunden-App ¶
Um einen Link zu erstellen, über den ein Kunde direkt in einem bestimmten Bereich der Kunden-App angemeldet wird, fordern Sie ein Token mit token_type=auth an und erstellen Sie die URL mit einem redirectTo-Pfad:
https://jeri.link/{program-slug}/{base64Token}?redirectTo={path}
Verfügbare Bereiche ¶
| Pfad | Ziel |
|---|---|
profile |
Kundenprofil |
loyalty/rewards |
Verfügbare Prämien |
loyalty/earning-flows |
Sammelaktionen für Punkte |
referrals |
Empfehlungsprogramm |
coupons |
Coupons des Kunden |
transactions |
Transaktionsverlauf |
Verwenden Sie beispielsweise den Pfad loyalty/rewards, um Kunden aus einer Werbe-E-Mail direkt zur Prämienseite zu leiten.
URL-Formate auf einen Blick ¶
| Linktyp | URL-Format |
|---|---|
| Download | https://jeri.link/{slug}/download?token={base64Token} |
| Sitzung | https://jeri.link/{slug}/{base64Token}?redirectTo={path} |
API-Dokumentation ¶
Die vollständige Beschreibung des Endpunkts, Anfrageparameter, Codebeispiele und Fehlerbehandlung finden Sie beim Endpunkt Get Customer Token in der JeriCommerce-API-Dokumentation.