Créer et mettre à jour des utilisateurs (en masse)
Utilisez cet endpoint pour enregistrer en masse des événements personnalisés et des achats, et mettre à jour les attributs de profils utilisateur.

Cet endpoint est actuellement en bêta limitée. Même si nous n’ajoutons pas de nouveaux clients à la bêta pour le moment, n’hésitez pas à contacter votre gestionnaire de compte Braze si vous pensez que cette fonctionnalité pourrait être utile pour votre intégration Braze.
Quand utiliser cet endpoint
Comme l’endpoint /users/track, cet endpoint vous permet de mettre à jour des profils utilisateur. Il est toutefois mieux adapté aux mises à jour en masse :
- Requêtes plus volumineuses : Envoyez jusqu’à 1 000 utilisateurs par requête, ce qui réduit le nombre de requêtes nécessaires pour les remplissages rétroactifs et les synchronisations de grande ampleur.
- Priorisation : En cas de pic de trafic, les requêtes vers
/users/tracksont prioritaires par rapport aux requêtes vers/users/track/bulk.
Utilisez cet endpoint lorsque vous importez rétroactivement de nombreux profils utilisateur pendant l’onboarding, ou lorsque vous synchronisez de grands volumes de profils dans le cadre d’une synchronisation quotidienne.

Les limites d’objets de requête de l’endpoint /users/track varient selon le modèle de tarification et la configuration. Utilisez /users/track/bulk pour l’ingestion en masse.
Questions fréquentes
Dois-je utiliser cet endpoint ou /users/track ?
Utilisez les deux endpoints en fonction de votre cas d’usage :
- Pour les remplissages rétroactifs et les synchronisations de grande ampleur, utilisez
/users/track/bulk. - Pour les cas d’usage en temps réel, utilisez
/users/track.
Quels identifiants puis-je utiliser dans /users/track/bulk ?
Pour chaque objet de requête, incluez l’un des identifiants suivants : external_id, braze_id, user_alias, email ou phone.
Puis-je inclure des attributs, des événements et des achats dans une seule requête ?
Oui. Vous pouvez combiner librement attributs, événements et achats, dans la limite combinée d’objets de requête de votre compte.
Vous pouvez télécharger le document OpenAPI et l’utiliser pour valider des schémas. Pour savoir comment procéder, consultez Utiliser les schémas OpenAPI pour la validation des requêtes.