고객과 지표 API

고객 등록

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

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

• externalId: 내 고객 ID. 필수입니다.
• hit: 고객이 들어온 방문. 필수입니다. 고객은 한 방문에 한 번만 묶입니다.
• displayName: 선택. 팀에 보이는 이름이며, 없으면 고객은 익명의 동물이 됩니다.

행동 보고

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: 등록된 고객. 또는 등록하지 않은 고객이라면 hit를 보냅니다.
• requestId: 이 보고의 내 ID. 같은 ID는 한 번만 집계되므로 다시 보내도 안전합니다.
• metrics: 최대 20개. 각각 지표의 code와 바뀐 value(빼려면 음수)를 가집니다.

알아 두면 좋은 점

• 먼저 성과 › 고객 › 지표에서 지표를 만드세요. 알 수 없는 코드는 거절됩니다.
• 고객 수익 공유가 있는 오퍼는 변동마다 고객의 파트너에게 그 몫을 지급합니다.