Log the Help Flag and the Actor with Every Event on the Path
Sample instrumentation schema
Companion to The Product Manager’s New Job Is Acceptance · Updated 2026-09-30
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 |
|---|---|
event, path_stage | What event tells us the transition occurred? |
minutes_since_stage_start | How long did it take? |
prerequisite_missing | What prerequisite was missing? |
intervention | Was there an intervention, and who performed it? |
voluntary | Was the transition voluntary? |
icp_version, product_version, message_version | 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 | schedule_import_completed |
| First useful action | first_intake_completed |
| Repeated use | third_intake_in_week_completed |
| Demonstrated value | time_saved_reported |
| Continuation | renewal_decided, user_added, referral_made |
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.