---
title: "SplitMetrics Acquire"
description: "サブスクリプションの A/B テストと最適化のために SplitMetrics と Adapty を使用する。"
---

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

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

## SplitMetrics Acquire 連携のセットアップ方法 \{#how-to-set-up-splitmetrics-acquire-integration\}

SplitMetrics Acquire を連携するには、[Integrations > SplitMetrics Acquire](https://app.adapty.io/integrations/splitmetrics) に移動して認証情報を設定してください。

  <img src="/assets/shared/img/8255349-CleanShot_2023-08-14_at_17.39.422x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

  <img src="/assets/shared/img/4d0b2b6-Adapty.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

  <img src="/assets/shared/img/4f8d0b8-AdaptyGuide.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

  <img src="/assets/shared/img/61578ee-CleanShot_2022-04-20_at_17.55.03.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

## イベントとタグ \{#events-and-tags\}

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

  <img src="/assets/shared/img/1b0c777-CleanShot_2023-08-11_at_14.56.362x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

## SDK の設定 \{#sdk-configuration\}

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

:::warning
[Apple Search Ads](apple-search-ads) を Adapty で設定し、[認証情報をアップロード](https://app.adapty.io/settings/apple-search-ads)していることを確認してください。これらがない場合、SplitMetrics Acquire は機能しません。
:::

## トラブルシューティング \{#troubleshooting\}

正しく設定しているにもかかわらず SplitMetrics Acquire との連携が機能しない場合:

- [App Settings -> Apple Search Ads タブ](https://app.adapty.io/settings/apple-search-ads) で **Receive Apple Search Ads attribution in Adapty** トグルが有効になっていること、Adapty で [Apple Search Ads](apple-search-ads) が設定されていること、および[認証情報がアップロード](https://app.adapty.io/settings/apple-search-ads)されていることを確認してください。これらがない場合、SplitMetrics は機能しません。
- プロファイルにオーガニックではない ASA アトリビューションが設定されていることを確認してください。詳細なオーガニックでない ASA アトリビューションを持つプロファイルのみ、イベントが Adapty に配信されます。

## SplitMetrics Acquire のイベント構造 \{#splitmetrics-acquire-event-structure\}

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

```json
{
  "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 | 利用可能なすべての[イベント詳細](webhook-event-types-and-fields#for-most-event-types)を含む JSON 文字列。             |
| `event_id`          | String | 一意のイベント ID（UUID）。                                                                                        |