Configuration de Currents
Cette page décrit et décrit le processus générique d’intégration et de configuration de Braze Currents.
Currents est inclus dans certaines offres Braze. Contactez votre représentant Braze si vous avez des questions ou souhaitez y accéder.
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 | Créez un compte chez ce partenaire ou contactez votre gestionnaire de compte Braze pour obtenir des suggestions. | Consultez le site du partenaire ou contactez ce partenaire 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 désigné. | Braze a un champ désigné pour cela dans la page Intégrations pour ce partenaire. Nous en avons besoin pour mapper où nous envoyons vos données. Il est important que vos clés/jetons de partenaires soient à jour ; des identifiants non valides peuvent entraîner la désactivation de votre connecteur et l’abandon d’é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 .json ou 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. | Si nécessaire, assurez-vous de copier exactement le nom ou le chemin du compartiment dans l’espace désigné à Braze. Nous ne voulons pas que vos données soient perdues ! | Certains partenaires l’exigent, et c’est important de ne pas se tromper si vous le faites. |
Il est important de garder les identifiants et les clés/jetons de votre partenaire à jour ; si les identifiants de votre connecteur expirent, le connecteur cessera d’envoyer des événements. Si cette situation persiste pendant plus de 48 heures, les événements du connecteur seront abandonnés et les données seront définitivement perdues.
É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 : Accéder à Currents
Pour commencer, sélectionnez Intégrations partenaires > Exportation de données. Vous serez dirigé vers la page de gestion des Intégrations Currents.
Si vous utilisez l’ancienne navigation, cette page se trouve sous Intégrations > Currents.
Étape 3 : Ajouter un 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 : Configurer les é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 : Transformations de champ
Les transformations de champs de Currents vous permettent de désigner certains champs de chaînes de caractères dans Currents pour les supprimer (remplacement par une chaîne vide) ou les hacher (application d’un algorithme de hachage SHA-256).
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
Vous pouvez tester votre intégration ou examiner les exemples de données Currents dans notre référentiel GitHub d’exemples Currents.
Notez que Currents abandonnera les événements dont la charge utile est excessivement importante (plus de 900 Ko).
Connecteurs test 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 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.
Mise à jour des courants
To update your Currents connector after launching, do the following:
- In Braze, navigate to Partner Integrations > Data Export.
- Locate and your Currents connector in the list.
- Select Edit.
- Make your changes.
- Select Update Current.
This will not stop your existing export and will begin sending events according to your new selection.
It may take some time for your changes to take effect.
Liste d’adresses IP autorisées
Braze enverra des données Currents à partir des IP répertoriées, qui sont automatiquement et dynamiquement ajoutées à toutes les clés API qui ont fait l’objet d’un abonnement à la liste d’autorisation.
Pour les instances US-01 , US-02 , US-03 , US-04 , US-05 , US-06 et US-07 : |
---|
127.0.0.1 |
23.21.118.191 |
34.206.23.173 |
50.16.249.9 |
52.4.160.214 |
54.87.8.34 |
54.156.35.251 |
52.54.89.238 |
18.205.178.15 |
Pour les instances EU-01 et EU-02 : |
---|
127.0.0.1 |
52.58.142.242 |
52.29.193.121 |
35.158.29.228 |
18.157.135.97 |
3.123.166.46 |
3.64.27.36 |
3.65.88.25 |
3.68.144.188 |
3.70.107.88 |
Pour l’instance US-08 : |
---|
52.151.246.51 |
52.170.163.182 |
40.76.166.157 |
40.76.166.170 |
40.76.166.167 |
40.76.166.161 |
40.76.166.156 |
40.76.166.166 |
40.76.166.160 |
40.88.51.74 |
52.154.67.17 |
40.76.166.80 |
40.76.166.84 |
40.76.166.85 |
40.76.166.81 |
40.76.166.71 |
40.76.166.144 |
40.76.166.145 |