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 lorsque vous ajoutez une nouvelle intégration, ou si le bouton permettant d’ajouter un nouveau connecteur Currents est grisé, les causes courantes 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 au sein de votre entreprise. Un autre espace de travail peut disposer d’un droit d’accès à Currents. Si vous devez demander un droit d’accès ou 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. Braze demande l’emplacement où 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 avec la plupart de nos partenaires. Certains partenaires nécessitent des paramètres supplémentaires, qui sont répertoriés dans leur documentation partenaire respective, ainsi que toutes les nuances associées à ces exigences 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, le connecteur 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 à nos partenaires d’analyse comportementale et de données clients 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 que les données Braze y soient diffusées, 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 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 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 trouver 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 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

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 comportant des champs 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, dépassant 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 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.

Une fois que 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 IP répertoriées :

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