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 vous voyez le message « You do not have any remaining Currents integrations » 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 courantes sont :

• 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 afficher 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 facultatifs, 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.

Conditions requises

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

Chaque partenaire exige que Braze ait l’autorisation d’écrire et d’envoyer des fichiers de données vers leur service, et Braze demande l’emplacement vers lequel ces fichiers doivent être écrits, en particulier les noms de compartiments ou les clés.

Les conditions suivantes sont les exigences de base minimales pour s’intégrer à la plupart de nos partenaires. Certains partenaires nécessiteront des paramètres supplémentaires, qui sont répertoriés dans leur documentation partenaire respective, accompagnés de toutes les nuances associées à ces exigences de base.

Important

Il est important de maintenir à jour vos clés de partenaire, vos jetons de partenaire et vos 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 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 en utilisant des fichiers plats, ou vers nos partenaires d’analyse comportementale et de données client en utilisant des payloads JSON par lots vers un endpoint désigné.

Avant de commencer votre intégration, il est préférable de déterminer quelle intégration convient le mieux à vos besoins. Par exemple, si vous utilisez déjà mParticle et Segment et souhaitez y diffuser vos données Braze, il serait préférable d’utiliser un payload JSON par lots. Si vous préférez manipuler les données vous-même ou si vous disposez d’un système d’analyse de données plus complexe, il serait peut-être préférable 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 dirigé 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 trouverez la liste de ces événements dans nos bibliothèques Événements de comportement client et É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 d’envoi d’e-mail, d’ouverture d’e-mail, de rebond d’e-mail et de changement d’état du groupe d’abonnement.

Étape 6 : Tester votre intégration

Important

Currents abandonnera les événements dont les payloads sont excessivement volumineux, supérieurs à 900 Ko.

Avant de tester, envisagez de 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 Événements de comportement client et É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 Currents de test disposent de :

• Jusqu’à 10 connecteurs Currents de test par espace de travail.
• Un maximum agrégé de 1 500 événements par période fixe de 24 heures, réinitialisé à minuit UTC. Ce total d’événements est mis à jour toutes les heures sur le tableau de bord.

Lorsque vos connecteurs Currents de test atteignent la limite d’envoi, votre connecteur n’enverra plus d’événements jusqu’au jour suivant (à 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.

Liste d’autorisation des 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)