Asapty インテグレーションを使用すると、Search Ads キャンペーンを最適化できます。AdaptyはサブスクリプションイベントをAsaptyに送信するため、Apple Search Adsアトリビューションに基づいたカスタムダッシュボードをAsapty上で構築できます。

このインテグレーションはAdaptyにアトリビューションデータを追加しません。ASA から直接必要なデータをすべて取得しているためです。

インテグレーションの設定

AdaptyとAsaptyを接続する

Asaptyを連携するには、Adapty ダッシュボードの Integrations > Asapty に移動し、Asapty IDのフィールドに値を入力してください。

Asapty IDは、Asaptyアカウントの Settings > General セクションで確認できます。

イベントとタグを設定する

認証情報の下には、AdaptyからAsaptyに送信できるイベントが3つのグループに分かれています。必要なものをオンにするだけです。Adaptyが提供するイベントの全リストはこちらで確認できます。

Asaptyが提供するデフォルトのイベント名を使用することを推奨しますが、必要に応じてイベント名を変更することもできます。

アプリをAsaptyに接続する

上記の手順を完了すると、Adaptyは自動的にAsaptyからアトリビューションデータを受信します。アプリのコードでアトリビューションデータを明示的にリクエストする必要はありません。アトリビューションデータの精度を高めるために、各イベントのデータに customerUserId を含めるようAsaptyを設定してください。

Asaptyイベントの構造

AdaptyはGETリクエストのクエリパラメーターを使用してAsaptyにイベントを送信します。各イベントのURLは次のような形式になります。

https://asapty.com/_api/mmpEvents/?source=adapty&asaptyid=a1b2c3d4&keywordid=12345&adgroupid=67890&campaignid=11223&conversiondate=1709294400000&event_name=subscription_renewed&install_time=1709100000&app_name=MyApp&json=%7B%22af_revenue%22%3A%229.99%22%2C%22af_currency%22%3A%22USD%22...%7D

クエリパラメーター：

パラメーター	型	説明
source	String	常に “adapty”。
asaptyid	String	認証情報のAsapty ID。
keywordid	String	Apple Search AdsのキーワードID（利用可能な場合）。
adgroupid	String	Apple Search AdsのADグループID（利用可能な場合）。
campaignid	String	Apple Search AdsのキャンペーンID（利用可能な場合）。
conversiondate	Long	イベントのタイムスタンプ（ミリ秒単位）。
event_name	String	イベント名（Adaptyイベントからマッピングされたもの）。
install_time	Long	インストールのタイムスタンプ（秒単位）。
app_name	String	Adaptyのアプリタイトル（利用可能な場合）。
json	String	イベントの詳細を含むURLエンコードされたJSON文字列（下記参照）。

json パラメーターは、以下のフィールドを含むURLエンコードされたJSON文字列です：

パラメーター	型	説明
af_revenue	String	収益金額（文字列形式）。
af_currency	String	通貨コード（例：“USD”）。
transaction_id	String	ストアのトランザクションID。
original_transaction_id	String	ストアの元のトランザクションID。
purchase_date	Long	購入タイムスタンプ（ミリ秒単位）。
original_purchase_date	Long	元の購入タイムスタンプ（ミリ秒単位）。
environment	String	Production または Sandbox。
vendor_product_id	String	ストアのプロダクトID。
profile_country	String	ユーザーのIPに基づく国コード。
store_country	String	ストアユーザーの国コード。

トラブルシューティング

• AdaptyでApple Search Adsを設定し、認証情報をアップロードしていることを確認してください。設定がないとAsaptyは機能しません。
• 詳細な非オーガニックASAアトリビューションを持つプロファイルのみが、Asaptyにイベントを送信します。アトリビューションが不十分な場合は、“The user profile is missing the required integration data.” と表示されます。
• インテグレーションの設定前に作成されたプロファイルは、Asaptyにイベントを送信できません。
• 正しく設定しているにもかかわらずAdaptyとのインテグレーションが機能しない場合は、App Settings -> Apple Search Ads タブで Receive Apple Search Ads attribution in Adapty トグルが有効になっているか確認してください。