Dla programistów

API klientów i metryk

Zarejestruj klienta raz z jego wejściem, a potem zgłaszaj, co robi (depozyty, wydatki), jako ruchy metryk.

Rejestracja klienta

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

{ "externalId": "user-881", "hit": "h1.…", "displayName": "Jane D." }
  • externalId: Twoje własne ID klienta. Wymagane.
  • hit: wejście, z którym przyszedł. Wymagane. Klient jest wiązany z jednym wejściem, raz.
  • displayName: opcjonalne, nazwa, którą widzi zespół; bez niej klient jest anonimowym zwierzęciem.

Zgłaszanie, co robi

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: zarejestrowany klient; albo wyślij hit dla klienta, którego nie zarejestrowałeś.
  • requestId: Twoje własne ID tego zgłoszenia. To samo liczy się raz, więc ponowienie jest bezpieczne.
  • metrics: do 20, każda z code metryki i value, o które się zmieniła (ujemne, aby odjąć).

Dobrze wiedzieć

  • Najpierw utwórz metryki w Wyniki › Klienci › Metryki; nieznany kod jest odrzucany.
  • Oferty z udziałem w przychodach klientów płacą partnerowi klienta jego udział z każdego ruchu.

Sprawdzone z aplikacją 18 października 2026