Skip to content

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 holistiques 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, vous permettant de créer des campagnes d’engagement client puissantes ciblant les bons utilisateurs au bon moment.

Conditions préalables

Intégration

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

Si vous avez une application Android, vous devez transmettre un ID 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 SDK Android 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)
}

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

Si ce champ est défini sur true, vous devez mettre en œuvre le mappage de l’ID de l’appareil iOS pour Swift afin de transmettre le champ device_id à Appsflyer lors de l’installation de l’application afin que Braze puisse correspondre correctement aux attributions iOS.

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, procédez comme suit :

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 : Obtenez la clé d’importation des données Braze

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

Ici, vous trouverez l’endpoint REST et générerez 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 dans l’étape suivante lors de la configuration d’un postback dans le tableau de bord d’Appsflyer.

La boîte de dialogue "Importation de données pour l'attribution d'installation" disponible sur la page Technologie d'Appsflyer. Cette boîte contient la clé d'importation des données et l'endpoint REST.

Étape 3 : Configurez Braze dans le tableau de bord d’Appsflyer

  1. Dans Appsflyer, accédez à la page Partenaires Intégrés dans la barre de gauche. Ensuite, recherchez Braze et sélectionnez le logo Braze pour ouvrir une fenêtre de configuration.
  2. Dans l’onglet intégration, activez Activer le partenaire.
  3. Indiquez la clé d’importation des données et le point de terminaison REST que vous avez trouvés dans le tableau de bord de Braze.
  4. Basculer Advanced Privacy off et enregistrer votre configuration.

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

Étape 4 : Confirmez l’intégration

Une fois que Braze reçoit les données d’attribution d’Appsflyer, l’indicateur d’état de la connexion sur la page des partenaires technologiques d’Appsflyer dans Braze passera de “Non connecté” à “Connecté”. Un horodatage de la dernière requête réussie sera également inclus.

Notez que cela ne se produira pas tant que nous n’aurons pas reçu de données sur une installation attribuée. Les installations organiques, qui doivent être exclues du système automatisé de communication Appsflyer, sont ignorées par notre API et ne sont pas comptabilisées lors de la détermination de l’établissement d’une connexion réussie.

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

Champs de données disponibles

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

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.

Quatre filtres disponibles. Le premier est « la source d'attribution d'installation est network_val_0 ». Le second est "La source d'attribution d'installation est campagne_val_0". Le troisième est « La source d'attribution d'installation est adgroup_val_0 ». Le quatrième est « La source d'attribution d'installation est creative_val_0 ». Outre les filtres répertoriés, vous pouvez voir comment ces sources d'attribution seront ajoutées au profil utilisateur. Dans la case "Attribution d'installation" de la page d'information d'un utilisateur, la source d'installation est indiquée comme network_val_0, la campagne est indiquée comme campaign_val_0, etc.

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.

Intégrez Appsflyer à un fournisseur de services de messagerie pour la création de liens profonds

Appsflyer s’intègre à la fois avec Sendgrid et SparkPost en tant que fournisseurs de services de messagerie (ESP) pour prendre en charge la création de liens profonds et le suivi des clics. Suivez les instructions ci-dessous pour intégrer le fournisseur de services de messagerie de votre choix.

  1. Dans Appsflyer, sélectionnez un modèle OneLink pour vos campagnes d’e-mails. Assurez-vous que le modèle prend en charge les liens universels (iOS) ou les liens d’application (Android).
  2. Configurez votre application pour prendre en charge la création de liens profonds avec OneLink. Consultez la documentation d’Appsflyer pour plus de détails sur la configuration de votre application pour prendre en charge OneLink.

Étape 2 : Configurez votre application pour prendre en charge les liens universels et les liens d’application

Les liens universels (iOS) ou les liens d’application (Android) sont autorisés par le système d’exploitation de l’appareil pour ouvrir une application spécifiée lorsqu’ils sont cliqués.

Effectuez les étapes suivantes pour prendre en charge les liens universels et les liens d’application.

