Diese Aktion liest die JeriCommerce-Daten eines Kunden: sein Profil, seinen Punktestand und seine Stufe. Verwenden Sie sie, um in einer Automatisierung zu entscheiden, was als Nächstes passiert, etwa eine andere Nachricht an Kunden, die ihrer nächsten Prämie nahe sind, oder um Treuedaten in Ihren eigenen Systemen anzuzeigen.

Einrichtung

Verwenden Sie die JeriCommerce-Aktion Get customer in einem Shopify-Flow-Workflow. Sie gibt die JeriCommerce-Daten des Kunden an die nächsten Schritte weiter, sodass Sie sie in Bedingungen und Aktionen verwenden können.

1

Aktion hinzufügen

Öffnen Sie in Shopify Flow, erstellen oder bearbeiten Sie einen Workflow und fügen Sie nach Ihrem Auslöser Get customer hinzu.

2

E-Mail-Adresse eintragen

Tragen Sie unter Email die E-Mail-Adresse des Kunden ein. Wählen Sie sie mit Add variable aus dem Auslöser aus.

3

Daten in den nächsten Schritten verwenden

Wählen Sie in einer Bedingung oder einer späteren Aktion mit Add variable die benötigten Kundendaten aus, etwa den Punktestand. Die Daten sind wie in der API-Antwort gruppiert: loyaltyData enthält den Punktestand (balance), userData Name und Telefonnummer und customerTier die Stufenpunkte.

Gehört die E-Mail-Adresse zu keinem Kunden in Ihrem Programm, schlägt der Schritt fehl und der Grund erscheint im Ausführungsverlauf des Workflows.

Klaviyo-Webhooks können nur Daten senden, nicht lesen, daher kann ein Webhook keine Kundendetails abrufen. Sie brauchen auch keinen: Schalten Sie in der Klaviyo-Integration Custom Fields ein, und JeriCommerce hält diese Eigenschaften in jedem Klaviyo-Profil aktuell:

Klaviyo-Eigenschaft Enthält
balance Der Punktestand des Kunden.
tier-name Der Name seiner aktuellen VIP-Stufe.
tier-balance Seine Stufenpunkte.
tier-entered-at Wann er seine aktuelle Stufe erreicht hat.
tier-expires-at Wann seine aktuelle Stufe abläuft.
birthdate Sein Geburtsdatum.
jericommerce_download_wallet_pass_url Sein Downloadlink der Treuekarte.

Verwenden Sie sie in Flow-Filtern, Segmenten und Nachrichten wie jede andere Profileigenschaft. Wie Sie das einschalten und die vollständige Liste finden Sie unter Benutzerdefinierte Felder mit Klaviyo synchronisieren.

GET https://api.jericommerce.com/v1/programs/{program_slug}/customers/{email}

Ersetzen Sie {email} durch die E-Mail-Adresse des Kunden, URL-kodiert (zum Beispiel ana%2Bvip%40example.com für ana+vip@example.com). Senden Sie Ihren API-Schlüssel im Header api-key. Siehe Authentifizierung über die API.

Eine erfolgreiche Anfrage gibt 200 mit dem Kunden zurück:

{
  "id": "6f1d2c3b-...",
  "programId": "a1b2c3d4-...",
  "email": "customer@example.com",
  "origin": "SHOPIFY",
  "language": "en",
  "referral": null,
  "utmSource": null,
  "utmMedium": null,
  "utmCampaign": null,
  "balanceNotifications": true,
  "tierNotifications": true,
  "rewardAvailableNotifications": true,
  "locationNotifications": true,
  "marketingNotifications": true,
  "referralEarned": false,
  "joinedAt": "2026-03-02T10:15:00.000Z",
  "createdAt": "2026-03-02T10:15:00.000Z",
  "updatedAt": "2026-10-01T08:00:00.000Z",
  "userData": {
    "externalCustomerId": "4455885",
    "firstName": "Ana",
    "lastName": "García",
    "phone": null,
    "birthdate": "1990-05-14",
    "emailVerified": true
  },
  "loyaltyData": {
    "loyaltyCustomerId": "155445",
    "balance": 1250,
    "memberSince": "2026-03-02",
    "tierStatus": null,
    "referralLink": "https://..."
  },
  "customerTier": {
    "currentTierId": "9e8d7c6b-...",
    "carryTierId": "9e8d7c6b-...",
    "currentTierPoints": 320,
    "carryTierPoints": 900,
    "tierChangedAt": "2026-06-01T05:00:00.000Z",
    "recalculationDate": "2027-01-01T05:00:00.000Z"
  }
}

Die verschachtelten Objekte enthalten außerdem eigene Felder id, customerId, createdAt und updatedAt, die hier weggelassen wurden, damit das Beispiel kurz bleibt.

Kundenfelder

Feld Hinweise
origin Woher der Kunde kam: API, INITIAL_SYNC, JERICOMMERCE, SHOPIFY oder UNKNOWN.
language Die Sprache des Kunden. Kann null sein.
referral, utmSource, utmMedium, utmCampaign Wie der Kunde beim Beitritt gekommen ist. Können null sein.
balanceNotifications, tierNotifications, rewardAvailableNotifications, locationNotifications, marketingNotifications Die Wallet-Benachrichtigungen, die der Kunde erlaubt.
referralEarned true, wenn der Kunde seine Empfehlungsprämie bereits erhalten hat.
joinedAt Wann der Kunde dem Programm beigetreten ist. Kann null sein.

userData

Das Profil des Kunden. Es ist null, wenn der Kunde noch keine Profildaten hat. firstName, lastName, phone und birthdate können null sein. externalCustomerId ist die ID aus Ihrem System, gesendet mit der Kundensynchronisierung.

loyaltyData

Die Treueinformationen des Kunden. Sie sind null, wenn der Kunde noch keinen Punktestand hat. balance ist eine ganze Zahl von Punkten. tierStatus ist nur gefüllt, wenn ein externes Treuesystem ihn über die Loyalty-Synchronisierung sendet.

customerTier

Der Fortschritt des Kunden bei den VIP-Stufen. Er ist null, wenn das Programm keine Stufen hat oder der Kunde noch keine Stufe hat. Die Antwort enthält Stufen-IDs, keine Stufennamen.

Feld Hinweise
currentTierId, currentTierPoints Die Stufe, die der Kunde jetzt hat, und die im aktuellen Zeitraum gesammelten Punkte.
carryTierId, carryTierPoints Die Stufe und die Punkte, die aus dem vorherigen Zeitraum übernommen wurden.
tierChangedAt Wann sich die Stufe zuletzt geändert hat.
recalculationDate Die nächste Neuberechnung der Stufe. Kann null sein.

Wie aktuelle und übernommene Punkte funktionieren, steht unter Aktuelle vs. übernommene Punkte.

Gibt es keinen Kunden mit dieser E-Mail-Adresse, antwortet die API mit 404 und CUSTOMER_NOT_FOUND.

Erstellen Sie mit Ihren eigenen Werten eine fertige Anfrage:

Ihre Angaben

Sie finden ihn unter Settings > Technical > Program Information.

Erstellen Sie einen unter Settings > Technical > API Keys. Er bleibt in Ihrem Browser.

Ihre Anfrage

curl --request GET \
  --url 'https://api.jericommerce.com/v1/programs/your-program-slug/customers/customer%40example.com' \
  --header 'api-key: your-api-key'

Fügen Sie ihn in ein Terminal ein, um die Anfrage mit Ihrem Programm zu testen.