rocket_launch ASAPilot
始める

用語

Ad Services API

Apple Search Ads 専用の Apple ファーストパーティ帰属 API。どのアプリインストールが ASA キャンペーンから来たかを確認し、ユーザー識別子なしでキャンペーン、広告グループ、キーワード ID を返す。

別名：AdServices フレームワーク, AdAttributionKit（関連）

Ad Services API とは？

Ad Services API（iOS 14.3 で導入、古い iAd フレームワークを置き換え）は Apple Search Ads インストール専用の Apple ファーストパーティ帰属 API。

ユーザーが ASA 広告をタップしてからアプリをインストールすると、広告サーフェスと App Store の両方 が Apple によって運営されているため、Apple はそのリンクを決定論的に認識する。Ad Services API により、アプリは IDFA やユーザーレベルの識別子を公開せずにこの帰属データをリクエストできる。

仕組み

  1. ユーザーが ASA 広告タップ経由でアプリをインストール。
  2. アプリが最初のセッション内で AdServices.attributionToken() を呼び出す。
  3. アプリがトークンを Apple の帰属エンドポイントに POST：POST https://api-adservices.apple.com/api/v1/
  4. Apple が帰属詳細付きの JSON ペイロードを返す： 
    {
  "attribution": true,
  "campaignId": 12345678,
  "adGroupId": 87654321,
  "keywordId": 11223344,
  "creativeSetId": null,
  "orgId": 99887766,
  "countryOrRegion": "US",
  "clickDate": "2026-05-20T14:23:11Z",
  "conversionDate": "2026-05-20T14:24:42Z",
  "iad-purchase-date": "2026-05-20T14:24:42Z"
}
  5. バックエンドがこれをユーザーレベルデータと結合して帰属収益、LTV などを計算。

"attribution": false の場合、インストールは ASA からのものではない — オーガニック、別の有料 チャネル、またはあなたのキャンペーンのいずれにもマッチしなかった検索クエリの可能性。

レスポンスが教えてくれること

フィールド意味
campaignIdASA キャンペーン ID — キャンペーンリストに結合
adGroupIdASA 広告グループ ID — 広告グループリストに結合
keywordIdタップをトリガーしたキーワード（Search Match の場合は null）
creativeSetIdクリエイティブ変種（CPPs がクリエイティブセットを置き換えて以来ほとんど使用されない）
orgIdあなたの Apple Search Ads org ID
countryOrRegionインストールが発生したストアフロント
clickDateタップが発生した時刻
conversionDateインストールが発生した時刻

SKAdNetwork との比較

側面Ad Services APISKAdNetwork
スコープASA のみすべての広告ネットワーク
レイテンシ数分数時間から数日（SKAN 4.0 の 3 つのポストバックウィンドウ）
粒度キャンペーン + 広告グループ + キーワードキャンペーンレベル + コンバージョン値
決定論性決定論的集計、プライバシー保護
ユーザー識別子なしなし（意図的に）
クラウド匿名性ティアなしあり（低ボリュームデータを抑制）
最適な用途ASA 専用最適化MMP 経由のクロスネットワーク帰属

ASAPilot の Ad Services API 使用方法

ASAPilot は Apple Search Ads API 経由でキャンペーンパフォーマンスデータ（キャンペーンと支出データ） を読み込み、これを Ad Services API ソースのバックエンド帰属データ と結合。

アプリで Ad Services API 統合をセットアップ（一度きりのバックエンド作業）。ASAPilot は次に 帰属イベントを ASA 支出と結合して、MMP なしでキャンペーン / 広告グループ / キーワードごとの CPI、CPA、ROAS を計算。

一般的な実装上の落とし穴

  • トークンは最初のセッションで取得する必要がある。トークンリクエストの前にアプリがクラッシュ またはユーザーがアンインストールすると、その帰属を失う。
  • トークンの有効期間は短い。トークンはすぐに期限切れになる；速やかに Apple のエンドポイントと 交換。
  • iOS 14.3 以前のフォールバック。古い iOS をサポートする場合、レガシー iAd フレームワークが Ad Services と並行して必要。ほとんどのアプリは 2026 までに iOS <15 を放棄。
  • attribution: false は常に「オーガニック」ではない。一部の非 ASA インストールは Today Tab インプレッション、検索推奨、またはトークンが生成されなかった古いクリエイティブから来る。

関連用語