Airbridge

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

Adapty 提供了一套完整的数据集，让您可以在一处追踪来自各应用商店的订阅事件。借助 Adapty，您可以轻松了解订阅者的行为规律，掌握他们的偏好，并据此以精准有效的方式与他们进行沟通。

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

1. 从 Airbridge 接收归因数据 完成 Airbridge 集成设置后，Adapty 将开始从 Airbridge 接收归因数据。你可以在用户页面上轻松查看这些数据。
2. 向 Airbridge 发送订阅事件 Adapty 可以将集成中配置的所有订阅事件发送到 Airbridge，从而让你在 Airbridge 看板中追踪这些事件。此集成有助于评估你的广告活动效果。

设置集成

将 Adapty 连接到 Airbridge

如需集成 Airbridge，请前往 Integrations > Airbridge，将开关从关闭切换至开启，并填写相关字段。

首先，设置凭证以在 Airbridge 与 Adapty 账户之间建立连接。必填项包括 Airbridge app name 和 Airbridge API token。

这两项均可在您的 Airbridge 看板的 Third-party Integrations > Adapty 部分找到。

Adapty API token 字段由 Adapty 后端预先生成。您需要复制 Adapty API token 的值，并将其粘贴到 Airbridge 看板的 Adapty Authorization Token 字段中。

配置事件和标签

在凭据下方，有三组您可以从 Adapty 发送到 Airbridge 的事件。

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

将您的应用连接到 Airbridge

要完成集成，您需要将 airbridge_device_id 传递给 profile builder，并按照以下示例调用 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`
}

在 Airbridge 文档中了解更多关于 airbridgeDeviceId 的信息。

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

事件结构

Adapty 会按照 Airbridge 集成页面 中 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
          }
        ]
      }
    }
  }
}

Where:

故障排查

access_level_updated 在 Event Feed 中显示为失败

access_level_updated 是一个仅限 Webhook 的事件。Adapty 不会将其发送到此集成。但 Adapty 会为每个已启用的集成记录结果，不支持的事件将显示为失败。