Terminal
Terminal/Skill
Answers questions about ad campaign, channel and country performance in Adapty Attribution, such as ROAS and installs, and where to move budget (read only).
By Adapty
Works with
npx skills add adaptyteam/adapty-skills --skill adapty-attributionAdapty 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.
| The question is about | Where it goes |
|---|---|
| Campaign, channel, ad or country performance in Adapty Attribution | This skill |
| Setting up Meta, TikTok, Google Ads, tracking links, the web pixel, Stripe, Paddle or FunnelFox for Adapty Attribution | The adapty-docs skill. Start at Get started or Integrations |
| AppsFlyer, Adjust, Branch, Singular, Tenjin, Airbridge or another MMP connected to Adapty | The adapty-docs skill. Start at Attribution integrations |
| Apple Search Ads bids, budgets, keywords or campaigns | The ads-manager skill |
| SDK code in the app | The adapty-integration skill |
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.
$ADAPTY apps list.$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.$ADAPTY attribution values --dimension campaign (or adset, ad) and match entities across periods by id, never by name.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. Logging in again
will not fix it; say so and stop.Attribution collects ad spend from Meta, TikTok and Google Ads only. Apple Search Ads rows carry
installs and revenue, and every spend-based metric on them — spend, CPI, ROAS, ad profit, cost per
trial — is null. No setting, connection or wait changes that, and connecting Apple Ads does not
either: its spend and ROAS live in Ads Manager, a separate report. When you say where to find them,
say it this way: "Apple Search Ads spend and ROAS are in Ads Manager. They will not appear next
to the other channels in Attribution."
To judge Apple Search Ads next to the other channels:
ads-manager skill, which owns the asa commands, for the
same dates (the call is in references/playbooks.md, playbook 1). If $ADAPTY asa whoami says
Apple Ads is not connected, the user connects it in Ads Manager, and its numbers appear there,
not in Attribution.asa orgs list.If the user has no Apple Ads access, leave Apple Search Ads out of any ranking, say why, and give its Attribution installs and revenue.
llms.txt index the adapty-docs skill names; never assemble one.