Mise en place des Currents

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

Conditions

L’utilisation de Currents avec l’un de nos partenaires nécessite les mêmes paramètres de base et 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ù elle doit écrire ces fichiers, en particulier les noms ou les clés des compartiments.

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 de leur partenaire respectif, ainsi que toutes les nuances associées à ces exigences de base.

Condition	Origine	Accès	Description
Compte chez le partenaire	Organisez un compte avec ce partenaire ou contactez votre gestionnaire de compte Braze pour obtenir des suggestions.	Consultez le site de ce partenaire ou contactez-le pour vous inscrire.	Braze n’enverra pas de données à un partenaire si vous n’avez pas accès à ces données via le compte de votre société.
Clé ou Jeton (token) de l’API du partenaire	Généralement le tableau de bord du partenaire.	Copiez-le et collez-le dans le champ Braze prévu à cet effet.	Braze a un champ désigné pour cela dans la page Intégrations pour ce partenaire. Nous en avons besoin pour mapper l’endroit où nous envoyons vos données. Gardez vos clés ou jetons de partenaire à jour ; des identifiants non valides peuvent désactiver votre connecteur et faire tomber des événements.
Code/Clé d’authentification, Clé secrète, Fichier de certification	Contactez un représentant de votre compte chez ce partenaire. Elles sont parfois présentes sur le tableau de bord du partenaire.	Copiez et collez les clés dans le champ Braze désigné. Générez et chargez .jsonou d’autres fichiers de certification dans l’emplacement approprié de Braze.	Braze a un champ désigné pour cela dans la page Intégrations pour ce partenaire. Cela fournit des identifiants à Braze et nous autorise à écrire des fichiers sur le compte du Partenaire. Il est important que vos informations d’authentification soient à jour ; des identifiants non valides peuvent entraîner la désactivation de votre connecteur et l’abandon d’événements.
Compartiment, chemin de dossier	Certains partenaires organisent et trient des données par compartiments. Vous devriez le voir dans le tableau de bord du partenaire.	Le cas échéant, copiez le nom du compartiment ou le chemin d’accès au fichier exactement dans l’espace prévu à cet effet dans Braze.	Certains partenaires l’exigent, et c’est important de ne pas se tromper si vous le faites.

Configuration de Currents

Étape 1 : Choisissez votre partenaire

Braze Currents vous permet d’intégrer via Data Storage à l’aide de fichiers plats, ou avec nos partenaires Behavioral Analytics et Customer Data, en utilisant des payloads JSON en batch pour un endpoint désigné.

Avant de commencer votre intégration, il est préférable de décider quelle intégration vous convient le mieux. Par exemple, si vous utilisez déjà mParticle et Segment et que vous souhaitez y envoyer 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 le stockage des données (Braze utilise cette méthode !).

Étape 2 : Flux Currents ouverts

Pour commencer, allez 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 actuel”, 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 de 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és aux messages.

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

Étape 5 : Mise en place des transformations de champ

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

• **supprimer :** Remplace la chaîne de caractères par [REDACTED]. Ceci est utile si votre partenaire rejette les événements dont les champs sont manquants ou vides.
• **Hash :** Applique un algorithme de hachage SHA-256 à la 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 champs Envoi d’e-mail, Ouverture d’e-mail, Rebond d’e-mail et Changement d’état du groupe d’abonnement.

Étape 6 : Tester votre intégration

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

Envoi d’événements de test

Pour tester votre intégration, vous pouvez sélectionner Envoyer des événements de test 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 liés au comportement des clients et Événements liés à l’engagement des messages.

Test des connecteurs de courant

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 propriétés suivantes :

• Le nombre de connecteurs Test Currents que vous pouvez créer n’est pas limité.
• Un maximum global de 10 000 événements par période de déploiement de sept jours. Ce total d’événements est mis à jour toutes les heures sur le tableau de bord.

Lorsque vos connecteurs Test Currents atteignent la limite d’envoi, votre connecteur n’enverra plus d’événements jusqu’à la prochaine période de sept jours.

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

Mise à jour des courants

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.

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)