Configurez l’hébergement du fichier Apple App Site Association (AASA) pour activer les liens universels dans vos e-mails.

  1. Obtenez un fichier AASA de l’une des manières suivantes :
    • Si vous avez configuré OneLink avec des liens universels, vous avez peut-être déjà un fichier AASA associé à OneLink. Pour obtenir le fichier AASA, effectuez ce qui suit :
      • Copiez le sous-domaine OneLink de votre modèle OneLink. Assurez-vous que le modèle prend en charge les liens universels.
      • Collez-le à la place de la marque substitutive dans l’URL suivante : <OneLinkSubdomain>.onelink.me/.well-known/apple-app-site-association
      • Pour télécharger le fichier AASA, collez l’URL OneLink dans la barre d’adresse de votre navigateur et appuyez sur Entrée. Le fichier sera ensuite téléchargé sur votre ordinateur, et vous pourrez l’ouvrir et en consulter le contenu à l’aide de n’importe quel éditeur de texte.
    • Le guide d’Apple sur les liens universels explique comment créer le fichier AASA.
  2. Hébergez le fichier AASA dans le serveur de domaine de votre enregistrement de clics. Le fichier doit être hébergé dans le chemin : click.example.com/.well-known/apple-app-site-association.

Consultez la documentation Sendgrid pour apprendre à configurer le fichier AASA pour Sendgrid et configurer les services de réseau de diffusion de contenu pour héberger le fichier AASA.

Configurez l’hébergement de fichiers de liens d’actifs numériques pour activer les liens d’application dans vos e-mails.

  1. Obtenez un fichier de liens de ressources numériques en utilisant l’une des méthodes suivantes :
    • Si vous avez configuré OneLink avec des liens d’application, vous avez peut-être déjà un fichier de liens de ressources numériques associé à OneLink. Pour obtenir le fichier, effectuez ce qui suit :
      • Copiez le sous-domaine OneLink de votre modèle OneLink. Assurez-vous que le modèle prend en charge les liens d’application.
      • Ajoutez /.well-known/assetlinks.json à la fin de l’URL OneLink.
      • Pour télécharger le fichier de liens de ressources numériques, collez l’URL OneLink dans la barre d’adresse de votre navigateur et appuyez sur Entrée. Par exemple, https://<OneLinkSubdomain>.onelink.me/.well-known/assetlinks.json. Le fichier sera ensuite téléchargé sur votre ordinateur, et vous pourrez l’ouvrir et en consulter le contenu à l’aide de n’importe quel éditeur de texte.
    • Le guide d’Android sur les liens d’application explique comment créer le fichier de liens de ressource numérique.
  2. Hébergez le fichier de liens d’actifs numériques dans le serveur de domaine d’enregistrement de clics. Le fichier doit être hébergé dans le chemin : click.example.com/.well-known/apple-app-site-association.

Consultez la documentation Sendgrid pour savoir comment configurer le fichier de liens de ressources numériques pour Sendgrid et configurer les services de réseau de diffusion de contenu pour héberger le fichier de liens de ressources numériques.

Étape 2a: Configurer l’hébergement de fichiers AASA

Configurez l’hébergement du fichier Apple App Site Association (AASA) pour activer les liens universels dans vos e-mails.

  1. Obtenez un fichier AASA de l’une des manières suivantes :
    • Si vous avez configuré OneLink avec des liens universels, vous avez peut-être déjà un fichier AASA associé à OneLink. Pour obtenir le fichier AASA, effectuez ce qui suit :
      • Copiez le sous-domaine OneLink de votre modèle OneLink. Assurez-vous que le modèle prend en charge les liens universels.
      • Collez-le à la place de la marque substitutive dans l’URL suivante : <OneLinkSubdomain>.onelink.me/.well-known/apple-app-site-association
      • Pour télécharger le fichier AASA, collez l’URL OneLink dans la barre d’adresse de votre navigateur et appuyez sur Entrée. Le fichier sera ensuite téléchargé sur votre ordinateur, et vous pourrez l’ouvrir et en consulter le contenu à l’aide de n’importe quel éditeur de texte.
    • Le guide d’Apple sur les liens universels explique comment créer le fichier AASA.
  2. Hébergez le fichier AASA dans le serveur de domaine de votre enregistrement de clics. Le fichier doit être hébergé dans le chemin : click.example.com/.well-known/apple-app-site-association.

Consultez la documentation SparkPost pour apprendre à configurer le fichier AASA pour SparkPost et définir des sous-chemins de lien personnalisés.

Étape 2b: Redirigez votre domaine de suivi des clics vers votre hôte de fichier AASA

Lors de la configuration de l’e-mail, vous avez créé un enregistrement CNAME dans votre serveur DNS. Effectuez les étapes suivantes après avoir vérifié votre domaine de suivi des clics dans Braze.

  1. Supprimez l’enregistrement CNAME qui redirige votre sous-domaine vers le domaine SparkPost.
  2. Créez un enregistrement CNAME qui redirige votre domaine de suivi des clics vers le réseau de diffusion de contenu hébergeant votre fichier AASA d’application, au lieu de l’enregistrement que vous avez supprimé ci-dessus.

