Kochava
Kochava propose l’attribution et l’analyse mobile pour vous aider à exploiter vos données et favoriser votre croissance. La plateforme d’audience de Kochava vous permet de planifier, cibler, activer, mesurer et optimiser vos campagnes d’applications.
Cette intégration est maintenue par Kochava.
À propos de l’intégration
L’intégration de Braze et Kochava permet de mieux comprendre vos campagnes de manière globale en envoyant des données d’attribution à Braze afin de mieux cerner quelles campagnes génèrent des installations, de l’activité in-app, et plus encore.
Prérequis
| Condition | Description |
|---|---|
| SDK Braze | Le SDK mobile Braze est requis pour cette intégration. Braze fait correspondre les postbacks d’attribution Kochava aux profils utilisateur à l’aide des identifiants d’appareil que le SDK Braze crée et enregistre. Exporter les valeurs device_id depuis Braze et les transmettre à Kochava hors ligne n’est pas un substitut pris en charge à l’intégration du SDK Braze. |
| Compte Kochava | Un compte Kochava est requis pour tirer parti de ce partenariat. |
| Application iOS ou Android | Cette intégration prend en charge les applications iOS et Android. Selon votre plateforme, des extraits de code peuvent être requis dans votre application. Les détails de ces exigences se trouvent à l’étape 1 du processus d’intégration. |
| SDK Kochava | En plus du SDK Braze, vous devez installer le SDK Kochava. |
Intégration
Étape 1 : Mapper les ID utilisateur
Cette étape nécessite le SDK Braze dans votre application. Selon votre plateforme, votre application peut avoir besoin de transmettre l’identifiant d’appareil Braze (device_id) du SDK Braze à Kochava afin que, lorsque Kochava renvoie les données d’attribution à Braze, Braze puisse faire correspondre ces données au profil utilisateur correct. Consultez les sections Android et iOS pour savoir quand le mappage est requis.
Android
Le SDK Braze génère un identifiant d’appareil (device_id). Votre application doit récupérer cet identifiant et le transmettre à la méthode IdentityLink de Kochava. Cela permet à Kochava d’inclure le device_id dans les données d’attribution qu’il renvoie à Braze, afin que Braze puisse faire correspondre les événements d’attribution au profil utilisateur correct.
Récupérez le device_id Braze avec la méthode suivante :
Braze.getInstance(context).getDeviceId();
iOS

Avant février 2023, notre intégration d’attribution Kochava utilisait l’identifiant du fournisseur (IDFV) comme identifiant principal pour faire correspondre les données d’attribution iOS. Les clients Braze utilisant Objective-C n’ont pas besoin de récupérer le device_id Braze et de l’envoyer à Kochava lors de l’installation, car il n’y a aucune interruption de service.
À partir du SDK Swift v5.7.0, vous pouvez configurer si Braze utilise l’IDFV ou un UUID généré aléatoirement comme ID d’appareil. Dans le SDK Swift v7.0.0+, useUUIDAsDeviceId est défini sur true par défaut, de sorte que les nouveaux utilisateurs obtiennent un device_id UUID à moins que vous ne définissiez ce champ sur false. Pour plus d’informations, consultez Collecte de l’IDFV.
- Pour conserver l’IDFV comme identifiant commun avec Kochava, définissez
useUUIDAsDeviceIdsurfalse. - Si
useUUIDAsDeviceIdesttrue(la valeur par défaut dans la v7.0.0+), transmettez ledevice_idBraze à Kochava lors de l’installation de l’application afin que Braze puisse faire correspondre les attributions iOS.
Utilisez l’une des API non bloquantes suivantes pour récupérer le device_id Braze, puis transmettez cette valeur à Kochava selon les instructions du SDK iOS de Kochava. Pour une aide supplémentaire, contactez le support Kochava.
Gestionnaire de complétion
AppDelegate.braze?.getDeviceId { deviceId in
// Pass `deviceId` to Kochava
}
Concurrence Swift
let deviceId = await AppDelegate.braze?.getDeviceId()
Étape 2 : Obtenir la clé d’importation des données Braze
Dans Braze, naviguez vers Intégrations partenaires > Partenaires technologiques et sélectionnez Kochava.
Ici, vous pouvez trouver l’endpoint REST et 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 de Kochava.
Étape 3 : Configurer un postback depuis Kochava
Ajoutez un postback dans votre tableau de bord Kochava. Vous serez invité à fournir la clé d’importation des données et l’endpoint REST que vous avez trouvés dans le tableau de bord de Braze.
Étape 4 : Confirmer l’intégration
Sur la page des partenaires technologiques Kochava dans Braze, l’indicateur de connexion affiche Non connecté 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 à Connecté et affiche un horodatage. Cet horodatage indique le moment où l’intégration a été configurée pour la première fois dans Braze (lors de la création de la clé d’importation des données), et non la dernière fois que Kochava a envoyé un postback.
Pour confirmer que les données d’attribution d’installation circulent depuis Kochava, vérifiez que les données d’installation non organique apparaissent dans les filtres de Segment Braze. Braze ignore les installations organiques provenant des postbacks Kochava lorsque la source d’attribution est organic et ne les stocke pas en tant que données d’installation attribuées.
Données d’attribution Facebook et X (anciennement Twitter)
Les données d’attribution pour les campagnes Facebook et X (anciennement Twitter) ne sont pas disponibles par l’intermédiaire de nos partenaires. Ces sources médiatiques 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.
URL de suivi des clics Kochava dans Braze (facultatif)
Les liens de suivi des clics dans vos Campaigns Braze vous permettent de voir quelles Campaigns génèrent des installations d’applications et du réengagement. Vous pouvez ainsi mesurer vos efforts marketing plus efficacement et prendre des décisions basées sur les données pour savoir où investir davantage de ressources afin d’obtenir un ROI maximal.
Pour commencer avec les liens de suivi des clics Kochava, consultez leur documentation. Vous pouvez insérer les liens de suivi des clics Kochava directement dans vos Campaigns Braze. Kochava utilise 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 Kochava 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.
Pour Android, Braze permet aux clients d’activer la collecte de l’identifiant publicitaire Google (GAID). Le GAID est également collecté nativement via l’intégration SDK de Kochava. Vous pouvez inclure le GAID dans vos liens de suivi des clics Kochava en utilisant la logique Liquid suivante :
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}
Pour iOS, ajoutez l’identifiant d’appareil Braze pour améliorer l’attribution déterministe. En Liquid, most_recently_used_device.${id} correspond à l’ID d’appareil Braze, qui peut être l’IDFV ou un UUID selon le paramètre useUUIDAsDeviceId de votre SDK Swift. Les URL de suivi des clics de Kochava utilisent généralement un paramètre de requête idfv pour cette valeur :
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}

Cette recommandation est purement facultative
Si vous n’utilisez actuellement aucun identifiant d’appareil, comme l’ID d’appareil Braze ou le GAID, dans vos liens de suivi des clics, ou si vous ne prévoyez pas de le faire à l’avenir, Kochava peut toujours attribuer ces clics grâce à sa modélisation probabiliste.