Passer au contenu

Créer et mettre à jour des utilisateurs (en masse)

post

/users/track/bulk

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

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/track sont 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.

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.

New Stuff!