Airbridge

Airbridge は、複数のデバイス、プラットフォーム、チャネルから収集したデータを統合することで、ウェブサイトやモバイルアプリの統合マーケティングパフォーマンス分析を提供します。Airbridge の Identity Resolution Engine を使用することで、ウェブとアプリのインタラクションから得られた分散した顧客 ID データを統一されたユーザーベースの ID に統合し、より正確なアトリビューションを実現できます。

Adapty は、ストアからのサブスクリプションイベントを一元管理できる充実したデータセットを提供します。Adapty を使えば、サブスクライバーの行動を簡単に把握し、何を好むかを理解した上で、ターゲットを絞った効果的なコミュニケーションが行えます。

Adapty と Airbridge の連携は、主に2つの方法で機能します。

1. Airbridgeからのアトリビューションデータの受信 Airbridgeインテグレーションを設定すると、AdaptyはAirbridgeからアトリビューションデータを受信し始めます。このデータはユーザーページで簡単に確認できます。
2. Airbridgeへのサブスクリプションイベントの送信 Adaptyは、インテグレーションで設定されたすべてのサブスクリプションイベントをAirbridgeに送信できます。これにより、Airbridgeダッシュボード内でこれらのイベントを追跡できるようになります。このインテグレーションは、広告キャンペーンの効果を評価するのに役立ちます。

連携の設定

AdaptyをAirbridgeに接続する

Airbridgeを連携するには、Integrations > Airbridge に移動し、トグルをオンにして各フィールドを入力します。

まず、AirbridgeとAdaptyプロファイル間の接続を構築するための認証情報を設定します。AirbridgeのアプリネームとAirbridge APIトークンが必要です。

どちらもAirbridgeダッシュボードの Third-party Integrations > Adapty セクションで確認できます。

Adapty APIトークンフィールドはAdaptyバックエンドで事前に生成されています。Adapty APIトークンの値をコピーし、AirbridgeダッシュボードのAdapty Authorization Tokenフィールドに貼り付けてください。

イベントとタグの設定

認証情報の下には、AdaptyからAirbridgeに送信できる3グループのイベントがあります。

必要なものをオンにするだけです。

アプリをAirbridgeに接続する

連携のために、以下の例のように airbridge_device_id をプロファイルビルダーに渡し、setIntegrationIdentifier を呼び出してください。

do {
    try await Adapty.setIntegrationIdentifier(
        key: "airbridge_device_id", 
        value: AirBridge.deviceUUID()
    )
} catch {
    // handle the error
}

Airbridge.getDeviceInfo().getUUID(object: AirbridgeCallback.SimpleCallback<String>() {
    override fun onSuccess(result: String) {
        Adapty.setIntegrationIdentifier("airbridge_device_id", result) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
    override fun onFailure(throwable: Throwable) {
    }
})

final deviceUUID = await Airbridge.state.deviceUUID;

try {
    await Adapty().setIntegrationIdentifier(
        key: "airbridge_device_id", 
        value: deviceUUID,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

try {
  const deviceId = await Airbridge.state.deviceUUID();

  await adapty.setIntegrationIdentifier("airbridge_device_id", deviceId);
} catch (error) {
  // handle `AdaptyError`
}

airbridgeDeviceIdの詳細については、Airbridgeのドキュメントをご覧ください。

サブスクリプションイベント後、AdaptyがAirbridgeのアトリビューションデータを受信するまで最大24時間かかる場合があります。受信後はダッシュボードに即座に表示されます。

イベント構造

Adaptyは、Airbridge Integration page の Events names セクションで設定された内容に従い、選択したイベントをAirbridgeに送信します。各イベントの構造は以下の通りです。

{
  "user": {
    "externalUserID": "user_12345",
    "externalUserEmail": "user@example.com",
    "attributes": {
      "is_premium": true
    }
  },
  "device": {
    "deviceUUID": "550e8400-e29b-41d4-a716-446655440000",
    "deviceModel": "iPhone 14 Pro",
    "osName": "iOS",
    "osVersion": "17.0.1",
    "locale": "en-US",
    "timezone": "America/New_York",
    "ifa": "00000000-0000-0000-0000-000000000000",
    "ifv": "00000000-0000-0000-0000-000000000000"
  },
  "app": {
    "packageName": "com.example.app",
    "version": "1.2.3"
  },
  "eventUUID": "d4f6f1f4-96fb-4a31-bafd-599fef77be90",
  "eventTimestamp": 1709294400000,
  "eventData": {
    "goal": {
      "category": "airbridge.subscribe",
      "customAttributes": {
        "isTrialConverted": true
      },
      "semanticAttributes": {
        "transactionID": "GPA.3383-4699-1373-07113",
        "totalValue": 9.99,
        "currency": "USD",
        "period": "P1M",
        "isRenewal": true,
        "renewalCount": 2,
        "products": [
          {
            "productID": "yearly.premium.6999",
            "name": "yearly.premium.6999",
            "position": 1
          }
        ]
      }
    }
  }
}

各パラメータの説明：

トラブルシューティング

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

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