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.

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 sur cycle de vie.

Conditions préalables

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

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 l’adresse device_id de Braze à Singular lors de l’installation de l’application pour que Braze corresponde correctement aux attributions d’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 de Braze

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

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.

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

Une fois que Braze aura reçu les données d’attribution de Singular, l’indicateur de connexion d’état sur la page des partenaires technologiques de Singular 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 d’une attribution d’installation. Les installations organiques, qui doivent être exclues du système de communication automatisé de Singular, sont ignorées par notre API et ne sont pas comptabilisées pour déterminer si une connexion a été établie avec succès.

Données d’attribution de Facebook et de 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 de marketing et de prendre des décisions fondées sur des 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 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 %}