---
title: "AIコーディングツールでApple Adsを管理する"
description: "ads-managerスキルをインストールして、Claude Code、Copilot CLI、Codex、またはGemini CLIがAdapty CLIを通じてApple Adsキャンペーンを実行できるようにします。"
---

`ads-manager` スキルを使うと、AIコーディングツールが[Adapty CLI](developer-cli-ads-manager)を通じてApple Adsアカウントを操作できるようになります。平易な言葉で質問するだけで、どのコマンドで答えが得られるかを判断し、まずアカウントを読み取り、Appleに届く前に書き込み操作を提案します。

スキルとは、AIツールが必要に応じて読み込む一連の指示のことです。このスキルには、間違えやすいAds Managerの操作に関する情報が含まれています。各フラグが受け付ける識別子の種類、各リストで使えるフィルター、バッチに含められるキーワードの上限数、そして費用が発生する呼び出しなどです。

## 何を処理するか \{#what-it-handles\}

- **読み取りパフォーマンス**: 質問に答える最適な1回の呼び出しを選択し、結果をページングしません。上位N件の質問は順序付きの1回の呼び出しで対応でき、エンティティの件数を数えるだけならメトリクスの呼び出しは不要だということを理解しています。
- **構造の変更**: キャンペーン、広告グループ、広告、キーワードを正しい順序で作成・更新し、子エンティティを書き込む前に親エンティティを読み取ります。
- **キーワード作業**: キーワードの追加や入札額の変更をバッチ処理で行い、検索ワードをキーワードおよび除外キーワードとして登録します。
- **自動化**: ルールベースの自動化を設定し、実際の入札に適用する前にドライランで検証します。
- **競合調査**: 競合アプリが入札しているキーワードを取得します。

## 実行しないこと \{#what-it-will-not-do\}

このスキルはすべての書き込みを不可逆なものとして扱います。実際そうだからです — CLI には削除機能がなく、変更は数秒以内に Apple に反映されます。

- 書き込みの前に必ず読み取りを行い、ID や予算を推測することはありません。
- お金が発生するコマンドの前には必ず確認を求め、あなた自身がコマンドを実行する際は CLI 本来の確認プロンプトもそのまま残します。
- 連続した書き込みにはそれぞれべき等キーを付与するため、結果が不明な状態で再実行しても2つ目のキャンペーンが作成されません。
- 小さなバッチを優先するため、Apple からの一部拒否が発生しても内容を把握しやすくなります。

:::note
このスキルはコマンドの推奨と準備を行います。指標の読み取りとドライランは無料ですが、ライブ広告アカウントを変更するものを承認する責任はユーザーにあります。
:::

## スキルをインストールする \{#install-the-skill\}

[ads-manager スキル](https://github.com/adaptyteam/adapty-sdk-integration-skill)は、AIコーディングツールに `adapty asa` コマンドを通じて Apple Ads を操作する方法を教えます。コマンドの組み合わせ順序、書き込み前に読むべき内容、そして実際に費用が発生するコマンドを把握しています。

**対応ツール**: Claude Code、GitHub Copilot CLI、OpenAI Codex、Gemini CLI

このスキルは Adapty CLI を動かすので、先に CLI をインストールして認証を済ませてください。詳しくは[クイックスタートガイド](developer-cli-quickstart)を参照してください。`adapty asa` コマンドは **Adapty CLI 0.4.0 以降**に含まれており、古いバージョンにはそもそも存在しません。`adapty asa whoami` で確認できます。このコマンドは Apple Ads アカウントが連携済みかどうか、および会社が有効な Ads Manager サブスクリプションを持っているかも教えてくれます。

企業の Cowork ワークスペースでは、管理者がドメイン許可リストに `adapty.io` と `*.adapty.io` の両方を追加する必要があります。両方を記載してください。ほとんどの許可リスト実装ではワイルドカードはapex ドメインをカバーしないため、スキルが参照するドキュメントはapex ドメインに置かれています。両方が許可されるまで、スキルは Adapty にアクセスできません。

インストールするには、お使いのツールに合った方法を選んでください。全リストは[スキルの README](https://github.com/adaptyteam/adapty-sdk-integration-skill) を参照してください。

**Claude Code**

```bash
claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill
claude plugin install adapty-sdk-integration@adapty
```

このプラグインには SDK インテグレーションスキルも含まれています。両方がまとめてインストールされます。

**GitHub Copilot CLI**

```bash
git clone https://github.com/adaptyteam/adapty-sdk-integration-skill.git
cp -r adapty-sdk-integration-skill/skills/* ~/.copilot/skills/
```

**Gemini CLI**

```bash
gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill
```

**OpenAI Codex またはその他のツール** — [skills CLI](https://skills.sh) を使用してください（この方法でインストールされたスキルは自動更新されません）:

```bash
npx skills add adaptyteam/adapty-sdk-integration-skill --all
```

`--all` は検出されたすべてのエージェントに両方のスキルをインストールします。このスキル単体の場合は `--skill ads-manager` を使用してください。

または、リポジトリをクローンして `skills/` 以下のディレクトリをツールのスキルディレクトリにコピーしてください。このスキルだけが必要な場合は `skills/ads-manager/` のみをコピーしてください。

インストール後、プロジェクトでスキルを実行します:

```bash
/ads-manager
```

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

## AI エージェントとの違い \{#how-it-differs-from-the-ai-agent\}

Adapty Ads Manager には、ダッシュボード上に組み込みの [AI エージェント](ads-manager-ai-agent)も搭載されています。両者は異なるニーズに応えます：

| | AI エージェント | ads-manager スキル |
|---|---|---|
| 動作場所 | Adapty ダッシュボード | ターミナル（AI コーディングツール内） |
| できること | 分析と推奨 | 分析、推奨、およびコマンドの実行 |
| セットアップ | 不要 | Adapty CLI とスキルの設定が必要 |

アカウントの状況を確認したい場合は AI エージェントを使用してください。変更まで実行したい場合はスキルを使用してください。

## 次のステップ \{#whats-next\}

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