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

Si le message « You do not have any remaining Currents integrations » s’affiche lors de l’ajout d’une nouvelle intégration, ou si le bouton pour ajouter un nouveau connecteur Currents est grisé, les causes les plus fréquentes sont les suivantes :

• Aucun droit d’accès Currents n’a été acheté pour cet espace de travail.
• Le droit d’accès 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 autre espace de travail peut disposer d’un droit d’accès Currents disponible. Si vous devez demander un droit d’accès ou ajuster votre configuration, contactez votre gestionnaire de compte Braze.

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

Si vous pouvez créer ou modifier un connecteur mais que vous ne parvenez pas à activer l’un des commutateurs de suivi optionnels, votre espace de travail a peut-être atteint la limite de droits d’accès pour cette catégorie d’événements.

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

Si vous avez besoin de droits d’accès supplémentaires ou d’aide pour ajuster votre configuration, contactez votre gestionnaire de compte Braze.

Prérequis

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 des autorisations nécessaires pour écrire et envoyer des fichiers de données, et Braze demande l’emplacement où ces fichiers doivent être écrits, notamment les noms de compartiments ou les clés.

Les prérequis suivants constituent la base minimale pour intégrer la plupart de nos partenaires. Certains partenaires nécessitent des paramètres supplémentaires, qui sont indiqués dans leur documentation partenaire respective, ainsi que les particularités associées à ces prérequis de base.

Important

Il est important de maintenir vos clés partenaires, jetons partenaires et informations d’authentification à jour ; 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 supprimés et les données seront définitivement perdues.

Configuration de Currents

Étape 1 : Choisir votre partenaire

Braze Currents vous permet de vous intégrer via le stockage de données à l’aide de fichiers plats ou via nos partenaires d’analyse comportementale et de données client en utilisant des payloads JSON groupés envoyés vers un endpoint désigné.

Avant de commencer votre intégration, il est préférable de déterminer laquelle est la plus adaptée à vos objectifs. Par exemple, si vous utilisez déjà mParticle et Segment et souhaitez y diffuser les données de Braze, il est recommandé d’utiliser un payload JSON groupé. Si vous préférez manipuler les données vous-même ou si vous avez un système d’analyse de données plus complexe, il peut être plus judicieux d’utiliser le stockage de données (Braze utilise cette méthode !)

Étape 2 : Ouvrir Currents

Pour commencer, accédez à Intégrations partenaires > Currents. Vous serez redirigé vers 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 un ensemble différent d’étapes de configuration. Pour activer chaque intégration, consultez notre liste de partenaires disponibles et suivez les instructions sur 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 pouvez consulter la liste de ces événements dans nos bibliothèques d’événements de comportement client et d’événements d’engagement lié aux messages.

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

Étape 5 : Configurer les transformations de champs

Vous pouvez utiliser les transformations de champs Currents pour supprimer ou hacher un champ de type chaîne de caractères.

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

Sélectionner un champ pour l’une de ces transformations appliquera cette transformation à tous les événements dans lesquels ce champ apparaît. Par exemple, sélectionner email_address pour le hachage hachera le champ email_address dans les événements Email Send, Email Open, Email Bounce et Subscription Group State Change.

Étape 6 : Tester votre intégration

Important

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

Avant de tester, pensez à consulter nos exemples de données Currents sur GitHub. Lorsque vous êtes prêt à tester, choisissez une option dans la section suivante :

Envoi d’événements de test

Pour tester votre intégration, vous pouvez sélectionner Send Test Events pour envoyer un événement de chaque type d’événement sélectionné vers ce Current. Pour des informations détaillées sur chaque type d’événement, consultez nos bibliothèques d’événements de comportement client et d’événements d’engagement lié aux messages.

Test des connecteurs Currents

Les connecteurs Currents de test sont des versions gratuites de nos connecteurs existants qui peuvent être utilisées pour tester et essayer différentes destinations. Les connecteurs Currents de test disposent des caractéristiques suivantes :

• Jusqu’à 10 connecteurs Currents de test par espace de travail.
• Un maximum global 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 à jour ce total toutes les heures.

Une fois que vos connecteurs Currents de test atteignent 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 Currents de test, 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.

Listes d’autorisation d’adresses IP

Braze enverra les données Currents à partir des adresses IP répertoriées :

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