Sample instrumentation schema
The chapter “Instrument Each Transition on the Path” gives ten questions to ask of every transition. This page turns them into a sample event. Adapt the names to your system, and do not collect personal or regulated data you do not need.
One event
{
"event": "first_intake_completed",
"path_stage": "first_useful_action",
"occurred_at": "2026-10-12T14:31:07Z",
"account_id": "acct_0421",
"actor_role": "front_desk_coordinator",
"icp_version": "2",
"product_version": "4.2",
"message_version": "3",
"source_channel": "paid_search",
"minutes_since_stage_start": 11,
"prerequisite_missing": null,
"intervention": {
"occurred": false,
"actor": null,
"category": null
},
"voluntary": true,
"test_data": false
}
What each field answers
| Field | Question from the chapter |
|---|---|
|
What event tells us the transition occurred? |
|
How long did it take? |
|
What prerequisite was missing? |
|
Was there an intervention, and who performed it? |
|
Was the transition voluntary? |
|
Which version does this evidence describe? |
The question “what happened next” comes from the next event on the same account.
Events for the intake path
| Stage | Event |
|---|---|
Setup |
|
First useful action |
|
Repeated use |
|
Demonstrated value |
|
Continuation |
|
Rules
-
Record the help flag from the person who gave the help, at the time, in the system they already use.
-
Keep acceptance telemetry free of patient or other regulated data.
-
Tell users what you record, and keep a retention limit.