Airbridge

Airbridge — это платформа для комплексного анализа маркетинговой эффективности сайтов и мобильных приложений, которая консолидирует данные, собранные с нескольких устройств, платформ и каналов. С помощью движка Identity Resolution Engine от Airbridge можно объединять разрозненные данные об идентичности пользователей из веб- и приложений в единый профиль на основе реального человека, что обеспечивает более точную атрибуцию.

Adapty предоставляет полный набор данных, позволяющий отслеживать события подписок из сторов в одном месте. С Adapty вы легко увидите, как ведут себя ваши подписчики, узнаете их предпочтения и сможете использовать эту информацию для точечной и эффективной коммуникации с ними.

Интеграция между Adapty и Airbridge работает двумя основными способами.

1. Получение данных атрибуции из Airbridge После настройки интеграции с Airbridge Adapty начнёт получать данные атрибуции от Airbridge. Вы можете легко просматривать эти данные на странице пользователя.
2. Отправка событий подписки в Airbridge Adapty может отправлять в Airbridge все события подписки, настроенные в вашей интеграции. В результате вы сможете отслеживать эти события в дашборде Airbridge. Эта интеграция полезна для оценки эффективности рекламных кампаний.

Настройка интеграции

Подключение Adapty к Airbridge

Чтобы интегрировать Airbridge, перейдите в Integrations > Airbridge, включите переключатель и заполните поля.

Прежде всего укажите учётные данные для установки соединения между вашими профилями Airbridge и Adapty. Необходимы название приложения в Airbridge (Airbridge app name) и токен API Airbridge (Airbridge API token).

Оба значения можно найти в вашем дашборде Airbridge в разделе Third-party Integrations > Adapty.

Поле Adapty API token уже заполнено — значение генерируется на бэкенде Adapty. Скопируйте его и вставьте в дашборд Airbridge в поле Adapty Authorization Token.

Настройка событий и тегов

Ниже учётных данных расположены три группы событий, которые можно отправлять из Adapty в Airbridge.

Просто включите нужные.

Подключение приложения к 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 в соответствии с настройками в разделе 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 — это событие только для вебхуков. Adapty не отправляет его в эту интеграцию. Однако Adapty фиксирует результат для каждой активной интеграции, и неподдерживаемое событие отображается как ошибка.