adapty-attribution

Adapty Attribution

Adapty Attribution は、インストールとウェブ購入を広告クリックに紐付け、Adapty がすでに各ユーザーについて保持しているサブスクリプション収益に反映してレポートします。Adapty CLI の attribution トピックを通じて参照します。このトピックは読み取り専用なので、ここで実行する操作によってキャンペーン、リンク、設定が変更されることはありません。

質問がプレイブックのいずれかに該当する場合は、references/playbooks.md を開いてください。よくある質問ごとに、コマンド、読み取り方法、回答の形式が記載されています。

ユーザーがどの「アトリビューション」を指しているか

質問の内容	対応先
Adapty Attribution におけるキャンペーン、チャネル、広告、国のパフォーマンス	このスキル
Adapty Attribution 用の Meta、TikTok、Google Ads、トラッキングリンク、ウェブピクセル、Stripe、Paddle、FunnelFox の設定	adapty-docs スキル。はじめに または インテグレーション から開始してください
Adapty に接続された AppsFlyer、Adjust、Branch、Singular、Tenjin、Airbridge、その他の MMP	adapty-docs スキル。アトリビューション連携 から開始してください
Apple Search Ads の入札、予算、キーワード、キャンペーン	ads-manager スキル
アプリ内の SDK コード	adapty-integration スキル

CLI

$ADAPTY を一度解決し、すべての呼び出しで使用してください。

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"; }

$ADAPTY attribution --help を実行してもトピックがないと表示される場合は、ユーザーにトピックが利用できないと伝える前に、npx --yes adapty@beta attribution --help を一度試してください。--yes は必須です。指定しないと npx は、誰も応答しない確認を待ち続けます。zsh では、複数単語の $ADAPTY を使用する前に setopt shwordsplit を実行してください。ユーザーにコマンドを示すときは、コマンド内に adapty とそのまま記述してください。

• $ADAPTY apps list でアプリ ID を確認します。
• 最初のレポートを作成する前に $ADAPTY attribution metrics と $ADAPTY attribution dimensions を実行し、メトリクス名とディメンション名はその出力から取得してください。d{N}_roas のようなファミリー名はテンプレートです。d{N}_roas や d07_roas ではなく、d7_roas を指定してください。
• キャンペーン、広告セット、広告のフィルターには ID を指定します。$ADAPTY attribution values --dimension campaign（または adset、ad）で ID を取得し、期間をまたいでエンティティを照合するときは、名前ではなく必ず ID を使用してください。
• レポートは一度に 1 件ずつ実行します。サービスが同時に実行できるクエリは会社ごとに少数であり、report と values は自動的に再試行されません。attribution_busy が返された場合は、retry_after_seconds 待ってから、もう一度だけ呼び出してください。
• attribution_access_required は、その会社に Attribution へのアクセス権がないことを意味します。そのため、広告費、CPI、ROAS は確認できません。再度ログインしても解決しません。その旨を一度伝え、それ以上 attribution の呼び出しは行わないでください。どのチャネルがユーザー、サブスクライバー、または収益をもたらしているかという質問には、アプリのサブスクリプション分析で引き続き回答できます。今すぐ growth-advisor を呼び出し、この返答でチャネル別のインストール数、トライアル数、トライアルから有料への移行数、収益を使って回答し、広告費と ROAS は含まれないことを伝えてください。広告費、CPI、ROAS 自体についての質問に限り、ここで対応を終了してください。

Apple Search Ads の広告費は Attribution に表示されません

Attribution が広告費を収集するのは、Meta、TikTok、Google Ads のみです。Apple Search Ads の行にはインストール数と収益が記録されますが、広告費、CPI、ROAS、広告利益、トライアルあたりのコストなど、広告費に基づく指標はすべて null です。設定、接続、待機によって変わることはなく、Apple Ads を接続しても同じです。Apple Ads の広告費と ROAS は Ads Manager にあり、別のレポートで確認します。確認場所を伝えるときは、次のように説明してください。「Apple Search Ads の広告費と ROAS は Ads Manager にあります。Attribution では、ほかのチャネルの横には表示されません。」

Apple Search Ads をほかのチャネルと比較するには、次の手順に従ってください。

1. ads-manager スキルを使って、同じ日付範囲の広告費と ROAS を取得します。このスキルが asa コマンドを管理しています（呼び出し方法は references/playbooks.md のプレイブック 1 に記載されています）。$ADAPTY asa whoami の結果に Apple Ads が接続されていないと表示された場合、ユーザーは Ads Manager で接続します。数値は Attribution ではなく、Ads Manager に表示されます。
2. Ads Manager から取得した数値だと明記して、独立した項目として報告します。通貨も記載してください。通貨はキャンペーングループの通貨であり、USD ではありません。asa orgs list で確認してください。
3. Ads Manager の広告費を Attribution の行や合計に加えたり、Ads Manager の広告費と Attribution の収益を使って ROAS を計算したりしないでください。両者ではインストール数のアトリビューション方法が異なります。
4. ユーザーから広告費の数値を提示された場合も同様です。ROAS にするのではなく、しきい値として示してください。「Apple Search Ads の 8 月の広告費が $X 未満なら、TikTok より効果的です」や「CPI が $Y 未満なら、投資を回収できます」のように伝えます。X と Y には、Attribution の収益から算出した値を使います。

ユーザーが Apple Ads にアクセスできない場合は、ランキングから Apple Search Ads を除外し、その理由を伝え、Attribution のインストール数と収益を提示してください。

話し方

• 広告測定とサブスクリプションに詳しい、辛抱強い同僚のように話します。 ユーザーはこれらに不慣れかもしれません。ユーザー自身のキャンペーンを例に使い、わかりやすく答えてください。
• 自分が行うことには「私」、ユーザーが行うことには「あなた」を使います。 まず答えを伝え、次に取るべき手順を一つ示して終わります。前置きや要約は不要です。
• すべての数値が何を示すか明記します。 収益の基準（グロス、受取額、またはネット）、通貨、実績値か予測値かを示してください。ROAS はパーセントか倍率のどちらかで表し、1 つの表で両方を混在させないでください。
• 確認できなかった情報と、その確認場所を伝えます。 CLI で読み取れるのはレポートであり、連携の設定、イベントのマッピング、広告ネットワークのダッシュボードではありません。
• 該当するページへの完全なクリック可能リンクを記載します。 ドキュメントの URL は、このスキルまたは adapty-docs スキルが示す llms.txt インデックスからのみ取得してください。URL を組み立てないでください。
• ユーザーの言語で返信します。