Microsoft Azure Blob Storage
Microsoft Azure Blob Storage est un stockage d’objets massivement évolutif pour les données non structurées offert par Microsoft dans le cadre de la suite de produits Azure.
Si vous passez d’un fournisseur de stockage en nuage à un autre, contactez votre gestionnaire satisfaction client de Braze pour obtenir de l’aide sur la configuration et la validation de votre nouvelle intégration.
L’intégration de Braze et Microsoft azure Blob Storage vous permet de réexporter des données vers Azure et de diffuser des données Currents. Plus tard, vous pouvez utiliser un processus ETL (extraire, transformer, charger) pour transférer vos données vers d’autres emplacements.
Prérequis
| Condition | Descriptif |
|---|---|
| Microsoft Azure et compte de stockage Azure | Un compte Microsoft Azure et de stockage Azure est nécessaire pour tirer parti de ce partenariat. |
| Currents | Pour exporter des données vers Currents, vous devez avoir Braze Currents configuré pour votre compte. Currents n’est pas nécessaire si vous ne mettez en place que l’envoi de messages. |
Intégration
Pour intégrer Microsoft Azure Blob Storage, vous devez avoir un compte de stockage et une chaîne de caractères de connexion pour permettre à Braze soit d’exporter des données vers Azure, soit de diffuser des données Currents.
Étape 1 : Créer un compte de stockage
Dans Microsoft azure, accédez à Comptes de stockage dans la barre latérale et cliquez sur + Ajouter pour créer un nouveau compte de stockage. Ensuite, fournissez un nom de compte de stockage. Les autres paramètres par défaut n’auront pas besoin d’être mis à jour. Enfin, sélectionnez Revoir + créer.
Même si vous avez déjà un compte de stockage, nous vous recommandons d’en créer un nouveau spécifiquement pour vos données Braze.
Étape 2 : Obtenez la chaîne de connexion
Une fois le compte de stockage déployé, accédez au menu Clés d’accès depuis le compte de stockage et notez la chaîne de caractères de connexion.
Microsoft fournit deux clés d’accès pour maintenir les connexions en utilisant une clé tout en régénérant l’autre. Vous n’avez besoin que de la chaîne de connexion de l’un d’eux.
Braze utilise la chaîne de caractères de connexion de ce menu, pas la clé.
Étape 3 : Créer un conteneur de service blob
Accédez au menu Blobs dans la section Blob Service de votre compte de stockage. Créez un conteneur de service Blob dans le compte de stockage précédemment créé.
Fournissez un nom pour votre conteneur de service Blob. Les autres paramètres par défaut n’auront pas besoin d’être mis à jour.
Étape 4 : Configurer Currents
Dans Braze, accédez à Currents > + Créer un flux Current > Exporter des données Azure Blob et fournissez le nom de votre intégration et l’e-mail de contact.
Ensuite, fournissez votre chaîne de connexion, le nom du conteneur et le préfixe BlobStorage (facultatif).
Enfin, faites défiler la page vers le bas et sélectionnez les événements d’engagement des messages ou les événements de comportement des clients que vous souhaitez exporter. Une fois terminé, lancez votre Current.
Étape 5 : Configurer l’exportation de données Azure
La configuration suivante configure les informations d’identification utilisées pour :
- Les exports de segment via l’API
- Exportations CSV (campagne, segment, exportation de données utilisateur Canvas via le tableau de bord)
- rapports d’engagement
Dans Braze, accédez à Intégrations de partenaires > Partenaires technologiques > Microsoft Azure et spécifiez votre chaîne de caractères de connexion, le nom du conteneur de stockage Azure et le préfixe de stockage Azure.
Ensuite, assurez-vous que la case Définir comme destination d’exportation des données par défaut est cochée afin que vos données exportées soit envoyées à Azure. Lorsque vous avez terminé, enregistrez votre intégration.
Il est important de maintenir votre chaîne de connexion à jour ; si les informations d’identification de votre connecteur expirent, le connecteur cessera d’envoyer des événements. Si cela persiste pendant plus de 48 heures, les événements du connecteur seront abandonnés et les données seront définitivement perdues.
Comportement à l’exportation
Les utilisateurs qui ont intégré une solution de stockage de données en nuage et qui tentent d’exporter des API, des rapports de tableau de bord ou des rapports CSV rencontreront le problème suivant :
- Toutes les exportations d’API ne renverront pas d’URL de téléchargement dans le corps de la réponse et doivent être récupérées via le stockage des données.
- Tous les rapports de tableau de bord et les rapports CSV seront envoyés à l’e-mail de l’utilisateur pour téléchargement (aucune autorisation de stockage requise) et sauvegardés sur le stockage de données.
Exigences relatives au format JSON: Pour les exportations JSON, Braze utilise le format JSONL (JSON délimité par de nouvelles lignes), où chaque ligne contient un objet JSON distinct. Ce format diffère du JSON standard, qui est un tableau ou un objet JSON unique. Chaque ligne du fichier exporté est un objet JSON valide, mais le fichier dans son ensemble n’est pas un document JSON unique valide. Lorsque vous traitez ces fichiers, analysez chaque ligne individuellement en tant qu’objet JSON distinct plutôt que d’essayer d’analyser l’ensemble du fichier en tant que document JSON unique.
Les exportations actuelles utilisent le format Apache Avro (fichiers.avro ), et non JSON. Cette exigence de format JSON s’applique aux exportations de données de tableau de bord et aux exportations d’API qui utilisent le format JSON.
Modifier cette page sur GitHub