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 との連携が機能しない場合:

App Settings -> Apple Search Ads タブで Receive Apple Search Ads attribution in Adapty トグルが有効になっていること、Adapty で Apple Search Ads が設定されていること、および認証情報がアップロードされていることを確認してください。これらがない場合、SplitMetrics は機能しません。
プロファイルにオーガニックではない ASA アトリビューションが設定されていることを確認してください。詳細なオーガニックでない ASA アトリビューションを持つプロファイルのみ、イベントが 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_i��d`	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）。