Airbridge

Airbridge ofrece un análisis integrado del rendimiento de marketing para sitios web y aplicaciones móviles, consolidando datos recopilados de múltiples dispositivos, plataformas y canales. Con el motor de resolución de identidad de Airbridge, puedes combinar datos de identidad dispersos de clientes procedentes de interacciones web y de la app en una identidad unificada basada en personas, lo que se traduce en una atribución más precisa.

Adapty proporciona un conjunto completo de datos que te permite rastrear eventos de suscripción desde los stores en un solo lugar. Con Adapty, puedes ver fácilmente cómo se comportan tus suscriptores, descubrir qué les gusta y usar esa información para comunicarte con ellos de forma dirigida y efectiva.

La integración entre Adapty y Airbridge funciona de dos maneras principales.

1. Recibir datos de atribución desde Airbridge
   Una vez configurada la integración con Airbridge, Adapty comenzará a recibir datos de atribución de Airbridge. Puedes acceder y consultar estos datos fácilmente en la página del usuario.
2. Enviar eventos de suscripción a Airbridge
   Adapty puede enviar todos los eventos de suscripción configurados en tu integración a Airbridge. Como resultado, podrás rastrear estos eventos dentro del dashboard de Airbridge. Esta integración es útil para evaluar la efectividad de tus campañas publicitarias.

Configurar la integración

Conectar Adapty con Airbridge

Para integrar Airbridge, ve a Integrations > Airbridge, activa el interruptor y rellena los campos.

Primero, introduce las credenciales para establecer la conexión entre tus perfiles de Airbridge y Adapty. Se requieren el nombre de la app de Airbridge y el token de API de Airbridge.

Ambos se encuentran en tu dashboard de Airbridge, en la sección Third-party Integrations > Adapty.

El campo del token de API de Adapty se genera previamente en el backend de Adapty. Debes copiar el valor del token de API de Adapty y pegarlo en el dashboard de Airbridge en el campo Adapty Authorization Token.

Configurar eventos y etiquetas

Debajo de las credenciales encontrarás tres grupos de eventos que puedes enviar a Airbridge desde Adapty.

Simplemente activa los que necesites.

Conectar tu app con Airbridge

Para la integración, debes pasar airbridge_device_id al perfil y llamar a setIntegrationIdentifier tal como se muestra en el siguiente ejemplo:

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`
}

Lee más sobre airbridgeDeviceId en la documentación de Airbridge.

Adapty puede tardar hasta 24 horas en recibir los datos de atribución de Airbridge tras un evento de suscripción. Adapty los mostrará en el dashboard de inmediato.

Estructura del evento

Adapty envía los eventos seleccionados a Airbridge según lo configurado en la sección Events names de la página de integración de Airbridge. Cada evento tiene la siguiente estructura:

{
  "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
          }
        ]
      }
    }
  }
}

Donde: