Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

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.

Comment ça fonctionne

Avec l’ingestion de données cloud (CDI) de Braze, vous établissez une intégration entre votre instance d’entrepôt de données et votre espace de travail Braze pour 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 aussi souvent que 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, ce qui permet de gérer les coûts de calcul de votre entrepôt et le volume de requêtes. Pour synchroniser aussi souvent que toutes les 5 minutes, contactez l’assistance Braze ou votre gestionnaire du succès des clients.
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 le chargement ou la tâche de transformation de votre entrepôt se termine. Les synchronisations à la demande n’affectent pas votre planification récurrente. Une seule synchronisation peut s’exécuter par intégration à la fois.

Les intégrations de stockage de fichiers (Amazon S3, Azure Blob Storage et Google Cloud Storage) sont pilotées par événements et n’utilisent pas de planification. Braze ingère les nouveaux fichiers dès qu’ils sont chargés. Pour plus de détails sur la configuration, consultez Intégrations de stockage de fichiers.

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 sur 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 une intégration simple directement depuis votre entrepôt de données ou votre solution de stockage de fichiers vers Braze en quelques minutes seulement.
Synchroniser en toute sécurité les données utilisateur, y compris les attributs, les événements et les achats, depuis 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 le partage de données Snowflake.

De plus, les sources connectées constituent une alternative en zéro copie. Vous pouvez demander à Braze d’interroger directement votre entrepôt de données ou votre solution de stockage de fichiers pour créer des segments CDI —le tout 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 de :

Entrepôts de données cloud :

Amazon Redshift
Databricks
Google BigQuery
Microsoft Fabric
Snowflake

Stockage de données cloud :

Amazon S3
Azure Blob Storage
Google Cloud Storage

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

Messaging en zéro copie

Déclencheurs Canvas
Sources connectées

Identifiants utilisateur pour l’ingestion de données

Lors de la synchronisation des données utilisateur via 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 les 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` spécifie 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 Braze. Il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un Braze ID via l’ingestion de données cloud. Pour créer de nouveaux utilisateurs, spécifiez un ID externe ou un alias d’utilisateur.
`EMAIL`	L’adresse e-mail de l’utilisateur. Si plusieurs profils avec la même adresse e-mail existent, le profil mis à jour le plus récemment est prioritaire pour les mises à jour. Si vous incluez à la fois l’e-mail et le 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 avec le même numéro de téléphone existent, le profil mis à jour le plus récemment est prioritaire pour les mises à jour.

Pour des informations détaillées sur la configuration des colonnes de table et les exigences de formatage du payload, consultez Configuration des tables pour l’ingestion de données cloud.

Pour des instructions de configuration spécifiques à chaque source et des exemples SQL, consultez Intégrations d’entrepôt de données.

Trouver votre ID d’intégration

Vous pouvez trouver votre ID d’intégration dans l’URL lorsque vous consultez une intégration dans le tableau de bord de Braze. Accédez à Data Settings > Cloud Data Ingestion 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 lors d’appels API pour déclencher des synchronisations ou vérifier le statut d’une synchronisation.

Utilisation des points de données

Pour les clients facturés en fonction des points de données, la facturation des points de données pour l’ingestion de données cloud est équivalente à la facturation des mises à jour via l’endpoint /users/track. Consultez Points de données pour plus d’informations.

Important

L’ingestion de données cloud de Braze est comptabilisée dans la limite de débit disponible. Si vous envoyez des données par une autre méthode, la limite de débit est partagée entre l’API Braze et l’ingestion de données cloud.

Limites du produit

Limite	Description
Nombre d’intégrations	Il n’y a pas de limite au nombre d’intégrations que vous pouvez configurer.
Nombre de lignes	Par défaut, chaque exécution peut synchroniser jusqu’à 500 millions de lignes. Toute synchronisation dépassant 500 millions de nouvelles lignes est arrêtée. Si vous avez besoin d’une limite plus élevée, contactez votre gestionnaire du succès des clients Braze ou le support Braze.
Attributs par ligne	Pour les synchronisations utilisant une colonne `payload`, chaque ligne doit contenir un seul identifiant utilisateur et un objet JSON comportant jusqu’à 250 attributs. Chaque clé de l’objet JSON compte comme un attribut (c’est-à-dire qu’un tableau compte comme un seul attribut).
Taille du payload	Pour les synchronisations utilisant une colonne `payload`, chaque ligne peut contenir un payload d’une taille maximale de 1 Mo. Les payloads supérieurs à 1 Mo sont rejetés, et l’erreur « Payload was greater than 1MB » est consignée dans le journal de synchronisation avec l’ID externe associé et le payload tronqué.
Type de données	Vous pouvez synchroniser des attributs utilisateur, des événements personnalisés, des événements d’achat, des éléments de catalogue, des demandes de suppression d’utilisateurs et des déclencheurs Canvas via 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 dans n’importe quelle région ou chez n’importe quel fournisseur cloud.

New Stuff!