Klanten- en metrics-API

Een klant registreren

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

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

• externalId: je eigen ID voor de klant. Verplicht.
• hit: de hit waarmee hij kwam. Verplicht. Een klant wordt één keer aan één hit gekoppeld.
• displayName: optioneel, een naam die je team ziet; zonder is de klant een anoniem dier.

Melden wat hij doet

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: de geregistreerde klant; of stuur hit voor een klant die je niet registreerde.
• requestId: je eigen ID voor deze melding. Dezelfde telt één keer, dus herhalen is veilig.
• metrics: tot 20, elk met de code van een metric en de value waarmee hij bewoog (negatief om terug te nemen).

Goed om te weten

• Maak de metrics eerst in Prestaties › Klanten › Metrics; een onbekende code wordt geweigerd.
• Aanbiedingen met een klantomzetaandeel betalen de partner van de klant zijn deel van elke beweging.