AppsFlyer

AppsFlyer est une plateforme d’analyse et d’attribution de marketing mobile qui vous aide à analyser et à optimiser vos applications grâce à l’analyse marketing, l’attribution mobile et la création de liens profonds.

L’intégration de Braze et AppsFlyer vous permet de mieux comprendre comment optimiser et créer des campagnes plus complètes en tirant parti des données d’attribution d’installation mobile d’AppsFlyer.

Vous pouvez également transmettre vos audiences AppsFlyer (cohortes) directement à Braze avec l’intégration AppsFlyer Audiences, ce qui vous permet de créer des campagnes d’engagement client puissantes ciblant les bons utilisateurs au bon moment.

Prérequis

Intégration

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

• android
• ios
• unity

Si vous avez une application Android, vous devez transmettre un identifiant d’appareil Braze unique à AppsFlyer.

Assurez-vous que les lignes de code suivantes sont insérées au bon endroit — après le lancement du SDK Braze et avant le code d’initialisation du SDK AppsFlyer. Consultez le guide d’intégration du SDK Android d’AppsFlyer pour plus d’informations.

1
2
3
4
5
val customData = HashMap<String, Any>()
Braze.getInstance(context).getDeviceIdAsync { deviceId ->
   customData["brazeCustomerId"] = deviceId
   setAdditionalData(customData)
}

Important

Avant février 2023, notre intégration d’attribution AppsFlyer utilisait l’identifiant du fournisseur (IDFV) comme identifiant principal pour faire correspondre les données d’attribution iOS. Il n’est pas nécessaire pour les clients Braze utilisant Objective-C de récupérer le device_id Braze et de l’envoyer à AppsFlyer lors de l’installation, car il n’y a pas d’interruption de service.

Pour ceux qui utilisent le SDK Swift v5.7.0+, si vous souhaitez continuer à utiliser l’IDFV comme identifiant commun, vous devez confirmer que le champ useUUIDAsDeviceId est défini sur false afin d’éviter une interruption de l’intégration.

S’il est défini sur true, vous devez implémenter le mappage de l’ID de l’appareil iOS pour Swift afin de transmettre le device_id Braze à AppsFlyer lors de l’installation de l’application, pour que Braze puisse correctement faire correspondre les attributions iOS.

• swift
• objective-c

