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

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

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

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

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

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

イベントとタグ

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

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

SDK の設定

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

トラブルシューティング

正しく設定しているにもかかわらず 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_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）。