Apple Ads プラグインを使うと、AIコーディングツールからAdapty CLIを通じてApple Adsアカウントを操作できます。自然言語で質問するだけで、どのコマンドが必要かを判断し、まずアカウントの内容を読み取ってから、Appleへの変更を実際に送信する前に提案を行います。

スキルとは、AIツールがオンデマンドで読み込む一連の指示です。このプラグインには3つのスキルが含まれています。アカウントを操作するオペレーター、読み取り専用の監査担当者、そして戦略プランナーです。加えて、週次チェックイン、コホートROASレビュー、予算再配分といった定期的な作業向けのプレイブック、カテゴリ固有のキーワード分類と初期経済指標を含む業種別ガイド、そして最も一般的な作業をワンライナーで実行できるスラッシュコマンドも同梱されています。これらが組み合わさることで、Ads Managerの操作で間違いやすい部分をカバーします。各フラグが受け付ける識別子、各リストに使えるフィルター、バッチに収まるキーワード数、そして費用が発生する呼び出しはどれかといった情報です。

何を処理するか

• 読み取りパフォーマンス: 質問に答える単一の呼び出しを選択し、結果をページングしません。上位N件の質問は並び替えられた1回の呼び出しであり、エンティティのカウントにはメトリクス呼び出しが不要であることを把握しています。
• 構造的な変更: キャンペーン、広告グループ、広告、キーワードを正しい順序で作成・更新し、子エンティティを書き込む前に親エンティティを読み取ります。
• キーワード作業: キーワードをバッチで追加・再入札し、検索語句をキーワードおよびネガティブキーワードに変換します。
• 自動化: ルールベースの自動化を設定し、ライブ入札に影響を与える前にドライランを実行します。
• 競合調査: 競合アプリが入札しているキーワードを取得します。
• アカウント監査: apple-ads-audit スキルは、何も変更せずにアカウントの健全性、配信ステータス、構造、重複キーワードを確認します。
• ゼロからの計画: apple-ads-strategy スキルは、アプリの説明からアカウント構造、キーワード分類、初期予算を設計します。Apple Ads アカウントや CLI は不要です。

実行しないこと

このプラグインはすべての書き込みを不可逆的なものとして扱います。実際そうであり、CLIには削除機能がなく、変更は数秒以内にAppleに反映されます。

• IDや予算を推測せず、書き込む前に読み取りを行います。
• 費用が発生するコマンドを実行する前に確認を求め、あなた自身がコマンドを実行する際はCLI独自の確認プロンプトもそのまま残します。
• 一連の書き込みそれぞれにべき等キーを設定するため、結果が不明瞭なまま再実行しても2つ目のキャンペーンが作成されません。
• 小さなバッチを優先するため、Appleからの部分的な拒否が確認しやすくなります。

プラグインのインストール

Apple Ads プラグインは、AI コーディングツールが adapty asa コマンドで Apple Ads を操作できるようにします。3 つのスキルを提供します：

• apple-ads: オペレーター。パフォーマンスの確認、入札額・予算の変更、キーワードや除外キーワードの追加、検索ワードの収集、キャンペーンの開始・停止を行います。お金が動く操作の前には必ず確認を求めます。
• apple-ads-audit: 読み取り専用の監査ツール。アカウントの健全性、配信ステータス、構造、トラフィックの所有状況、完全一致キーワードの重複をチェックします。書き込みは行いません。
• apple-ads-strategy: アカウント、CLI、サブスクリプションなしで使えるプランニングツール。アプリの説明からアカウント構造、キーワード分類、初期予算、除外キーワードリストを生成します。

対応ツール: Claude Code、Claude Cowork、GitHub Copilot CLI、OpenAI Codex、Gemini CLI、その他スキルに対応したすべてのツール。

オペレーターと監査ツールは Adapty CLI を通じて動作するため、まず CLI のインストールと認証を行ってください — クイックスタートガイドを参照してください。adapty asa コマンドは Adapty CLI 0.4.0 以降に含まれており、古いバージョンでは存在しません。adapty asa whoami で確認できます。このコマンドは Apple Ads アカウントが接続されているか、また会社が有効な Ads Manager サブスクリプションを持っているかも教えてくれます。ストラテジースキルはこれらがなくても使用できます。

Claude Cowork は、許可リスト外のすべてのドメインをブロックするサンドボックス内で CLI を実行します。プラグインをインストールする前に Adapty のドメインを許可してください — Cowork で CLI を実行するを参照してください。Cowork タスクはクリーンなマシン上で開始されるため、CLI とそのログイン状態はセッション間で引き継がれません。プラグインの adapty-cli-setup スキルが各セッションの開始時に CLI のインストールと認証を再度行います。

インストールするには、お使いのツールに合った形式を選んでください。全リストはプラグインの README にあります。

Claude Code

claude plugin marketplace add adaptyteam/apple-ads-cli
claude plugin install apple-ads@adapty

スキルに加えて、Claude Code プラグインは /asa-* スラッシュコマンドもインストールします。これは一般的な作業向けのプロンプトで、週次チェックイン用の /asa-review や検索ワードをキーワードと除外キーワードに変換する /asa-harvest などがあります。

その他のツール — skills CLI を使用してください（この方法でインストールしたスキルは自動更新されません）：

npx skills add adaptyteam/apple-ads-cli --all

--all は 3 つのスキルすべてを検出されたすべてのエージェントにインストールします。個別のスキルをインストールするには --skill を使用します（例：--skill apple-ads-strategy）。

インストール後、プロジェクト内でスキルを直接実行するか、スラッシュコマンドから実行します：

/apple-ads

