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 o upload de atributos de usuários e eventos por meio de uma importação via CSV na Braze, um script serverless de importação CSV pelo S3 Lambda, chamadas diretas à API ou Cloud Data Ingestion a partir do seu data warehouse.
Importação via CSV da Braze
Você pode usar a importação via CSV para registrar e atualizar os seguintes atributos de usuários e eventos personalizados. Para começar, consulte Importação por CSV.
| Tipo | Definição | Exemplo | Tamanho máximo do arquivo |
|---|---|---|---|
| Atributos padrão | Atributos de usuário reservados 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 do usuário. | 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 por CSV.
Ao fazer upload de um CSV grande por meio de Importar Usuários no dashboard, a página pode parecer sem resposta ou responder lentamente 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 CSV pelo S3 Lambda para fazer upload de atributos de usuários na Braze. Essa solução funciona como um uploader de CSV, no qual 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 cerca de cinco minutos. Para saber mais, consulte Importação de atributos de usuário via CSV para a Braze.
REST API
Use o endpoint /users/track para registrar eventos personalizados, atributos de usuários e compras.
Cloud Data Ingestion
Use o Cloud Data Ingestion da Braze para importar e manter atributos de usuários.
Validação de HTML
Lembre-se de que a Braze não sanitiza, valida ou reformata dados HTML durante a importação, o que significa que as 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 ao ser renderizada em um navegador web.
Como alternativa, para HTML, você pode usar os filtros Liquid da Braze (strip_html) para remover o HTML do texto renderizado. Por exemplo:
1
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}
1
Have you read Ulysses?