--- title: "Asapty" description: "AdaptyのサブスクリプションエコシステムにおけるAsaptyとその役割を詳しく説明します。" --- [Asapty](https://asapty.com/) インテグレーションを使用すると、Search Ads キャンペーンを最適化できます。AdaptyはサブスクリプションイベントをAsaptyに送信するため、Apple Search Adsアトリビューションに基づいたカスタムダッシュボードをAsapty上で構築できます。 このインテグレーションはAdaptyにアトリビューションデータを追加しません。[ASA](apple-search-ads) から直接必要なデータをすべて取得しているためです。 ## インテグレーションの設定 \{#set-up-integration\} ### AdaptyとAsaptyを接続する \{#connect-adapty-to-asapty\} Asaptyを連携するには、Adapty ダッシュボードの [Integrations > Asapty](https://app.adapty.io/integrations/asapty) に移動し、Asapty IDのフィールドに値を入力してください。 Asapty IDは、Asaptyアカウントの Settings > General セクションで確認できます。 ### イベントとタグを設定する \{#configure-events-and-tags\} 認証情報の下には、AdaptyからAsaptyに送信できるイベントが3つのグループに分かれています。必要なものをオンにするだけです。Adaptyが提供するイベントの全リストは[こちら](events)で確認できます。 Asaptyが提供するデフォルトのイベント名を使用することを推奨しますが、必要に応じてイベント名を変更することもできます。 ### アプリをAsaptyに接続する \{#connect-your-app-to-asapty\} 上記の手順を完了すると、Adaptyは自動的にAsaptyからアトリビューションデータを受信します。アプリのコードでアトリビューションデータを明示的にリクエストする必要はありません。アトリビューションデータの精度を高めるために、各イベントのデータに `customerUserId` を含めるようAsaptyを設定してください。 ## Asaptyイベントの構造 \{#asapty-event-structure\} 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 | ストアユーザーの国コード。 | ## トラブルシューティング \{#troubleshooting\} - AdaptyでApple Search Adsを設定し、[認証情報をアップロード](https://app.adapty.io/settings/apple-search-ads)していることを確認してください。設定がないとAsaptyは機能しません。 - 詳細な非オーガニックASAアトリビューションを持つプロファイルのみが、Asaptyにイベントを送信します。アトリビューションが不十分な場合は、"The user profile is missing the required integration data." と表示されます。 - インテグレーションの設定前に作成されたプロファイルは、Asaptyにイベントを送信できません。 - 正しく設定しているにもかかわらずAdaptyとのインテグレーションが機能しない場合は、[**App Settings** -> **Apple Search Ads** タブ](https://app.adapty.io/settings/apple-search-ads)で **Receive Apple Search Ads attribution in Adapty** トグルが有効になっているか確認してください。