Singular
Singular est une plateforme d’analyse marketing unifiée qui permet l’attribution, l’agrégation des coûts, l’analyse marketing, les rapports créatifs et l’automatisation des flux de travail.
Cette intégration est maintenue par Singular.
À propos de l’intégration
L’intégration de Braze et Singular vous permet d’importer des données d’attribution d’installation payante pour segmenter intelligemment au sein de vos campagnes basées sur le cycle de vie client.
Conditions préalables
| Condition | Description |
|---|---|
| Compte Singular | Un compte Singular est nécessaire pour profiter de ce partenariat. |
| Application iOS ou Android | Cette intégration prend en charge les applications iOS et Android. En fonction de votre plateforme, des extraits de code peuvent être requis dans votre application. Vous trouverez des détails sur ces exigences à l’étape 1 du processus d’intégration. |
| SDK Singular | En plus du SDK Braze requis, vous devez installer le SDK Singular. |
Intégration
Étape 1 : Mapper les ID utilisateur
Android
Si vous avez une application Android, vous devrez inclure l’extrait de code suivant, qui transmet un ID utilisateur unique de Braze à Singular.
1
2
3
String appboyDeviceId = Braze.getInstance(context).getDeviceId();
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
.withGlobalProperty(“brazeDeviceID”, appboyDeviceId, true);
iOS
Avant février 2023, notre intégration d’attribution Singular 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 de Braze utilisant Objective-C de récupérer le device_id de Braze et de l’envoyer à Singular 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 mutuel, vous devez vous assurer que le champ useUUIDAsDeviceId est défini sur false afin que rien ne vienne perturber l’intégration.
Si la valeur est true, vous devez mettre en œuvre le mappage de l’ID de l’appareil iOS pour Swift afin de transmettre le device_id de Braze à Singular lors de l’installation de l’application pour que Braze fasse correctement correspondre les attributions iOS.
1
2
3
4
5
6
SingularConfig* config = [[SingularConfig
alloc] initWithApiKey:SDKKEY andSecret:SDKSECRET];
[config setGlobalProperty:@"brazeDeviceId" withValue:brazeDeviceId
overrideExisting:YES];
[Singular start:config];
1
config.setGlobalProperty("brazeDeviceId", withValue: brazeDeviceId, overrideExisting: true)
Étape 2 : Obtenir la clé d’importation des données de Braze
Dans Braze, naviguez vers Intégrations partenaires > Partenaires technologiques et sélectionnez Singular.
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.
Vous devrez fournir la clé d’importation des données et l’endpoint REST à votre gestionnaire de compte Singular pour terminer l’intégration.
Étape 3 : Confirmer l’intégration
Après que Braze a reçu des données d’attribution de Singular, l’indicateur de connexion sur la page des partenaires technologiques de Singular 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 concernant une installation attribuée. Braze ignore les installations organiques (les exclut du postback Singular) et ne les comptabilise pas pour déterminer si la connexion est réussie.
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 auprès de nos partenaires. Ces sources médiatiques n’autorisent pas leurs partenaires à 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 Singular dans Braze (facultatif)
L’utilisation de liens de suivi des clics dans vos campagnes Braze vous permettra de voir facilement quelles campagnes favorisent les installations d’applications et le réengagement. Vous serez ainsi en mesure de mesurer plus efficacement vos efforts marketing et de prendre des décisions fondées sur les données pour savoir où investir davantage de ressources afin d’obtenir un ROI maximal.
Pour commencer à utiliser les liens de suivi des clics de Singular, consultez leur documentation. Vous pouvez insérer les liens de suivi des clics de Singular directement dans vos campagnes Braze. Singular utilisera alors ses méthodes d’attribution probabiliste pour attribuer l’utilisateur qui a cliqué sur le lien. Nous vous recommandons d’ajouter à vos liens de suivi Singular un identifiant d’appareil afin d’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é de manière native grâce à l’intégration du SDK Singular. Vous pouvez inclure le GAID dans vos liens de suivi des clics Singular 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 Singular collectent automatiquement l’IDFV de manière native grâce à nos intégrations SDK. Il peut être utilisé comme identifiant de l’appareil. Vous pouvez inclure l’IDFV dans vos liens de suivi des clics Singular en utilisant la logique Liquid suivante :
1
2
3
{% 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 — tel que l’IDFV ou le GAID — dans vos liens de suivi des clics, ou si vous ne prévoyez pas de le faire à l’avenir, Singular sera toujours en mesure d’attribuer ces clics grâce à sa modélisation probabiliste.