Cloud Data Ingestion de Braze
Braze Cloud Data Ingestion (CDI) vous permet de configurer une connexion directe depuis votre solution de stockage de données afin de synchroniser les données utilisateur pertinentes et d’autres données non utilisateur vers Braze. Ces données peuvent ensuite être utilisées à des fins de personnalisation ou de segmentation pour optimiser vos cas d’usage marketing. L’intégration flexible de Cloud Data Ingestion prend en charge les structures de données complexes, y compris les JSON imbriqués et les tableaux d’objets.
Fonctionnement
Avec l’ingestion de données cloud (CDI) de Braze, vous configurez une intégration entre votre instance d’entrepôt de données et votre espace de travail Braze afin de synchroniser les données selon une planification ou à la demande. Chaque intégration peut avoir sa propre planification.
- Synchronisations planifiées : Les synchronisations récurrentes peuvent s’exécuter jusqu’à toutes les 5 minutes, ou aussi rarement qu’une fois par mois. Par défaut, l’intervalle le plus court que vous pouvez définir dans le tableau de bord est de 15 minutes. Cela permet de maîtriser les coûts de calcul de votre entrepôt de données et le volume de requêtes. Pour synchroniser jusqu’à toutes les 5 minutes, contactez le support de Braze ou votre gestionnaire de la satisfaction client.
- Synchronisations à la demande : Pour synchroniser les données dès qu’elles changent, appelez l’endpoint Déclencher une synchronisation avec l’ID de votre intégration lorsque votre tâche de chargement ou de transformation dans l’entrepôt se termine. Les synchronisations à la demande n’affectent pas votre planification récurrente. Une seule synchronisation peut s’exécuter à la fois par intégration.
Les intégrations de stockage de fichiers (Amazon S3, Azure Blob Storage et Google Cloud Storage) sont pilotées par les événements et n’utilisent pas de planification. Braze ingère les nouveaux fichiers dès leur téléversement. Pour en savoir plus sur la configuration, consultez Amazon S3, Google Cloud Storage ou Azure Blob Storage.
Lorsqu’une synchronisation s’exécute, Braze se connecte directement à votre instance d’entrepôt de données, récupère toutes les nouvelles données de la table spécifiée et met à jour les données correspondantes dans votre tableau de bord de Braze. À chaque exécution de la synchronisation, toutes les données mises à jour sont reflétées dans Braze.
Cas d’usage
Grâce aux fonctionnalités d’ingestion de données cloud de Braze, vous pouvez :
- Créer en quelques minutes une intégration simple entre votre entrepôt de données ou votre solution de stockage de fichiers et Braze.
- Synchroniser en toute sécurité les données utilisateur, notamment les attributs, les événements et les achats, de votre entrepôt de données vers Braze.
- Boucler la boucle des données avec Braze en combinant l’ingestion de données cloud avec Currents ou Snowflake Data Sharing.
Par ailleurs, les sources connectées constituent une alternative sans copie. Braze peut interroger directement votre entrepôt de données ou votre solution de stockage de fichiers pour créer des Segments CDI —sans copier les données sous-jacentes dans Braze.
Sources de données prises en charge
L’ingestion de données cloud peut synchroniser des données à partir des sources suivantes. Chaque source dispose de sa propre page de configuration dans les sources d’ingestion de données cloud.
Entrepôts de données
Stockage de fichiers
Types de données pris en charge
L’ingestion de données cloud prend en charge les types de données suivants :
Données utilisateur
- Attributs utilisateur, notamment :
- Attributs personnalisés imbriqués
- Tableaux d’objets
- Statuts d’abonnement
- Événements personnalisés
- Événements d’achat
- Demandes de suppression d’utilisateurs
Objets non utilisateur
- Éléments de catalogue
- Objets de données, y compris les relations avec les utilisateurs et les relations entre objets
Messaging zéro copie
- Déclencheurs de Canvas
- Sources connectées
Identifiants utilisateur pour l’ingestion de données
Lorsque vous synchronisez des données utilisateur avec l’ingestion de données cloud, vous pouvez identifier les utilisateurs à l’aide d’un ou plusieurs des types d’identifiants suivants. Chaque ligne de votre table source ne doit contenir une valeur que pour un seul type d’identifiant à la fois, mais votre table peut inclure des colonnes pour un, deux, trois, quatre ou l’ensemble des cinq types d’identifiants.
| Identifiant | Description |
|---|---|
EXTERNAL_ID |
L’ID externe qui identifie le profil utilisateur à créer ou à mettre à jour. Il doit correspondre à la valeur external_id utilisée dans Braze. |
ALIAS_NAME et ALIAS_LABEL |
Ces deux colonnes créent un objet alias d’utilisateur. alias_name doit être un identifiant unique, et alias_label indique le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seul alias_name par alias_label. |
BRAZE_ID |
L’identifiant utilisateur Braze généré par le SDK de Braze. Il n’est pas possible de créer de nouveaux utilisateurs à partir d’un ID Braze via l’ingestion de données cloud. Pour créer de nouveaux utilisateurs, indiquez un ID utilisateur externe ou un alias d’utilisateur. |
EMAIL |
L’adresse e-mail de l’utilisateur. Si plusieurs profils partagent la même adresse e-mail, le profil mis à jour le plus récemment est prioritaire pour les mises à jour. Si vous incluez à la fois l’e-mail et le numéro de téléphone, l’e-mail est utilisé comme identifiant principal. |
PHONE |
Le numéro de téléphone de l’utilisateur. Si plusieurs profils partagent le même numéro de téléphone, le profil mis à jour le plus récemment est prioritaire pour les mises à jour. |
Pour en savoir plus sur la configuration des colonnes de table et les exigences de formatage du payload, consultez la section Configuration des tables pour l’ingestion de données cloud.
Pour obtenir des instructions de configuration propres à chaque source ainsi que des exemples SQL, consultez la section Sources de l’ingestion de données cloud.
Trouver votre ID d’intégration
Vous trouverez votre ID d’intégration dans l’URL lorsque vous consultez une intégration dans le tableau de bord de Braze. Accédez à Paramètres des données > Ingestion de données cloud et sélectionnez une intégration. L’ID d’intégration apparaît dans l’URL au format https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]. Par exemple, si votre URL est https://dashboard-01.braze.com/integrations/cloud_data_ingestion/abc123xyz, votre ID d’intégration est abc123xyz. Vous pouvez utiliser cet ID dans vos appels API pour déclencher des synchronisations ou vérifier leur statut.
Utilisation des points de données
Pour les clients dont la facturation repose sur les points de données, la facturation des points de données pour l’ingestion de données cloud est équivalente à celle des mises à jour effectuées via l’endpoint /users/track. Pour en savoir plus, consultez la page Points de données.
L’ingestion de données cloud de Braze est prise en compte dans la limite de débit disponible. Si vous envoyez également des données par une autre méthode, la limite de débit est donc partagée entre l’API de Braze et l’ingestion de données cloud.
Limites du produit
| Limite | Description |
|---|---|
| Nombre d’intégrations | Le nombre d’intégrations que vous pouvez configurer n’est pas limité. |
| Nombre de lignes | Par défaut, chaque exécution peut synchroniser jusqu’à 500 millions de lignes. Toute synchronisation comportant plus de 500 millions de nouvelles lignes est interrompue. Si vous avez besoin d’une limite plus élevée, contactez votre gestionnaire du succès des clients Braze ou le support de Braze. |
| Attributs par ligne | Pour les synchronisations utilisant une colonne payload, chaque ligne doit contenir un seul ID utilisateur et un objet JSON comportant jusqu’à 250 attributs. Chaque clé de l’objet JSON compte comme un attribut (autrement dit, un tableau compte comme un seul attribut). |
| Champs par objet de données | Un type d’objet de données peut comporter jusqu’à 500 champs. Une relation entre deux types peut comporter jusqu’à 25 champs. |
| Taille du payload | Pour les synchronisations utilisant une colonne payload, chaque ligne peut contenir un payload d’1 Mo maximum. Les payloads de plus d’1 Mo sont rejetés, et l’erreur « Payload was greater than 1MB » est consignée dans le journal de synchronisation, accompagnée de l’ID externe associé et du payload tronqué. |
| Type de données | Vous pouvez synchroniser des attributs utilisateur, des événements personnalisés, des événements d’achat, des demandes de suppression d’utilisateurs, des déclencheurs de Canvas, des articles de catalogue, des objets de données et des relations entre objets de données grâce à l’ingestion de données cloud. |
| Région Braze | Ce produit est disponible dans toutes les régions Braze. Toute région Braze peut se connecter à n’importe quelle région de données source. |
| Région source | Braze se connecte à votre entrepôt de données ou à votre environnement cloud, quels que soient la région ou le fournisseur cloud. |