Configurer Currents

Cette page décrit le processus générique d’intégration et de configuration de Braze Currents.

Important

Currents est inclus dans certaines offres Braze. Contactez votre conseiller Braze si vous avez des questions ou souhaitez y accéder.

Résolution des problèmes

Impossible d’ajouter une nouvelle intégration Currents

Le message « You do not have any remaining Currents integrations » peut s’afficher lorsque vous ajoutez une nouvelle intégration. Le bouton d’ajout d’un nouveau connecteur Currents peut aussi être grisé. Les causes les plus fréquentes sont les suivantes :

• Aucun droit d’utilisation Currents n’a été acheté pour cet espace de travail.
• Le droit d’utilisation Currents est disponible dans un autre espace de travail de votre entreprise.

Pour résoudre ce problème, vérifiez les autres espaces de travail de votre entreprise. Un droit d’utilisation Currents peut y être disponible. Pour demander un droit d’utilisation ou ajuster votre configuration, contactez votre gestionnaire de compte Braze.

Impossible d’activer le suivi d’événements supplémentaires

Vous pouvez créer ou modifier un connecteur, mais vous ne parvenez pas à activer l’un des boutons de suivi facultatifs ? Votre espace de travail a peut-être atteint la limite de droits d’utilisation pour cette catégorie d’événements.

• Track Customer Behavior and User Events nécessite des droits d’utilisation Customer Behavior Events disponibles.
• Track user profiles and attributes nécessite des droits d’utilisation User Profiles and Attributes disponibles.

Pour obtenir des droits d’utilisation supplémentaires ou de l’aide pour ajuster votre configuration, contactez votre gestionnaire de compte Braze.

Comprendre les notifications d’erreur d’intégration

Lorsqu’une intégration Currents rencontre des difficultés pour transmettre des événements, Braze envoie un e-mail aux adresses de contact définies pour cette intégration. Si l’intégration n’a pas d’adresse e-mail de contact, Braze demande à votre équipe de compte Braze de joindre la bonne personne. Pour recevoir ces notifications directement, ajoutez une adresse e-mail de contact à chaque intégration.

Toutes les notifications utilisent la même ligne d’objet, y compris celles qui signalent le rétablissement de l’intégration : « [Urgent Action Required to Prevent Data Loss] Nom de l’entreprise Type d’intégration Currents integration failing ». Pour identifier la notification reçue, cherchez dans le tableau suivant la phrase qui figure dans le corps de l’e-mail. Si l’e-mail indique que l’intégration a été désactivée, utilisez la ligne « désactivée » correspondante, même si l’e-mail indique aussi que l’intégration est toujours en échec.

Exigences

L’utilisation de Currents avec l’un de nos partenaires repose sur les mêmes paramètres de base et la même méthodologie de connexion.

Chaque partenaire exige que Braze dispose de l’autorisation d’écrire et de lui envoyer des fichiers de données. Braze vous demande également l’emplacement où ces fichiers doivent être écrits, notamment les noms de compartiments ou les clés.

Les exigences suivantes constituent le minimum requis pour vous intégrer à la plupart de nos partenaires. Certains partenaires exigent des paramètres supplémentaires, indiqués dans leur documentation partenaire respective, avec les particularités liées à ces exigences de base.

Important

Il est important de maintenir à jour vos clés partenaires, jetons partenaires et informations d’authentification : si les identifiants de votre connecteur expirent, celui-ci cessera d’envoyer des événements. Si cette situation persiste pendant plus de 5 jours, les événements du connecteur seront abandonnés et les données seront définitivement perdues.

Configurer Currents

Étape 1 : Choisir votre partenaire

Braze Currents vous permet de vous intégrer au stockage de données à l’aide de fichiers plats, ou à nos partenaires d’analyse comportementale et de données clients en envoyant des payloads JSON par lots vers un endpoint désigné.

Avant de commencer, déterminez quelle intégration correspond le mieux à vos besoins. Par exemple, si vous utilisez déjà mParticle et Segment et souhaitez y diffuser les données de Braze, mieux vaut opter pour un payload JSON par lots. Si vous préférez manipuler les données vous-même ou disposez d’un système d’analyse de données plus complexe, le stockage de données sera sans doute plus adapté (c’est la méthode utilisée par Braze !)

Étape 2 : Ouvrir Currents

Pour commencer, accédez à Intégrations partenaires > Currents. Vous arrivez alors sur la page de gestion des intégrations Currents.

Étape 3 : Ajouter votre partenaire

Ajoutez un partenaire, parfois appelé « connecteur Currents », en sélectionnant le menu déroulant en haut de l’écran.

Chaque partenaire nécessite des étapes de configuration différentes. Pour activer chaque intégration, consultez notre liste de partenaires disponibles et suivez les instructions de leurs pages respectives.

