SplitMetrics Acquire

SplitMetrics Acquireとの連携により、Apple Search Adsからのサブスクリプション収益を正確に把握できます。また、ユーザーを数ヶ月にわたって追跡し、広告が長期的にどれだけの収益をもたらしているかを確認できます。

さらに、AdaptyはサブスクリプションイベントをSplitMetrics Acquireに送信するため、Apple Search Adsのアトリビューションに基づいてカスタムダッシュボードや自動化を構築できます。なお、ASAから直接必要な情報をすべて取得しているため、Adaptyへのアトリビューションデータの追加は行いません。

SplitMetrics Acquire 連携のセットアップ方法

SplitMetrics Acquire を連携するには、Integrations > SplitMetrics Acquire に移動して認証情報を設定してください。

8255349-CleanShot_2023-08-14_at_17.39.422x.webp

SplitMetrics Acquire のアカウントを開き、いずれかの MMP ロゴにカーソルを合わせて Settings ボタンをクリックします。ダイアログの項目 5 に表示されている Client ID をコピーし、Adapty の Client ID フィールドに貼り付けてください。

連携を使用するには Apple App ID の設定も必要です。App ID を確認するには、App Store Connect でアプリのページを開き、General セクションの App Information ページに移動して、画面左下の Apple ID を確認してください。

61578ee-CleanShot_2022-04-20_at_17.55.03.webp

イベントとタグ

認証情報の下に、Adapty から SplitMetrics Acquire に送信できる 3 つのイベントグループがあります。必要なものをオンにするだけです。Adapty が提供するイベントの全一覧はこちらをご確認ください。

1b0c777-CleanShot_2023-08-11_at_14.56.362x.webp

Adapty が提供するデフォルトのイベント名を使用することをおすすめします。ただし、必要に応じてイベント名を変更することも可能です。Adapty はサーバー間連携を使用してサブスクリプションイベントを SplitMetrics Acquire に送信するため、SplitMetrics ダッシュボードですべてのサブスクリプションイベントを確認できます。

SDK の設定

SDK 側での設定は不要ですが、精度向上のために customerUserId を Adapty に送信することをおすすめします。

Apple Search Ads を Adapty で設定し、認証情報をアップロードしていることを確認してください。これらがない場合、SplitMetrics Acquire は機能しません。

トラブルシューティング

SplitMetrics Acquire にイベントが届かない

正しく設定しているにもかかわらず、SplitMetrics Acquire との連携が機能しない場合は、次の点を確認してください。

App Settings -> Apple Search Ads タブでReceive Apple Search Ads attribution in Adaptyトグルが有効になっていることを確認し、Adapty で Apple Search Ads を設定して認証情報をアップロードしてください。これらがないと SplitMetric は機能しません。
プロファイルにオーガニック以外の ASA アトリビューションがあることを確認してください。詳細なオーガニック以外の ASA アトリビューションを持つプロファイルのみが、イベントを Asapty に配信します。

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

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

SplitMetrics Acquire のイベント構造

Adapty はクエリパラメーターを使用した GET リクエストで SplitMetrics Acquire にイベントを送信します。各イベントの構造は次のとおりです:

{
  "source": "Apple Search Ads",
  "app_id": "123456789",
  "name": "subscription_renewed",
  "type": "subscription_renewed",
  "revenue": 9.99,
  "currency": "USD",
  "tap_time": "2024-03-01 12:00:00",
  "open_time": "2024-03-01 12:05:00",
  "event_time": "2024-03-02 12:00:00",
  "adaccount_id": "123456",
  "campaign_id": "123456789",
  "adgroup_id": "123456789",
  "keyword_id": "123456789",
  "creative_set_id": "123456789",
  "Ad_id": "123456789",
  "country_or_region": "US",
  "conversion_type": "Download",
  "user_id": "user_12345",
  "att_status": "3",
  "device_type": "iphone",
  "app_version": "1.2.3",
  "sdk_version": "2.10.0",
  "ios_version": "17.2",
  "event_value": "{\"vendor_product_id\":\"yearly.premium.6999\",\"original_transaction_id\":\"GPA.3383...\"}",
  "event_id": "123e4567-e89b-12d3-a456-426614174000"
}

各パラメーターの説明:

パラメータ	型	説明
`source`	String	常に “Apple Search Ads”。
`app_id`	String	Apple App ID。
`name`	String	イベント名（Adapty イベントからマッピング）。
`type`	String	イベントタイプ（`name` と同じ）。
`revenue`	Float	収益額。
`currency`	String	通貨コード。
`tap_time`	String	広告タップの日時。
`open_time`	String	アプリ起動（インストール）の日時。
`event_time`	String	イベントの日時。
`adaccount_id`	String	ASA 組織 ID。
`campaign_id`	String	ASA キャンペーン ID。
`adgroup_id`	String	ASA 広告グループ ID。
`keyword_id`	String	ASA キーワード ID。
`creative_set_id`	String	ASA クリエイティブセット ID。
`Ad_id`	String	ASA 広告 ID。
`country_or_region`	String	ストアの国または地域。
`conversion_type`	String	コンバージョンタイプ（例：「Download」）。
`user_id`	String	カスタマーユーザー ID または Adapty プロファイル ID。
`att_status`	String	トラッキング使用状況ステータス（0〜3）。
`device_type`	String	デバイスタイプ（例：「iphone」、「ipad」）。
`app_version`	String	アプリケーションバージョン。
`sdk_version`	String	Adapty SDK バージョン。
`ios_version`	String	iOS バージョン。
`event_value`	String	利用可能なすべてのイベント詳細を含む JSON 文字列。
`event_id`	String	一意のイベント ID（UUID）。

このページは役に立ちましたか？