Ir para o conteúdo

Criar e atualizar usuários (em massa)

post

/users/track/bulk

Use este endpoint para registrar eventos personalizados e compras, além de atualizar atributos de perfis de usuário em massa.

Quando usar este endpoint

Assim como o endpoint /users/track, você pode usar este endpoint para atualizar perfis de usuário. Este endpoint é mais adequado para atualizações em massa:

  • Solicitações maiores: envie até 1.000 usuários por solicitação. Assim, você faz menos solicitações em grandes preenchimentos retroativos e sincronizações.
  • Priorização: em condições de pico de tráfego, as solicitações para /users/track têm prioridade sobre as solicitações para /users/track/bulk.

Use este endpoint quando estiver preenchendo retroativamente muitos perfis de usuário durante a integração ou sincronizando grandes volumes de perfis como parte de uma sincronização diária.

Perguntas frequentes

Devo usar este endpoint ou /users/track?

Use os dois endpoints de acordo com o seu caso de uso:

  • Para grandes preenchimentos retroativos e sincronizações, use /users/track/bulk.
  • Para casos de uso em tempo real, use /users/track.

Quais identificadores posso usar em /users/track/bulk?

Para cada objeto de solicitação, inclua um dos seguintes: external_id, braze_id, user_alias, email ou phone.

Posso incluir atributos, eventos e compras em uma única solicitação?

Sim. Inclua qualquer combinação de atributos, eventos e compras, até o limite combinado de objetos de solicitação da sua conta.

Você pode baixar o documento OpenAPI e usá-lo para validar esquemas. Para saber como, consulte Usar esquemas OpenAPI para validação de solicitações.

New Stuff!