adapty-attribution

Adapty Attribution

Adapty Attribution matches installs and web purchases to ad clicks and reports them against the subscription revenue Adapty already holds for every user. You read it through the Adapty CLI's attribution topic, which is read-only: nothing you run here changes a campaign, a link or a setting.

Open references/playbooks.md when a question matches one of its playbooks. It holds the commands, the reading and the reply shape for each common question.

Which "attribution" the user means

The CLI

Resolve $ADAPTY once and use it for every call:

adapty attribution --help >/dev/null 2>&1 && ADAPTY="adapty" || {
  npm i -g adapty@latest >/dev/null 2>&1 && ADAPTY="adapty" || ADAPTY="npx --yes adapty@latest"; }

If $ADAPTY attribution --help still reports no such topic, try npx --yes adapty@beta attribution --help once before telling the user the topic is unavailable. --yes is required: without it npx waits for a confirmation nobody will give. In zsh, run setopt shwordsplit before using a multi-word $ADAPTY. When you show a command to the user, write a literal adapty in it.

• Find the app id with $ADAPTY apps list.
• Run $ADAPTY attribution metrics and $ADAPTY attribution dimensions before your first report, and take metric and dimension names from them. Family names such as d{N}_roas are templates: pass d7_roas, never d{N}_roas or d07_roas.
• Campaign, ad set and ad filters take ids. Get them from $ADAPTY attribution values --dimension campaign (or adset, ad) and match entities across periods by id, never by name.
• Run reports one at a time. The service runs only a few queries per company at once, and report and values are never retried for you. On attribution_busy, wait retry_after_seconds, then run the call once more.
• attribution_access_required means the company has no Attribution access, so spend, CPI and ROAS are out of reach. Logging in again will not fix it; say so once and run no more attribution calls. A question about which channel brings users, subscribers or money is still answerable from the app's subscription analytics: invoke growth-advisor now and answer it in this reply, by installs, trials, trial-to-paid and revenue per channel, saying spend and ROAS are not in them. Only a question about spend, CPI or ROAS itself ends here.