Personnes et cohortes
Les événements viennent de personnes, et l'annuaire se construit de ce qu'elles envoient : un id anonyme devient une personne au moment où un appel identify le nomme, les groupes arrivent de la même façon, et une cohorte est un ensemble enregistré de personnes défini par comportement ou état.
At a glance
- Identity
identifynames an anonymous id; write-once- Traits
$-prefixed traits are reserved; the rest are yours- Groups
group(type, key)rides the same pipeline- Cohorts
- Behavioural clauses are swept; state clauses are live
- Auth
- Project key to send, access token to read
- Les traits réservés portent le préfixe $ ; une propriété personnalisée nommée email reste personnalisée.
- L'identification s'écrit une fois : le moment où une personne a été nommée pour la première fois ne bouge jamais.
- La fusion est délibérée : deux ids ne se replient en une personne que sur demande, jamais par supposition.
Comment ça marche
Every event carries a distinct id, and the directory folds them into people: first seen, last seen, event and session counts, and the properties their identifying events carried. Identification is an event like any other, which is why an identify accepted with a 202 is accepted for processing rather than instantly visible. A cohort then names a set of these people: behavioural clauses count events over a window and are re-evaluated by a sweep that stamps when it ran; state clauses compare current attributes and are answered live. The same cohort scopes a workbench question, targets a campaign and gates a workflow trigger.
Où y accéder
| Surface | Operation |
|---|---|
| REST | POST /v1/identify · POST /v1/group (project key, accepted for processing) |
| GraphQL | people, person, peopleGroups, cohorts queries · mergePeople, createCohort, updateCohort, setCohortActive, deleteCohort mutations |
| Realtime | None of its own: the directory updates as events are processed |
| MCP | None |
Exemple
curl "https://eu.api.prodantix.com/v1/identify" \
-H "Authorization: Bearer $PRODANTIX_KEY" \
-H "Content-Type: application/json" \
-d '{ "distinct_id": "u_8f3a", "properties": { "$email": "ada@example.com", "plan": "pro" } }'prodantix.identify('u_8f3a', {
traits: { email: 'ada@example.com' },
set: { plan: 'pro' },
});
prodantix.group('team', 'acme', { tier: 'scale' });prodantix.identify('u_8f3a',
traits: PersonTraits(email: 'ada@example.com'),
set: {'plan': 'pro'});prodantix.identify(
"u_8f3a",
traits=PersonTraits(email="ada@example.com"),
set_props={"plan": "pro"},
)The directory is browsed on the People screen and cohorts are authored on Cohorts.