指標の読み取りとドライランは無料です。それ以外のコマンドは数秒以内に Apple に届き、実際のお金が動き、取り消すことができません。スキルは実行前に必ず確認を求めます。あなた自身も同様に確認するようにしてください。

ベンチマークプラグイン

同じマーケットプレイスには、オプションのコンパニオンプラグインとして apple-ads-benchmarks も公開されています。これはAdaptyが提供するApple Adsのサブスクリプションアプリ向けベースラインデータで、AIツールがクエリできるローカルデータとしてパッケージ化されています。90カ国、22のApp Storeジャンル、59のニッチ領域にわたるタップスルー率、コンバージョン率、CPT、CPA、さらに初年度LTVなどのサブスクライバー経済指標も含まれています。完全にオフラインで動作するため、Apple Adsアカウント、CLI、Adaptyのサブスクリプションはいずれも不要です。

この情報を使って、アカウントの詳細を調べる前に数値に問題があるかどうかを判断しましょう。「ドイツのフィットネスアプリで CPT が 4 ドルというのは高いですか？」はまずベンチマークの質問です。

Claude Code

claude plugin marketplace add adaptyteam/apple-ads-cli
claude plugin install apple-ads-benchmarks@adapty

その他のツール

npx skills add adaptyteam/apple-ads-benchmarks --all

スラッシュコマンド

Claude Code では、プラグインが9つの /asa-* コマンドも追加します。各コマンドは、よく使われる作業に適したスキルとプレイブックを自動的に選択する既製のプロンプトです。プロンプトを自分で書く代わりに、このコマンドを入力するだけで使えます。

コマンド	機能
/asa-review	週次チェックイン — 方向性、インストール比較、外れ値、アクションの提案
/asa-audit	読み取り専用のアカウントヘルスチェックまたはライブ構造の監査
/asa-bids	コホート ROAS に基づく入札額のレビューと調整
/asa-budget	キャンペーン間での予算の再配分
/asa-harvest	検索語句を完全一致キーワードおよびネガティブキーワードとして取り込む
/asa-negatives	検索語句から最小限のネガティブキーワードを抽出
/asa-opportunities	Market Intelligence からの競合キーワードの機会を発見
/asa-cpp	キーワードのインテントを既存のカスタムプロダクトページと広告にルーティング
/asa-launch	新しい Apple Search Ads キャンペーンの計画と立ち上げ

Slash commands install with the Claude Code plugin. In other tools, ask for the same jobs in plain language — the skills carry the same playbooks.

プロンプトの例

スキルにはすでにコマンド、その実行順序、どのコマンドが費用を消費するかが含まれているため、プロンプトでそれらを説明する必要はありません。スキルだけでは判断できない内容をプロンプトに書きましょう。つまり、キャンペーンの評価に使う指標と期間、比較対象のベンチマーク、そして返答の形式です。

すでに運用中のアカウントを監査する

キャンペーンが稼働中で、費用の流れを把握したい場合に使用します。必要なコマンドはすべて読み取り専用なので、アカウントに変更は加えられません。

Audit my Apple Search Ads account and tell me what needs my attention. This is
read-only — don't change anything.

Judge campaigns on cohort net ROAS over the last 30 days against a 3:1
benchmark, since Adapty attributes real subscription revenue back to the
campaign that drove it. Cover campaigns, keywords, the search terms I'm
matching on, and what my active automations do.

Serving status and the reasons a campaign isn't serving come back on the
metrics rows, not from campaigns list.

Then report back in plain language:
- what's blocked and how to unblock it
- net ROAS per campaign against the benchmark
- the top 3 places I'm wasting money
- the top 3 growth opportunities
- the changes you'd make, each as the exact command with its current and new
  value, for me to approve one at a time

I'm not an Apple Ads expert. Assume I'm smart but busy.

最初のキャンペーンを開始する

Apple Ads アカウントが空の状態のときに使用します。オペレータースキルはデフォルトで一時停止状態のキャンペーンを作成するため、このプロンプトはプランを確認するまでその状態を維持します。

I want to launch Apple Search Ads for my app from scratch. I'm not an Apple
Ads expert — guide me and build it for me. Create everything paused.

Interview me first, briefly: what my app does and who it's for, which
countries to start in, my monthly test budget, and my target cost per
subscriber. If I don't know that last one, work it back from my price and
expected trial conversion.

Then propose a starter structure as a table before you create anything: a
brand campaign, a generic campaign, a competitor campaign if I name
competitors, and a small discovery campaign to mine search terms. For each
one give me a one-line reason it exists, its share of the budget, its ad
groups, a starter keyword list with match types and bids, and the negative
keywords to share across all of them.

Build it once I approve, then show me what was created.

Finish with a launch checklist: what I still have to fix in the Apple Search
Ads console before anything can serve, such as a payment method or a pending
tax verification; how to switch the campaigns on when I'm ready; and one
automation rule worth adding after a week of data. Then tell me to come back
in 7 days for a performance review.

AI Agentとの違い

Adapty Ads Managerには、ダッシュボード上に組み込みのAI Agentもあります。この2つは異なるニーズに対応しています：

	AI Agent	Apple Ads plugin
動作場所	Adapty ダッシュボード	ターミナル（AIコーディングツール内）
できること	分析と推奨	分析、推奨、そしてコマンドの実行
セットアップ	不要	Adapty CLI とプラグイン

アカウントで何が起きているかを確認したい場合はAI Agentを使用してください。変更も実際に実行したい場合はプラグインを使用してください。

次のステップ

• CLIからAds Managerを管理する — AIツールを使わず、手動で同じ操作を行う方法。
• Ads Managerコマンド — すべてのコマンドと引数、フラグ、使用可能な値の一覧。