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.

Si vous voyez le message « You do not have any remaining Currents integrations » lors de l’ajout d’une nouvelle intégration, 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 société.

Contactez votre gestionnaire de compte Braze pour demander un droit d’accès ou ajuster votre configuration.

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 de lui écrire et de lui envoyer des fichiers de données, et 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 élémentaires et minimales pour s’intégrer avec la plupart de nos partenaires. Certains partenaires exigeront des paramètres supplémentaires, qui sont énumérés dans la documentation du partenaire concerné, ainsi que toutes les nuances associées à ces exigences de base.

Important

Il est important de garder vos clés/jetons de partenaire et vos informations d’authentification à jour ; si les identifiants de votre connecteur expirent, le connecteur cessera d’envoyer des événements. Si ce problème 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 : Choisissez votre partenaire

Braze Currents vous permet de vous intégrer via Data Storage à l’aide de fichiers plats, ou avec nos partenaires d’analyse comportementale et de données clients en utilisant des payloads JSON en batch vers un endpoint désigné.

Avant de commencer votre intégration, il est préférable de décider quelle option vous convient le mieux. Par exemple, si vous utilisez déjà mParticle et Segment et que vous souhaitez y diffuser les données de Braze, il vaut mieux utiliser un payload JSON en batch. Si vous préférez manipuler les données par vous-même ou si vous disposez d’un système d’analyse des données plus complexe, il est préférable d’utiliser Data Storage (Braze utilise cette méthode !)

Étape 2 : Ouvrez Currents

Pour commencer, rendez-vous dans Intégrations partenaires > Currents. Vous serez dirigé vers la page de gestion des intégrations Currents.

Étape 3 : Ajoutez votre partenaire

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

Les étapes de configuration varient selon les partenaires. Pour activer chaque intégration, consultez notre liste de partenaires disponibles et suivez les instructions sur leurs pages respectives.

Étape 4 : Configurez 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 savoir plus sur nos événements dans notre article sur la sémantique de livraison des événements.

Étape 5 : Configurez 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 chaîne de caractères par [REDACTED]. Ceci 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 chaîne de caractères.

La sélection d’un champ pour l’une de ces transformations appliquera cette transformation à 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 Envoi d’e-mail, Ouverture d’e-mail, Rebond d’e-mail et Changement d’état du groupe d’abonnement.

Étape 6 : Testez votre intégration

Important

Currents abandonnera les événements dont le payload est excessivement volumineux (supérieur à 900 Ko).

Avant de tester, pensez à consulter notre échantillon de données Currents sur GitHub. Lorsque vous êtes prêt à tester, choisissez l’une des options ci-dessous :

Envoi d’événements de test

Pour tester votre intégration, vous pouvez sélectionner Send Test Events pour envoyer un événement de chacun des types d’événements sélectionnés à ce Current. Pour obtenir 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 Test Currents sont des versions gratuites de nos connecteurs existants qui peuvent être utilisées pour tester et essayer différentes destinations. Les connecteurs Test Currents présentent les caractéristiques suivantes :

• 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. Ce total d’événements est mis à jour toutes les heures sur le tableau de bord.

Une fois que vos connecteurs Test Currents ont atteint la limite d’envoi, votre connecteur n’enverra plus d’événements avant le lendemain (à 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. Emplacements/localisation et 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 commencera à envoyer des événements 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 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)