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 afin de segmenter intelligemment vos campagnes basées sur le cycle de vie client.

Prérequis

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 Braze unique à Singular.

1
2
3

String appboyDeviceId = Braze.getInstance(context).getDeviceId();
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
  .withGlobalProperty(“brazeDeviceID”, appboyDeviceId, true);

iOS

Important

Avant février 2023, notre intégration d’attribution Singular utilisait l’Identifier for Vendor (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 de Braze et de l’envoyer à Singular lors de l’installation, car il n’y a aucune 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 qu’il n’y ait aucune interruption de l’intégration.

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

• objective-c
• swift

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 Braze

Dans Braze, naviguez vers Intégrations partenaires > Partenaires technologiques et sélectionnez Singular.

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.

Vous devrez fournir la clé d’importation des données et l’endpoint REST à votre gestionnaire de compte Singular pour finaliser l’intégration.

Étape 3 : Confirmer l’intégration

Sur la page des partenaires technologiques Singular 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. Une fois la clé générée, l’indicateur passe à Connected et affiche un horodatage. Cet horodatage indique quand l’intégration a été configurée pour la première fois dans Braze (lorsque la clé d’importation des données a été créée), et non la dernière fois que Singular a envoyé un postback.

Pour confirmer que les données d’attribution d’installation circulent depuis Singular, vérifiez que les données d’installation non organiques apparaissent dans les filtres de Segment de Braze. Braze ignore les installations organiques provenant des postbacks Singular 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é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.

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 génèrent des installations d’application et du réengagement. Ainsi, vous serez en mesure de mesurer vos efforts marketing plus efficacement et de prendre des décisions basées sur les données pour savoir où investir davantage de ressources afin d’obtenir le meilleur retour sur investissement.

Pour commencer avec les liens de suivi des clics Singular, consultez leur documentation. Vous pouvez insérer les liens de suivi des clics Singular directement dans vos campagnes Braze. Singular 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 Singular afin d’améliorer la précision des attributions de vos campagnes Braze. Cela permettra 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 %}

Remarque

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, Singular peut toujours attribuer ces clics grâce à sa modélisation probabiliste.