1
2
3
4
5
6
let configuration = Braze.Configuration(
    apiKey: "<BRAZE_API_KEY>",
    endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
AppsFlyerLib.shared().customData = ["brazeDeviceId": braze.deviceId]

1
2
3
4
5
6
BRZConfiguration *configurations = [[BRZConfiguration alloc] initWithApiKey:@"BRAZE_API_KEY" endpoint:@"BRAZE_END_POINT"];
[configurations setUseUUIDAsDeviceId:NO];
Braze *braze = [[Braze alloc] initWithConfiguration:configurations];
[[AppsFlyerLib shared] setAdditionalData:@{
    @"brazeDeviceId": braze.deviceId
}];

Pour mapper l’ID de l’appareil dans Unity, utilisez le code suivant :

1
2
3
4
Appboy.AppboyBinding.getDeviceId()
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("brazeCustomerId", Appboy.AppboyBinding.getDeviceId());
AppsFlyer.setAdditionalData(customData);

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

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

Vous y 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 en créer une nouvelle 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’AppsFlyer.

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

1. Dans AppsFlyer, accédez à la page Integrated Partners depuis le menu de navigation. Recherchez ensuite Braze et sélectionnez le logo Braze pour ouvrir une fenêtre de configuration.
2. Dans l’onglet Integration, activez Activate Partner.
3. Fournissez la clé d’importation des données et l’endpoint REST que vous avez trouvés dans le tableau de bord de Braze.
4. Désactivez Advanced Privacy et enregistrez votre configuration.

Important

Lorsque vous saisissez l’endpoint REST de Braze dans l’onglet Integration d’AppsFlyer, entrez uniquement le domaine (par exemple, rest.fra-02.braze.eu) sans le protocole https:// et sans le chemin /attribution/appsflyer. AppsFlyer ajoute automatiquement le protocole en préfixe et le chemin en suffixe. Inclure l’un ou l’autre dans votre saisie provoque des échecs de postback.

Des informations supplémentaires sur ces instructions sont disponibles dans la documentation d’AppsFlyer.

Étape 4 : Confirmer l’intégration

Sur la page des partenaires technologiques AppsFlyer dans Braze, l’indicateur de connexion affiche Not Connected jusqu’à ce que vous génériez une clé API d’importation des données à l’étape 2. Après avoir généré la clé, l’indicateur passe à Connected et affiche un horodatage. Cet horodatage reflète le moment où l’intégration a été initialement configurée dans Braze (lorsque la clé d’importation des données a été créée), et non la dernière fois qu’AppsFlyer a envoyé un postback.

Pour confirmer que les données d’attribution d’installation circulent depuis AppsFlyer, utilisez l’étape 5 pour vérifier que les données d’installation non organique apparaissent dans les filtres Segment de Braze. Braze ignore les installations organiques provenant des postbacks AppsFlyer et ne les stocke pas comme données d’installation attribuées.

Étape 5 : Visualiser les données d’attribution des utilisateurs

Champs de données disponibles

Si votre intégration a réussi, Braze mappe toutes les données d’installation non organique vers les filtres Segment.

Vous pouvez segmenter votre base d’utilisateurs par données d’attribution dans le tableau de bord de Braze en utilisant les filtres d’attribution d’installation.

De plus, les données d’attribution pour un utilisateur particulier sont disponibles sur le profil de chaque utilisateur dans le tableau de bord de Braze.

Remarque

Les données d’attribution pour les Campaigns Facebook et X (anciennement Twitter) ne sont pas disponibles via nos partenaires. Ces sources média ne permettent pas à leurs 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.

Intégrer AppsFlyer avec Braze pour la création de liens profonds

Les deep links—des liens qui dirigent les utilisateurs vers une page ou un emplacement spécifique au sein d’une application ou d’un site web—sont utilisés pour créer une expérience utilisateur sur mesure.

Bien que largement utilisés, des problèmes peuvent survenir lors de l’utilisation de deep links dans des e-mails avec le suivi des clics—une autre fonctionnalité importante utilisée pour collecter les données utilisateur. Ces problèmes sont dus au fait que les fournisseurs de services d’e-mail marketing (fournisseur de services d’e-mailing) encapsulent les deep links dans un domaine d’enregistrement des clics, ce qui casse le lien original. Par conséquent, la prise en charge des deep links nécessite une configuration supplémentaire.

AppsFlyer fournit un service qui évite ces problèmes, en permettant à AppsFlyer de servir d’intermédiaire entre le serveur fournisseur de services d’e-mailing et votre nom de domaine. Son rôle de proxy permet de fournir des fichiers d’association (AASA/asset links), ce qui facilite la création de liens profonds.

Étape 1 - Créer un domaine de suivi des clics

En suivant les éléments initiaux du guide de configuration des e-mails de Braze, créez un domaine d’envoi d’e-mails et un domaine de suivi des clics. Pour obtenir de l’aide, vous pouvez créer un ticket via le tableau de bord de Braze afin de lancer la configuration du nouveau domaine de suivi des clics avec l’équipe e-mail de Braze.

La création d’un nouveau domaine de suivi des clics est obligatoire, même si vous en utilisez déjà un. Cela garantit qu’il n’y a aucun impact sur le trafic des Campaigns d’e-mails en cours.

Important

AppsFlyer crée le certificat SSL. À ce stade, les liens des e-mails ne sont probablement pas sécurisés, ce qui signifie que le préfixe de l’URL est HTTP au lieu de HTTPS. Ce problème est résolu dans les étapes suivantes.

Étape 2 - Créer un modèle OneLink dans AppsFlyer

Créez un modèle OneLink et configurez les Universal Links/App Links sous « When app is installed ». Ce modèle sera utilisé ultérieurement pour créer des liens OneLink pour vos Campaigns par e-mail.

Remarque

Si vous disposez déjà d’un modèle OneLink existant configuré pour activer les Universal Links/App Links, vous pouvez l’utiliser.

Étape 3 - Configurer votre intégration Braze dans AppsFlyer

Il est maintenant temps de configurer votre intégration Braze dans AppsFlyer. Cette étape et la suivante (« Configurer votre application ») peuvent être effectuées simultanément. Pour configurer votre intégration Braze dans AppsFlyer :

1. Dans AppsFlyer, depuis le menu latéral, sélectionnez Engage > fournisseur de services d’e-mailing integration. {#1-in-appsflyer-from-the-side-menu-select-engage-esp-integration}

2. Sélectionnez Braze. {#2-select-braze}

3. Sélectionnez le modèle OneLink que vous souhaitez utiliser pour les Campaigns par e-mail, puis cliquez sur Next. {#3-select-the-onelink-template-you-want-to-use-for-email-campaigns-then-click-next}

4. Saisissez votre domaine de suivi des clics et la valeur « Braze endpoint », qui a été fournie avec le nouveau CTD créé à l’étape 1, puis cliquez sur Validate connection. {#4-enter-your-click-tracking-domain-and-braze-endpoint-value-which-was-provided-with-the-new-ctd-created-in-step-1-then-click-validate-connection}

Cela permet de vérifier que le domaine de suivi des clics pointe vers l’endpoint que vous avez saisi.

Par « Braze Endpoint », AppsFlyer demande les informations fournies par Braze à l’étape 1 de ce guide, en particulier le nouveau CTD.

Cliquez ensuite sur Validate connection, ce qui vérifie que le domaine de suivi des clics pointe vers l’endpoint que vous avez saisi. Une fois terminé, cliquez sur Next.

5. Acheminer le trafic des liens vers AppsFlyer : {#5-route-link-traffic-to-appsflyer}

a. Copiez et envoyez les instructions préfabriquées personnalisées dans AppsFlyer à votre administrateur informatique ou de domaine.

Votre administrateur doit rediriger le trafic de vos Campaigns par e-mail des serveurs fournisseur de services d’e-mailing vers les serveurs AppsFlyer en mettant à jour vos enregistrements DNS CNAME avec le nouveau domaine fourni par AppsFlyer.

Ainsi, chaque fois qu’un lien est cliqué, le clic est redirigé vers AppsFlyer, qui à son tour le redirige vers l’endpoint fournisseur de services d’e-mailing.

b. Après avoir copié et envoyé les instructions, cliquez sur Done.

Votre intégration Braze a été créée.

Important

Le statut de votre intégration Braze est en attente et ne commence à fonctionner qu’après le mappage de l’enregistrement CNAME. Il peut s’écouler jusqu’à 24 heures après le mappage pour qu’une nouvelle intégration commence à fonctionner et devienne active.

Étape 4 : Configurer votre application (tâche développeur)

AppsFlyer propose des instructions sur la configuration correcte de l’application, que vos équipes web ou applicatives doivent suivre pour prendre en charge les liens universels.

Étape 5 : Confirmer que le suivi des clics SSL est activé avec Braze

À ce stade, après avoir partagé et validé les détails CTD dans AppsFlyer, nous vous recommandons d’effectuer un envoi test pour vérifier si votre domaine d’envoi OneLink dispose d’un certificat SSL. Cela est conforme à notre guide de configuration des e-mails.

Vous pouvez effectuer l’assurance qualité et la résolution des problèmes en envoyant un deep link à l’aide de OneLink. Consultez la documentation AppsFlyer pour plus de détails sur l’utilisation de OneLink.

Si les liens CTD sont identifiés comme HTTP, contactez l’équipe Email Ops de Braze pour activer le suivi des clics SSL. Cela garantit que tous les liens HTTP sont automatiquement convertis en HTTPS. Vous pouvez utiliser le texte de message suivant lorsque vous contactez votre gestionnaire du succès des clients, ou en créant un ticket dans le tableau de bord de Braze comme à l’étape 1 :

1
2
Hi Team,
Could you please enable SSL click tracking for CTD XXX? It is currently set to HTTP instead of HTTPS.

URL de suivi des clics AppsFlyer dans Braze (facultatif)

Vous pouvez utiliser les liens d’attribution OneLink d’AppsFlyer dans les Campaigns Braze pour les notifications push, les e-mails et d’autres canaux. Cela vous permet de renvoyer les données d’attribution d’installation ou de réengagement de vos Campaigns Braze vers AppsFlyer. Vous pouvez ainsi mesurer vos efforts marketing plus efficacement et prendre des décisions basées sur les données.

Vous pouvez simplement créer votre URL de suivi OneLink dans AppsFlyer et l’insérer directement dans vos Campaigns Braze. AppsFlyer utilise ensuite ses méthodologies d’attribution probabiliste pour attribuer l’utilisateur qui a cliqué sur le lien. Nous vous recommandons d’ajouter un identifiant d’appareil à vos liens de suivi AppsFlyer afin d’améliorer la précision des attributions de vos Campaigns Braze. Cela permet d’attribuer de manière déterministe l’utilisateur qui a cliqué sur le lien.

• android
• ios

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

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