Kunden- und Metriken-API

Einen Kunden registrieren

POST https://<your workspace address>/track/clients
x-api-key: your API key

{ "externalId": "user-881", "hit": "h1.…", "displayName": "Jane D." }

• externalId: Ihre eigene ID für den Kunden. Pflicht.
• hit: der Hit, mit dem er kam. Pflicht. Ein Kunde wird einmal an einen Hit gebunden.
• displayName: optional, ein Name, den Ihr Team sieht; ohne ihn ist der Kunde ein anonymes Tier.

Melden, was er tut

POST https://<your workspace address>/track/clients/movements

{
  "externalClientId": "user-881",
  "requestId": "ledger-77310",
  "metrics": [ { "code": "tokens_spent", "value": 120 }, { "code": "deposits", "value": 49.9 } ]
}

• externalClientId: der registrierte Kunde; oder senden Sie hit für einen Kunden, den Sie nicht registriert haben.
• requestId: Ihre eigene ID für diese Meldung. Dieselbe zählt einmal, ein Wiederholen ist also sicher.
• metrics: bis zu 20, jede mit dem code einer Metrik und dem value, um den sie sich bewegte (negativ zum Zurücknehmen).

Gut zu wissen

• Legen Sie die Metriken zuerst unter Leistung › Kunden › Metriken an; ein unbekannter Code wird abgelehnt.
• Angebote mit Kundenumsatzanteil zahlen dem Partner des Kunden seinen Anteil an jeder Bewegung.