Importar usuários
Conheça as diversas opções de importação de usuários da Braze, como importação por CSV, REST API, Ingestão de dados na nuvem e muito mais.
Opções de importação
Você pode fazer upload de atributos e eventos de usuários por meio de uma importação de CSV na Braze, um script serverless de importação de CSV via S3 Lambda, chamadas diretas à API ou Ingestão de dados na nuvem a partir do seu data warehouse.
Importação de CSV da Braze
Você pode usar a importação de CSV para registrar e atualizar os seguintes atributos de usuários e eventos personalizados. Para começar, consulte Importação de CSV.
| Tipo | Definição | Exemplo | Tamanho máximo do arquivo |
|---|---|---|---|
| Atributos padrão | Atributos de usuário reservados e reconhecidos pela Braze. | first_name, email |
500 MB |
| Atributos personalizados | Atributos de usuário exclusivos do seu negócio. | last_destination_searched |
500 MB |
| Eventos personalizados | Eventos exclusivos do seu negócio que representam ações dos usuários. | trip_booked |
50 MB |
Construindo seu CSV
A Braze aceita dados de usuários no formato CSV padrão. Importações de atributos padrão e personalizados suportam arquivos de até 500 MB; importações de eventos personalizados suportam arquivos de até 50 MB. Para identificadores, cabeçalhos de coluna, regras de validação e exemplos, consulte Importação de CSV.
Quando você faz upload de um CSV grande por meio de Importar usuários no dashboard, a página pode parecer não responder ou ficar lenta enquanto a Braze recebe o arquivo e executa a etapa de cálculo. Deixe o upload e o cálculo terminarem — o tempo total varia de alguns minutos a algumas horas, dependendo do tamanho do arquivo, e arquivos maiores levam mais tempo para calcular.
Ao importar eventos personalizados com propriedades, você deve usar notação de ponto nos cabeçalhos de coluna do seu CSV. Para saber mais sobre a formatação de eventos personalizados, consulte Entendendo a formatação de eventos personalizados.
Importação de CSV de usuários via Lambda
Use nosso script serverless de importação de CSV via S3 Lambda para fazer upload de atributos de usuários para a Braze. Essa solução funciona como um uploader de CSV: você coloca seus CSVs em um bucket S3 e os scripts fazem o upload por meio da nossa API.
O tempo estimado de execução para um arquivo com 1.000.000 de linhas é de aproximadamente cinco minutos. Consulte Importação de CSV de atributos de usuários para a Braze para saber mais.
REST API
Use o endpoint /users/track para registrar eventos personalizados, atributos de usuários e compras.
Ingestão de dados na nuvem
Use a Ingestão de dados na nuvem da Braze para importar e manter atributos de usuários.
Validação de HTML
Tenha em mente que a Braze não sanitiza, valida ou reformata dados HTML durante a importação, o que significa que tags de script devem ser removidas de todos os dados de importação que você usa para personalização web.
Ao importar dados para a Braze que são especificamente destinados ao uso de personalização em um navegador web, certifique-se de que estejam livres de HTML, JavaScript ou qualquer outra tag de script que possa ser explorada de forma maliciosa quando renderizada em um navegador web.
Como alternativa, para HTML, você pode usar os filtros Liquid da Braze (strip_html) para remover HTML do texto renderizado. Por exemplo:
1
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}
1
Have you read Ulysses?