Airbridge

Airbridge propose une analyse intégrée des performances marketing pour les sites web et les applications mobiles, en consolidant les données collectées depuis plusieurs appareils, plateformes et canaux. Grâce au moteur de résolution d’identité d’Airbridge, vous pouvez regrouper les données d’identité client dispersées issues des interactions web et app en une identité unifiée basée sur les personnes, ce qui permet une attribution plus précise.

Adapty vous fournit un ensemble complet de données pour suivre les événements d’abonnement des stores en un seul endroit. Avec Adapty, vous pouvez facilement observer le comportement de vos abonnés, comprendre leurs préférences et utiliser ces informations pour communiquer avec eux de manière ciblée et efficace.

L’intégration entre Adapty et Airbridge fonctionne de deux façons principales.

1. Réception des données d’attribution depuis Airbridge Une fois l’intégration Airbridge configurée, Adapty commencera à recevoir des données d’attribution depuis Airbridge. Vous pouvez consulter ces données directement sur la page de l’utilisateur.
2. Envoi des événements d’abonnement à Airbridge Adapty peut envoyer à Airbridge tous les événements d’abonnement configurés dans votre intégration. Vous pourrez ainsi suivre ces événements depuis le tableau de bord Airbridge. Cette intégration est particulièrement utile pour évaluer l’efficacité de vos campagnes publicitaires.

Configurer l’intégration

Connecter Adapty à Airbridge

Pour intégrer Airbridge, rendez-vous dans Integrations > Airbridge, activez le bouton et remplissez les champs.

Commencez par renseigner vos identifiants pour établir la connexion entre vos profils Airbridge et Adapty. Le nom de l’application Airbridge et le token API Airbridge sont obligatoires.

Vous les trouverez tous les deux dans votre tableau de bord Airbridge, dans la section Third-party Integrations > Adapty.

Le champ Adapty API token est pré-généré par le backend Adapty. Vous devrez copier la valeur de l’Adapty API token et la coller dans le tableau de bord Airbridge, dans le champ Adapty Authorization Token.

Configurer les événements et les tags

Sous les identifiants, trois groupes d’événements peuvent être envoyés à Airbridge depuis Adapty.

Activez simplement ceux dont vous avez besoin.

Connectez votre application à Airbridge

Pour l’intégration, vous devez passer airbridge_device_id au profile builder et appeler setIntegrationIdentifier comme illustré dans l’exemple ci-dessous :

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

Pour en savoir plus sur airbridgeDeviceId, consultez la documentation Airbridge.

Il peut falloir jusqu’à 24 heures à Adapty pour recevoir les données d’attribution Airbridge après un événement d’abonnement. Adapty les affichera immédiatement sur le tableau de bord.

Structure d’un événement

Adapty envoie les événements sélectionnés à Airbridge, tels que configurés dans la section Events names de la page d’intégration Airbridge. Chaque événement est structuré comme suit :

{
  "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:

Dépannage

access_level_updated apparaît comme échoué dans le Flux d’événements

access_level_updated est un événement réservé aux webhooks. Adapty ne l’envoie jamais à cette intégration. Mais Adapty enregistre un résultat pour chaque intégration activée, et un événement non pris en charge est affiché comme un échec.