rocket_launch ASAPilot
始める

用語

Apple Search Ads API

Apple Search Ads のプログラム的管理用の Apple 公式 REST API — キャンペーン CRUD、レポート、キーワード管理、入札変更。認証に OAuth 2.0 と ES256 JWT を使用。

別名：ASA API, Apple Search Ads Campaign Management API

Apple Search Ads API とは？

Apple Search Ads API は Apple Search Ads のプログラム的管理用の Apple 公式 REST API。すべての 合法的な第三者 ASA ツール — ASAPilot を含む — が使用する統合サーフェス。

機能：

  • キャンペーン管理 — 作成、更新、一時停止、アーカイブ
  • 広告グループ管理 — キーワード、広告、入札、オーディエンス絞り込み
  • キーワード操作 — 追加、マッチタイプの編集、入札の設定、negatives の追加
  • レポート — キーワード/広告グループ/キャンペーンごとの支出、タップ、インストール、コンバージョン率
  • 検索用語レポート — タップをトリガーした実際のユーザークエリを見る
  • Custom Product Page の割り当て — 広告グループに CPP を割り当て

認証の仕組み

Apple Search Ads API は OAuth 2.0 と ES256 JWT を使用：

  1. Apple Search Ads アカウント設定で EC（楕円曲線）秘密鍵を生成。
  2. 秘密鍵を安全に保管（これがあなたのシークレット）。
  3. API コールを行うには、秘密鍵で署名された JWT を構築。JWT にはクライアント ID、チーム ID、 キー ID、短い有効期限（通常 5-20 分）が含まれる。
  4. JWT を Apple OAuth エンドポイントに POST して短期間のアクセストークンと交換。
  5. 後続の API コールの Authorization: Bearer <token> ヘッダーでアクセストークンを使用。

このフローは単純な API キーよりも意図的に重い。ASAPilot や他の第三者ツールは JWT 生成を内部で 処理する — セットアップ中にキーを供給するだけ。

レート制限

Apple は厳密なレート制限の数値を公開していない。観測された動作（2026）：

  • ソフトスロットリング が持続 >5 リクエスト/秒
  • バースト許容度 は短いウィンドウで最大 ~20-30 リクエスト/秒
  • レポートエンドポイント はミューテーションエンドポイントより寛容

制限に達した場合、Apple は 429 Too Many Requests と Retry-After ヒントを返す。本番統合は指数 バックオフを実装すべき。

第三者ツールが API を使用する理由

Apple Search Ads ダッシュボードは単一アカウント、低頻度タスクには適切。API は以下の場合に不可欠 になる：

  • 一度に 5+ アカウントを管理（手動ログインは運用上実行不可能）
  • 自動化の実行（日次サマリー、異常アラート、定期監査）
  • カスタムダッシュボードの構築（収益結合、LTV 分析、コホート分解）
  • 一括操作（1 バッチで 200 個の negative キーワードを追加）

ASAPilot の API 使用方法

ASAPilot はセットアップ中に OAuth 2.0 + ES256 JWT 経由で Apple Search Ads アカウントに接続 （中央値時間 <2 分）。接続後、ASAPilot は：

  • 支出ペーシングと異常検出のため 5-15 分ごとにレポートエンドポイントをポーリング
  • アカウント監査のため キャンペーン / 広告グループ / キーワード状態を読む
  • デフォルトではアカウントに書き込まない — 読み取り専用がデフォルトモード；書き込みは推奨ごとに 明示的な人間の承認が必要

完全なセットアップフローについては docs/connect-apple-search-ads を参照。

関連用語