Airbridge

Airbridge 通过整合从多个设备、平台和渠道收集的数据，为网站和移动应用提供一体化的营销效果分析。借助 Airbridge 的身份解析引擎，您可以将来自网页和应用交互的分散客户身份数据整合为统一的基于人员的身份，从而实现更精准的归因。

Adapty 提供了一套完整的数据，让您可以在一个地方跟踪来自各应用商店的订阅事件。通过 Adapty，您可以轻松了解订阅用户的行为，掌握他们的偏好，并利用这些信息以有针对性且高效的方式与他们进行沟通。

Adapty 与 Airbridge 的集成通过两种主要方式运作。

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 的事件。

只需开启您需要的事件即可。

将您的应用连接到 Airbridge

进行集成时，您需要将 airbridge_device_id 传递给 profile builder，并按照以下示例调用 setIntegrationIdentifier：

import AirBridge

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) {
    }
})

import 'package:airbridge_flutter_sdk/airbridge_flutter_sdk.dart';

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
}

import Airbridge from 'airbridge-react-native-sdk';
import { adapty } from 'react-native-adapty';

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

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

如需进一步了解 airbridgeDeviceId，请参阅 Airbridge 文档。

在订阅事件发生后，Adapty 最多可能需要 24 小时才能收到 Airbridge 归因数据。Adapty 将立即在看板上显示相关数据。

事件结构

Adapty 会根据 Airbridge 集成页面上 Events names 部分的配置，将所选事件发送至 Airbridge。每个事件的结构如下：

{
  "user": {
    "externalUserID": "user_12345",
    "externalUserEmail": "[email protected]",
    "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
          }
        ]
      }
    }
  }
}

其中：