Reporting

What each metric counts, what it excludes, and why the funnel is narrower than you might expect.

Every metric Vouch returns carries a definitions entry explaining how it was counted. The dashboard shows it on hover. They are repeated here so you can check a number before you act on it.

Metrics

Metric	Counts
`invites_sent`	Share events your app reported. One user sharing twice counts twice.
`clicks`	Resolver hits on this programme's links. Bots and link previews are excluded.
`installs`	Referrals attributed to an inviter, one per invitee device.
`sign_ups`	Attributed invitees who identified with your own user id.
`qualified`	Referrals whose every condition was met. Referrals held for review are not counted until approved.
`rewards_granted`	Rewards in the `granted` state. Held, failed and reversed rewards are excluded.
`k_factor`	Qualified referrals divided by participants: the average number of new qualified users each inviter brings.
`from_code`	Referrals created by someone typing a code rather than following a link.

The funnel

invite_sent → click → install → signup → qualified

Each step is a strict subset of the one before it, because the funnel counts link-sourced referrals only. That is deliberate: a code typed into your app creates a referral with no click behind it, and including those would make a later step larger than an earlier one.

Code redemptions are not lost. They appear in from_code and in the totals, just not in a funnel that would stop making sense if they did.

Deterministic against probabilistic

Installs are reported split by how they were matched.

Group	Match types
Deterministic	`install_referrer`, `clipboard`, `session`, `code`
Probabilistic	`probabilistic`

Read the split before you read the total. A programme running mostly on probabilistic matches is reporting inferences, and you should treat its numbers with more caution than one running on tokens. Ambiguous matches appear in neither group, because they were never attributed to anyone.

Reward cost

Cost is reported per unit, as a list, never as one number:

"reward_cost": [
  { "unit": "credits", "amount": 4200 },
  { "unit": "GBP", "amount": 10500 }
]

Credits, coupons and entitlement days are not the same kind of thing, and adding them together would produce a total that means nothing. If you want a single currency figure, give your rewards a cost_minor and a currency and Vouch will report money alongside quantity.

Leaderboard

Inviters ranked by qualified referrals, for showing people where they stand inside your app.

curl https://api.vouch.dev/v1/referral-programmes/rpg_123/leaderboard \
  -H "Authorization: Bearer sk_live_…"

What is not here yet

Retention and revenue of referred users against everyone else needs revenue data that arrives with the Web-to-App module. It is not in this release, and no proxy for it is shown, because a misleading cohort chart is worse than none.