Skip to content

Airbridge

Airbridge est une plateforme de mesure mobile unifiée permettant de découvrir les sources de croissance grâce à l’attribution mobile, la mesure incrémentale et la modélisation du marketing mix.

Cette intégration est maintenue par Airbridge.

À propos de l’intégration

L’intégration de Braze et Airbridge vous permet de transmettre toutes les données d’attribution d’installation non organiques d’Airbridge à Braze pour créer des campagnes marketing personnalisées.

Conditions préalables

Intégration

Étape 1 : Mapper l’ID de l’appareil

L’intégration serveur-à-serveur peut être activée en incluant les extraits de code suivants dans vos applications.

Android

Si vous avez une application Android, vous devrez transmettre un ID d’appareil Braze unique à Airbridge.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// MainApplciation.java
@Override
public void onCreate() {
    super.onCreate();
    // Initialize Airbridge SDK
    AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
        // Make Airbridge SDK explicitly start tracking
        .setAutoStartTrackingEnabled(false)
        .build();
    Airbridge.init(this, config);

    // Set device alias into Airbridge SDK
    Airbridge.getCurrentUser().setAlias("braze_device_id", Braze.getInstance(this).getDeviceId());
    // Explicitly start tracking
    Airbridge.startTracking();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// MainApplication.kt
override fun onCreate() {
    super.onCreate()
    // Initialize Airbridge SDK
    val config = AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
        // Make Airbridge SDK explicitly start tracking
        .setAutoStartTrackingEnabled(false)
        .build()
    Airbridge.init(this, config)

    // Set device alias into Airbridge SDK
    Airbridge.getCurrentUser().setAlias("braze_device_id", Braze.getInstance(this).deviceId)
    // Explicitly start tracking
    Airbridge.startTracking()
}

iOS

Si vous avez une application iOS, vous pouvez choisir de collecter l’IDFV en définissant le champ useUUIDAsDeviceId sur false. S’il n’est pas défini, l’attribution iOS ne sera probablement pas mappée avec précision d’Airbridge à Braze. Pour plus d’informations, consultez la section Collecte de l’IDFV.

1
2
3
4
5
6
7
8
9
10
11
// AppDelegate.swift
func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]?
) {
    AirBridge.setAutoStartTrackingEnabled(false)
    AirBridge.getInstance("YOUR_APP_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

    AirBridge.state()?.addUserAlias(withKey:"braze_device_id", value:Appboy.sharedInstance()?.getDeviceId())
    AirBridge.startTracking()
}
1
2
3
4
5
6
7
8
9
10
// AppDelegate.m
-           (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  AirBridge.autoStartTrackingEnabled = NO;
  [AirBridge getInstance:@"YOUR_APP_TOKEN" appName:@"YOUR_APP_NAME" withLaunchOptions:launchOptions];

    [AirBridge.state addUserAliasWithKey:@"braze_device_id" value:Appboy.sharedInstance.getDeviceId];
    [AirBridge startTracking];
}

React Native

1
2
3
4
Braze.getInstallTrackingId(function (error, brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
    Airbirdge.state.startTracking()
})

Cordova

1
2
3
4
AppboyPlugin.getDeviceId(function (brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
  Airbridge.state.startTracking()
})

Flutter

1
2
3
4
BrazePlugin.getInstallTrackingId().then((brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
  Airbridge.state.startTracking()
})

Unity

1
2
3
string BrazeID = AppboyBinding.GetInstallTrackingId();
AirbridgeUnity.SetDeviceAlias("braze_device_id", BrazeID);
AirbridgeUnity.StartTracking()

Étape 2 : Obtenir la clé d’importation des données de Braze

Dans Braze, accédez à Intégrations partenaires > Partenaires technologiques et sélectionnez Airbridge.

Ici, vous trouverez l’endpoint REST et pourrez générer votre clé d’importation des données Braze. Une fois la clé générée, vous pouvez créer une nouvelle clé ou invalider une clé existante. La clé d’importation des données et l’endpoint REST sont utilisés à l’étape suivante lors de la configuration d’un postback dans le tableau de bord d’Airbridge.

Étape 3 : Configurer Braze dans le tableau de bord d’Airbridge

  1. Dans Airbridge, accédez à Integrations > Third-party Integrations dans la barre latérale gauche et sélectionnez Braze.
  2. Indiquez la clé d’importation des données et l’endpoint REST que vous avez trouvés dans le tableau de bord de Braze.
  3. Sélectionnez le type d’événement (Install Event ou Install & Deeplink Open Event) et enregistrez.

Pour des instructions plus détaillées, consultez Airbridge.

Étape 4 : Confirmer l’intégration

Une fois que Braze a reçu les données d’attribution d’Airbridge, l’indicateur de connexion sur la page des partenaires technologiques d’Airbridge dans Braze passe de « Not Connected » à « Connected » et inclut un horodatage de la dernière requête réussie.

Ce statut ne change que lorsque Braze reçoit des données sur une installation attribuée. Braze ignore les installations organiques (il les exclut du postback d’Airbridge) et ne les comptabilise pas pour déterminer si la connexion est réussie.

Champs de données disponibles

Airbridge peut envoyer quatre types de données d’attribution à Braze, répertoriés dans le tableau ci-dessous. Ces données peuvent être consultées dans le tableau de bord d’Airbridge et sont utilisées pour l’attribution et le filtrage des installations des utilisateurs.

En supposant que vous configurez votre intégration comme suggéré, Braze mappera les données d’installation aux filtres de Segment.

Champ de données Airbridge Filtre de Segment Braze Description
Channel Source d’attribution d’installation Le canal auquel les installations ou les ouvertures de liens profonds sont attribuées
Campaign Campaign d’attribution d’installation La campagne à laquelle les installations ou les ouvertures de liens profonds sont attribuées
Ad Group Groupe d’annonces d’attribution d’installation Le groupe d’annonces auquel les installations ou les ouvertures de liens profonds sont attribuées
Ad Creative Publicité d’attribution d’installation Le contenu publicitaire auquel les installations ou les ouvertures de liens profonds sont attribuées

Votre base d’utilisateurs peut être segmentée par les données d’attribution dans le tableau de bord de Braze en utilisant les filtres d’attribution d’installation.

Données d’attribution Meta Business

Les données d’attribution pour les campagnes Meta Business ne sont pas disponibles via nos partenaires. Cette source média ne permet pas à ses partenaires de partager les données d’attribution avec des tiers et, par conséquent, nos partenaires ne peuvent pas envoyer ces données à Braze.

URL de suivi des clics Airbridge dans Braze (facultatif)

L’utilisation de liens de suivi des clics dans vos campagnes Braze montre quelles campagnes favorisent les installations d’applications et le réengagement. Utilisez les résultats pour mesurer les performances marketing et décider où investir les ressources pour un meilleur ROI.

Pour commencer avec les liens de suivi des clics Airbridge, consultez Airbridge. Une fois la configuration terminée, vous pouvez directement insérer les liens de suivi des clics Airbridge dans vos campagnes Braze. Airbridge utilisera ensuite ses méthodologies d’attribution probabiliste pour attribuer l’utilisateur qui a cliqué sur le lien. Nous recommandons d’ajouter un identifiant d’appareil à vos liens de suivi Airbridge pour améliorer la précision des attributions de vos campagnes Braze. Cela attribuera de manière déterministe l’utilisateur qui a cliqué sur le lien.

Pour Android, Braze permet aux clients de s’abonner à la collecte d’identifiants publicitaires Google (GAID). Le GAID est également collecté nativement via l’intégration du SDK Airbridge. Vous pouvez inclure le GAID dans vos liens de suivi des clics Airbridge en utilisant la logique Liquid suivante :

1
2
3
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

Pour iOS, Braze et Airbridge collectent automatiquement l’IDFV nativement via nos intégrations SDK. Cela peut être utilisé comme identifiant de l’appareil. Vous pouvez inclure l’IDFV dans vos liens de suivi des clics Airbridge en utilisant la logique Liquid suivante :

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}
New Stuff!