Étape 2a: Configurer l’hébergement de fichiers de liens de ressources numériques

Configurez l’hébergement de fichiers de liens d’actifs numériques pour activer les liens d’application dans vos e-mails.

  1. Obtenez un fichier de liens de ressources numériques en utilisant l’une des méthodes suivantes :
    • Si vous avez configuré OneLink avec des liens d’application, vous avez peut-être déjà un fichier de liens de ressources numériques associé à OneLink. Pour obtenir le fichier, effectuez ce qui suit :
      • Copiez le sous-domaine OneLink de votre modèle OneLink. Assurez-vous que le modèle prend en charge les liens d’application.
      • Ajoutez /.well-known/assetlinks.json à la fin de l’URL OneLink.
      • Pour télécharger le fichier de liens de ressources numériques, collez l’URL OneLink dans la barre d’adresse de votre navigateur et appuyez sur Entrée. Par exemple, https://<OneLinkSubdomain>.onelink.me/.well-known/assetlinks.json. Le fichier sera ensuite téléchargé sur votre ordinateur, et vous pourrez l’ouvrir et en consulter le contenu à l’aide de n’importe quel éditeur de texte.
    • Le guide d’Android sur les liens d’application explique comment créer le fichier de liens de ressource numérique.
  2. Hébergez le fichier de liens d’actifs numériques dans le serveur de domaine d’enregistrement de clics. Le fichier doit être hébergé dans le chemin : click.example.com/.well-known/apple-app-site-association.

Consultez la documentation SparkPost pour savoir comment configurer le fichier de liens de ressources numériques pour SparkPost et définir des sous-chemins de liens personnalisés.

Étape 2b: Redirigez votre domaine de suivi des clics vers votre hôte de fichier de liens de ressources numériques

Lors de la configuration de l’e-mail, vous avez créé un enregistrement CNAME dans votre serveur DNS. Effectuez les étapes suivantes après avoir vérifié votre domaine de suivi des clics dans Braze.

  1. Supprimez l’enregistrement CNAME qui redirige votre sous-domaine vers le domaine SparkPost.
  2. Créez un enregistrement CNAME qui redirige votre domaine de suivi des clics vers le réseau de diffusion de contenu hébergeant le fichier de liens d’actifs numériques de votre application, au lieu de l’enregistrement que vous avez supprimé ci-dessus.

Étape 3 : Configurez votre SDK AppsFlyer pour prendre en charge la création de liens profonds

Étape 3a: Configurez votre SDK pour prendre en charge le fichier AASA

Après avoir hébergé le fichier AASA dans votre domaine d’enregistrement de clics, configurez votre SDK AppsFlyer pour prendre en charge le fichier AASA.

  1. Dans Xcode, sélectionnez votre projet.
  2. Sélectionnez Capacités.
  3. Activez les domaines associés.
  4. Cliquez sur + et entrez votre domaine de clics. Par exemple, applinks:click.example.com. Un clic sur le lien universel a pour effet d’ouvrir votre application et d’initier le SDK. Pour permettre à l’application d’extraire le lien OneLink associé au domaine de clics et de résoudre le lien profond, procédez comme suit :

Étape 3b: Gérer les données de lien profond

  1. Fournissez le domaine d’enregistrement des clics à l’API SDK resolveDeepLinkURLs. Cette API doit être appelée avant l’initialisation du SDK. AppsFlyerLib.shared().resolveDeepLinkURLs = ["click.example.com","spgo.io"]
  2. Utilisez l’onAppOpenAttribution API pour obtenir les paramètres du lien profond et gérer les données du lien profond.

Étape 3a: Configurez votre SDK pour prendre en charge le fichier de liens de ressources numériques

Après avoir hébergé le fichier Digital Asset Links dans votre domaine d’enregistrement de clics à l’étape précédente, configurez votre SDK pour prendre en charge le fichier.

Dans votre manifeste Android, ajoutez l’hôte du domaine de clic et tout préfixe dans la balise de l’activité dans laquelle vous souhaitez créer un lien profond.

1
2
3
4
5
6
7
8
9
10
11
12
<activity android:name=".DeepLinkActivity">
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data
        android:scheme="https"
        android:host="click.example.com"
        android:pathPrefix="/campaign"
      />
    </intent-filter>
  </activity>

