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

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

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

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をAdaptyで設定し、認証情報をアップロードしていることを確認してください。これらがなければ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トグルが有効になっているか確認してください。

access_level_updated がイベントフィードで失敗と表示される

access_level_updated は webhook 専用イベントです。Adapty はこのインテグレーションにこのイベントを送信しません。ただし、Adapty は有効なすべてのインテグレーションに対して結果を記録するため、サポートされていないイベントは失敗として表示されます。