Three PostHog events cover the funnel David described: how often the lookup gets it right, what people do when we show a match, and whether the screen costs us signups. The single-versus-multiple distinction rides as a property, not a separate event.
npi lookup completed (backend)Fires when the registry query returns, during the email-verify wait. Fires for every lookup, including the ones where the user never sees anything. Without this event the no-match rate, which is most signups, is invisible.
| Property | Values | Why |
|---|---|---|
outcome | single / multi / none / error | Match rate = share of lookups with outcome ≠ none. error covers registry timeouts, which skip silently. |
candidate_count | 0–4 | Survivors after all three filters (name + taxonomy + state). |
profession | signup profession value | Which professions match well. Feeds the taxonomy rollup question. |
lookup_ms | integer | Confirms the query hides inside the verify wait. |
npi candidate shown (frontend)Fires when the "Is this you?" screen renders. This is David's "NPI displayed" event.
| Property | Values | Why |
|---|---|---|
match_type | single / multi | The property David asked for: one confirm card versus the small picker. |
candidate_count | 1–4 | Picker size, for read-out by list length. |
npi candidate answered (frontend)Fires on any action the user takes on the screen.
| Property | Values | Why |
|---|---|---|
action | confirmed / picked / rejected / skipped | confirmed = yes on the single card; picked = chose from the picker; rejected = "not me"; skipped = "none of these are me". |
match_type | single / multi | Carried through so the funnel splits without a join. |
npi lookup completed where outcome ≠ none, over all lookups. David's rough sizing: ~3,000 signups/month, 70–80% US; half matching is ~1,000 NPI-verified signups a month.match_type. This is the single-versus-multi A/B answer.npi candidate shown with no npi candidate answered and no later signup-completion event in the session. The screen shows after email verification, so a bounce here still leaves a verified-email signup.