Étape 3b: Gérer les données de lien profond

Un clic sur un lien d’application a pour effet d’ouvrir votre application et d’initier le SDK. Pour permettre à l’application d’extraire le lien OneLink associé au domaine de clics et de résoudre le lien profond, répertoriez les domaines de clics dans la méthode SDK setResolveDeepLinkURLs. Cette propriété doit être définie avant l’initialisation du SDK. AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");

Étape 3a: Configurez votre SDK pour prendre en charge le fichier AASA

Après avoir hébergé le fichier AASA dans votre domaine d’enregistrement de clics, configurez votre SDK pour prendre en charge le fichier AASA.

  1. Dans Xcode, sélectionnez votre projet.
  2. Sélectionnez Capacités.
  3. Activez les domaines associés.
  4. Cliquez sur + et entrez votre domaine de clics. Par exemple, applinks:click.example.com.

Étape 3b: Gérer les données de lien profond

Un clic sur le lien universel a pour effet d’ouvrir votre application et d’initier le SDK. Pour permettre au SDK d’extraire le lien OneLink associé au domaine de clics, procédez comme suit :

  1. Répertoriez les domaines de clics dans la propriété SDK resolveDeepLinkURLs. Assurez-vous de définir cette propriété avant l’initialisation du SDK.
  2. Assurez-vous que la liste spgo.io est l’un des domaines répertoriés. SparkPost possède ce domaine et il fait partie du flux de redirection. AppsFlyerLib.shared().resolveDeepLinkURLs = ["click.example.com","spgo.io"]
  3. Utilisez l’onAppOpenAttribution API pour obtenir les paramètres du lien profond et gérer les données du lien profond.

Étape 3a: Configurez votre SDK pour prendre en charge le fichier de liens de ressources numériques

Après avoir hébergé le fichier Digital Asset Links dans votre domaine d’enregistrement de clics à l’étape précédente, configurez votre SDK pour prendre en charge le fichier.

Dans votre manifeste Android, ajoutez l’hôte du domaine de clic et tout préfixe dans la balise de l’activité dans laquelle vous souhaitez créer un lien profond.

1
2
3
4
5
6
7
8
9
10
11
12
<activity android:name=".DeepLinkActivity">
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data
        android:scheme="https"
        android:host="click.example.com"
        android:pathPrefix="/campaign"
      />
    </intent-filter>
  </activity>

Étape 3b: Gérer les données du lien d’application

Un clic sur un lien d’application a pour effet d’ouvrir votre application et d’initier le SDK. Pour permettre à l’application d’extraire le lien OneLink associé au domaine de clics et de résoudre le lien profond, procédez comme suit :

  1. Répertoriez les domaines de clics dans la méthode SDK setResolveDeepLinkURLs. Cette propriété doit être définie avant l’initialisation du SDK.
  2. Assurez-vous que la liste spgo.io est l’un des domaines répertoriés. SparkPost possède ce domaine et il fait partie du flux de redirection. AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "spgo.io");

Une fois que vous avez terminé les étapes d’intégration, vous pouvez effectuer l’assurance qualité et la résolution des problèmes en envoyant un lien profond à l’aide de OneLink. Consultez la documentation d’Appsflyer pour plus de détails sur l’utilisation de OneLink.

URLs de suivi de clics Appsflyer dans Braze (facultatif)

Vous pouvez utiliser les liens d’attribution OneLink d’Appsflyer dans les campagnes Braze sur les notifications push, les e-mails, et plus encore. Cela vous permet de renvoyer les données d’attribution d’installation ou de réengagement de leurs campagnes Braze dans Appsflyer. En conséquence, vous serez en mesure de mesurer vos efforts marketing plus efficacement et de prendre des décisions basées sur les donnée.

Vous pouvez simplement créer votre URL de suivi OneLink dans Appsflyer et l’insérer directement dans vos campagnes Braze. Appsflyer utilisera ensuite ses méthodologies d’attribution probabiliste pour attribuer l’utilisateur qui a cliqué sur le lien. Nous recommandons d’ajouter vos liens de suivi AppsFlyer avec un identifiant d’appareil 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.

Braze permet aux clients Android de s’abonner à la collecte de l’ID publicitaire Google (GAID). Le GAID est également collecté nativement via l’intégration du SDK d’Appsflyer. Vous pouvez inclure le GAID dans vos liens de suivi de clics Appsflyer 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 Appsflyer 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 de clics Appsflyer en utilisant la logique Liquid suivante :

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}
CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!