Importer des utilisateurs
Découvrez les différentes options d’importation d’utilisateurs de Braze, comme l’importation CSV, la REST API, l’Ingestion de données cloud, et plus encore.
Options d’importation
Vous pouvez charger des attributs utilisateur et des événements via une importation CSV dans Braze, un script d’importation CSV Lambda S3 sans serveur, des appels API directs ou l’Ingestion de données cloud depuis votre entrepôt de données.
Importation CSV Braze
Vous pouvez utiliser l’importation CSV pour enregistrer et mettre à jour les attributs utilisateur et événements personnalisés suivants. Pour commencer, consultez Importation CSV.
| Type | Définition | Exemple | Taille maximale du fichier |
|---|---|---|---|
| Attributs par défaut | Attributs utilisateur réservés reconnus par Braze. | first_name, email |
500 Mo |
| Attributs personnalisés | Attributs utilisateur propres à votre entreprise. | last_destination_searched |
500 Mo |
| Événements personnalisés | Événements propres à votre entreprise qui représentent des actions utilisateur. | trip_booked |
50 Mo |
Construire votre CSV
Braze accepte les données utilisateur au format CSV standard. Les importations d’attributs par défaut et personnalisés prennent en charge des fichiers jusqu’à 500 Mo ; les importations d’événements personnalisés prennent en charge des fichiers jusqu’à 50 Mo. Pour les identifiants, les en-têtes de colonnes, les règles de validation et les exemples, consultez Importation CSV.
Lorsque vous chargez un fichier CSV volumineux via Importer des utilisateurs dans le tableau de bord, la page peut sembler ne pas répondre ou répondre lentement pendant que Braze reçoit le fichier et exécute l’étape de calcul. Laissez le chargement et le calcul se terminer — la durée totale varie de quelques minutes à quelques heures selon la taille du fichier, et les fichiers plus volumineux prennent plus de temps à calculer.
Lors de l’importation d’événements personnalisés avec des propriétés, vous devez utiliser la notation par points dans les en-têtes de colonnes de votre CSV. Pour plus d’informations sur le formatage des événements personnalisés, consultez Comprendre le formatage des événements personnalisés.
Importation CSV Lambda d’utilisateurs
Utilisez notre script d’importation CSV Lambda S3 sans serveur pour charger des attributs utilisateur dans Braze. Cette solution fonctionne comme un outil de chargement CSV : vous déposez vos fichiers CSV dans un compartiment S3, et les scripts les chargent via notre API.
Les temps d’exécution estimés pour un fichier d’un million de lignes sont d’environ cinq minutes. Consultez Importation d’attributs utilisateur CSV vers Braze pour plus d’informations.
REST API
Utilisez l’endpoint /users/track pour enregistrer des événements personnalisés, des attributs utilisateur et des achats pour les utilisateurs.
Ingestion de données cloud
Utilisez l’Ingestion de données cloud de Braze pour importer et maintenir les attributs utilisateur.
Validation HTML
Gardez à l’esprit que Braze ne nettoie pas, ne valide pas et ne reformate pas les données HTML lors de l’importation, ce qui signifie que les balises script doivent être supprimées de toutes les données d’importation que vous utilisez pour la personnalisation web.
Lors de l’importation de données dans Braze spécifiquement destinées à la personnalisation dans un navigateur web, assurez-vous qu’elles sont débarrassées du HTML, du JavaScript ou de toute autre balise script qui pourrait potentiellement être exploitée de manière malveillante lors du rendu dans un navigateur web.
Vous pouvez également utiliser les filtres Liquid de Braze (strip_html) pour supprimer le HTML du texte rendu. Par exemple :
1
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}
1
Have you read Ulysses?