Adapty は Apple Ads からアトリビューションデータを取得し、キャンペーンおよびキーワードのセグメンテーションで指標を分析するのに役立ちます。Adapty は SDK と AdServices Framework を通じて、Apple Ads のアトリビューションデータを自動的に収集します。

Apple Ads インテグレーションを設定すると、Adapty は Apple Ads からアトリビューションデータの受信を開始します。このデータはプロファイルページで簡単に確認できます。

連携の設定

AdServicesフレームワークをAdaptyに接続する

AdServicesを使ったApple Adsは、Adapty ダッシュボードでの設定が必要です。また、アプリ側での有効化も必要です。AdServicesフレームワークを使ってAdapty経由でApple Adsを設定するには、以下の手順に従ってください。

ステップ1：公開鍵を取得する

Adapty ダッシュボードでSettings -> Apple Adsに移動します。 あらかじめ生成された公開鍵（Adaptyがキーペアを提供します）を見つけてコピーします。

ステップ 2: Apple Ads でユーザー管理を設定する

Apple Ads アカウントで Settings > User Management ページに移動します。Adapty がアトリビューションデータを取得するには、別の Apple ID アカウントを招待し、API Account Manager のアクセス権を付与する必要があります。既存のアカウントを使用することも、この目的専用に新しいアカウントを作成することもできます。重要なのは、その Apple ID で Apple Ads にログインできる必要があるという点です。

ステップ 3: API 認証情報を生成する

次に、Apple Ads に新しく追加したアカウントでログインします。Apple Ads の画面で Settings -> API に移動し、先ほどコピーした公開鍵を所定のフィールドに貼り付けて、新しい API 認証情報を生成してください。

ステップ 4: Apple Ads の認証情報を Adapty に設定する

Apple Ads の設定画面から Client ID、Team ID、Key ID の各フィールドをコピーし、Adapty ダッシュボードの対応するフィールドに貼り付けます。

アプリを AdServices ネットワークに接続する

AdServices フレームワークの設定が完了すると、Adapty は Apple Search Ad のアトリビューションデータの収集を自動的に開始します。SDK コードを追加する必要はありません。

iOS アプリケーションでは、このアトリビューションデータは常に他のソースからのデータより優先されます。この動作が不要な場合は、以下の手順で ASA アトリビューションを無効化してください。

インテグレーションを無効にする

Apple Search Ads のアトリビューションをオフにするには、App Settings -> Apple Search Ads タブを開き、Receive Apple Search Ads attribution スイッチをオフにしてください。

独自のキーをアップロードする

ASA アトリビューションに他のサービスや独自ソリューションを使用している場合は、独自の公開鍵・秘密鍵ペアを使用できます。

ステップ 1

ターミナルで秘密鍵を生成する

openssl ecparam -genkey -name prime256v1 -noout -out private-key.pem

Adapty の Settings -> Apple Ads でアップロードする（Upload private key ボタン）

ステップ 2

ターミナルで公開鍵を生成する

openssl ec -in private-key.pem -pubout -out public-key.pem

この公開鍵は、API Account Manager ロールを持つアカウントの Apple Ads 設定で使用できます。これにより、生成された Client ID、Team ID、Key ID の値を Adapty や他のサービスで利用できます。