Indiquez une adresse e-mail de contact pour les notifications d’erreurs d’intégration. Braze envoie des notifications à cette adresse si l’intégration rencontre des erreurs, telles que des problèmes d’identifiants ou de connectivité. Pour vous assurer que les bonnes personnes reçoivent les alertes, utilisez une liste de distribution ou une adresse e-mail de groupe.

Étape 4 : Configurer vos événements

Choisissez les événements que vous souhaitez transmettre à ce partenaire en cochant les options disponibles. Vous trouverez la liste de ces événements dans nos bibliothèques Événements de comportement client et Événements d’engagement liés aux messages.

Si nécessaire, vous pouvez en savoir plus sur nos événements dans notre article sur la sémantique de livraison des événements.

Étape 5 : Configurer les transformations de champs

Les transformations de champs Currents vous permettent de supprimer ou de hacher un champ de type chaîne de caractères.

• Supprimer : Remplace le champ de type chaîne de caractères par [REDACTED]. C’est utile si votre partenaire rejette les événements dont des champs sont manquants ou vides.
• Hacher : Applique un algorithme de hachage SHA-256 au champ de type chaîne de caractères.

Lorsque vous sélectionnez un champ pour l’une de ces transformations, celle-ci s’applique à tous les événements dans lesquels ce champ apparaît. Par exemple, si vous sélectionnez email_address pour le hachage, le champ email_address sera haché dans les événements Email Send, Email Open, Email Bounce et Subscription Group State Change.

Les transformations de champs fonctionnent uniquement sur les champs de type chaîne de caractères. Les autres types de champs, comme les tableaux, ne peuvent pas être sélectionnés : vous ne pouvez donc ni les supprimer ni les hacher. Par exemple, le champ de tableau suspected_bot_click_reason des événements Email Click reste présent dans votre exportation.

Modifier les transformations de champs sur un connecteur en production

Vous pouvez ajouter, modifier ou supprimer des transformations de champs sur un connecteur en production sans avoir à le relancer. Après avoir mis à jour le connecteur, vos modifications prennent effet en 5 minutes environ.

La modification des transformations de champs ne change ni la version du schéma Avro ni le segment version=<currents_version> de votre chemin de stockage. Seules les nouvelles versions de Currents modifient ce segment. Pour plus d’informations, consultez la section Modifications du schéma Avro.

Étape 6 : Tester votre intégration

Important

Currents abandonne les événements dont les payloads sont excessivement volumineux, c’est-à-dire supérieurs à 900 Ko.

Avant de lancer vos tests, n’hésitez pas à consulter nos exemples de données Currents sur GitHub. Lorsque vous êtes prêt à tester, choisissez l’une des options de la section suivante :

Envoyer des événements de test

Pour tester votre intégration, sélectionnez Send Test Events afin d’envoyer un événement de chacun des types sélectionnés vers ce Current. Pour en savoir plus sur chaque type d’événement, consultez nos bibliothèques Événements de comportement client et Événements d’engagement liés aux messages.

Tester les connecteurs Currents

Les connecteurs Test Currents sont des versions gratuites de nos connecteurs existants, que vous pouvez utiliser pour tester et essayer différentes destinations. Les Test Currents offrent :

• Jusqu’à 10 connecteurs Test Currents par espace de travail.
• Un maximum cumulé de 1 500 événements par période fixe de 24 heures, réinitialisé à minuit UTC. Sur la page Currents, vous pouvez suivre votre volume d’envoi actuel par rapport à cette limite. Braze met ce total à jour toutes les heures.

Braze vérifie l’utilisation des Test Currents par rapport à cette limite une fois par heure. Si un grand nombre d’événements arrive d’un coup entre deux vérifications horaires, vos connecteurs Test Currents peuvent exporter plus de 1 500 événements sur cette période avant que la limite ne s’applique.

Lorsqu’une vérification horaire constate que vos connecteurs Test Currents ont atteint la limite d’envoi, Braze désactive le connecteur et abandonne les événements créés tant que la limite est atteinte. La synchronisation des événements reprend après la réinitialisation de la limite à minuit UTC.

Pour mettre à niveau votre connecteur Test Currents, modifiez l’intégration dans le tableau de bord et sélectionnez Upgrade Test Integration.

Mise à jour de Currents

Pour mettre à jour votre connecteur Currents après son lancement, procédez comme suit :

1. Dans Braze, accédez à Intégrations partenaires > Exportation de données.
2. Localisez votre connecteur Currents dans la liste.
3. Sélectionnez  Modifier.
4. Effectuez vos modifications.
5. Sélectionnez Mettre à jour le flux Current.

Cela n’interrompra pas votre exportation existante et les événements commenceront à être envoyés en fonction de votre nouvelle sélection.

Remarque

Il peut s’écouler un certain temps avant que vos modifications ne prennent effet.

Liste d’adresses IP autorisées

Braze envoie les données Currents à partir des adresses IP suivantes :

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)