Importação de CSV

Aprenda a gravar e atualizar atributos de usuário e eventos personalizados usando importação de CSV.

Sobre a importação de CSV

Você pode usar a importação de CSV para gravar e atualizar os seguintes atributos de usuário e eventos personalizados.

Usando a importação de CSV

Etapa 1: Baixar um modelo de CSV

Para abrir a importação de CSV, acesse Audiences > Import Users. Aqui, você encontrará uma tabela com detalhes sobre as importações mais recentes, como a data de upload, nome de quem fez o upload, nome do arquivo, disponibilidade de direcionamento, número de linhas importadas e status da importação.

Para começar com seu CSV, baixe um modelo para atributos ou eventos.

Etapa 2: Escolha um identificador

O CSV que você importar precisará de um identificador dedicado. Você pode escolher entre os seguintes:

• external id
• user alias
• braze id
• email address and phone numbers

Etapa 3: Construa seu arquivo CSV

Você pode fazer upload de qualquer um dos seguintes tipos de dados como um único arquivo CSV. Para fazer upload de mais de um tipo de dado, faça upload de múltiplos arquivos CSV.

• Atributos de usuário: Inclui tanto atributos de usuário padrão quanto personalizados. Atributos de usuário padrão são chaves reservadas na Braze (como first_name ou email), e atributos personalizados são atributos de usuário exclusivos do seu negócio (como last_destination_searched).
• Eventos personalizados: São exclusivos do seu negócio e refletem ações que um usuário realizou, como trip_booked para um app de reserva de viagens.

Quando estiver pronto para começar a construir seu arquivo CSV, consulte as informações a seguir:

• user attributes
• custom events

Etapa 4: Fazer upload do seu arquivo

Para fazer upload do seu arquivo, selecione Attributes ou Events, clique em Browse Files e faça upload do seu CSV. A Braze exibe uma prévia das primeiras linhas e um resumo dos campos detectados.

No campo Import name, você pode renomear sua importação. Por padrão, o nome do arquivo é usado.

Etapa 5: Valide seu arquivo (opcional)

Antes de iniciar sua importação, você pode executar a validação do arquivo para verificar cada linha em busca de erros e avisos. Para validar seu arquivo, selecione Validate file before importing e clique em Start import.

A validação pode levar até 2 minutos para arquivos no tamanho máximo permitido. Enquanto a validação é executada, você pode selecionar Skip validation para ignorá-la e prosseguir imediatamente.

Resultados da validação

Quando a validação é concluída, um dos seguintes resultados aparece.

Entendendo o relatório de erros

O relatório de erros é um arquivo CSV que contém cada linha sinalizada junto com seus dados originais e uma descrição do problema.

Após revisar o relatório, você pode corrigir os problemas no seu arquivo original e fazer o upload novamente, ou prosseguir com a importação e aceitar os resultados parciais.

Etapa 6: Escolha as preferências de direcionamento

Você também pode escolher entre as seguintes preferências de direcionamento. Se não precisar criar um novo filtro ou segmento de direcionamento a partir da sua importação, selecione Do not make this list available as a targeting filter.

Etapa 7: Inicie sua importação de CSV

Quando estiver pronto, selecione Start import. Você pode acompanhar o progresso atual na página Import Users, que atualiza automaticamente a cada 5 segundos.

Status da importação

Após iniciar sua importação, você pode verificar o status na página Import Users.

O relatório de erros pós-importação inclui linhas que falharam por razões que a validação não cobre, como quando um usuário não existe na Braze.

Considerações sobre pontos de dados

Cada dado de cliente importado de um arquivo CSV sobrescreve o valor existente nos perfis de usuário e registra um ponto de dados, exceto para IDs externos e valores em branco. Se você tiver dúvidas sobre as nuances dos pontos de dados da Braze, seu gerente de conta da Braze pode esclarecê-las.

Solução de problemas

Se você usou a validação de arquivo, comece pelo relatório de erros — ele inclui o problema específico de cada linha sinalizada e uma descrição de como corrigi-lo. Para linhas que falharam durante a importação (e não na validação), baixe o relatório de erros passando o cursor sobre a linha e selecionando o botão na página Import Users.

Para solucionar problemas na importação de CSV, revise os problemas comuns abaixo.

Problemas de formatação de arquivo

Linha malformada

Se seu upload foi concluído com erros, pode haver uma linha malformada no seu arquivo CSV.

Para importar dados corretamente, deve haver uma linha de cabeçalho. Cada linha deve ter o mesmo número de células que a linha de cabeçalho. Linhas com mais ou menos valores do que a linha de cabeçalho serão excluídas da importação. Vírgulas dentro de um valor serão interpretadas como separador e podem causar esse erro. Além disso, todos os dados devem ser codificados em UTF-8.

Se seu arquivo CSV tem linhas em branco e importa menos linhas do que o total de linhas no arquivo CSV, isso pode não indicar um problema com a importação, já que as linhas em branco não precisariam ser importadas. Verifique o número de linhas que foram importadas corretamente e certifique-se de que corresponde ao número de usuários que você está tentando importar.

Linha ausente

Há algumas razões pelas quais o número de usuários importados pode não corresponder ao total de linhas no seu arquivo CSV:

Strings com aspas

Valores encapsulados entre aspas simples ('') ou duplas ("") serão lidos como strings na importação.

Datas formatadas incorretamente

Datas que não estiverem no formato ISO-8601 não serão lidas como datetimes na importação.

Problemas na estrutura de dados

Endereços de e-mail inválidos

Se o seu upload foi concluído com erros, pode haver um ou mais endereços de e-mail criptografados inválidos. Confirme que todos os endereços de e-mail estão criptografados corretamente antes de importá-los para a Braze.

• Ao atualizar ou importar endereços de e-mail na Braze, use o valor de e-mail com hash sempre que um e-mail for incluído. Esses valores de e-mail com hash são fornecidos pela sua equipe interna.
• Ao criar um novo usuário, você deve adicionar email_encrypted com o valor de e-mail criptografado do usuário. Caso contrário, a Braze não criará o usuário. Da mesma forma, se você estiver adicionando um endereço de e-mail a um usuário existente que não tem um e-mail, deve adicionar email_encrypted. Caso contrário, a Braze não atualizará o usuário.

Dados importados como atributo personalizado

Se um dado padrão de usuário (como email ou first_name) for importado como atributo personalizado, verifique as letras maiúsculas/minúsculas e o espaçamento do arquivo CSV. Por exemplo, First_name é importado como atributo personalizado, enquanto first_name é corretamente importado no campo “nome” do perfil do usuário.

Alterar o tipo de dados de um atributo personalizado

Se você precisar alterar o tipo de dados de um atributo personalizado existente (por exemplo, de string para booleano), atualize o tipo de dados na página Atributos personalizados no dashboard antes de importar seu CSV. Se o tipo de dados no seu CSV não corresponder ao tipo de dados atualmente definido do atributo, a importação falhará com um erro.

Múltiplos tipos de dados

A Braze espera que cada valor em uma coluna seja do mesmo tipo de dados. Valores que não correspondem ao tipo de dados do atributo causam erros na segmentação.

Além disso, iniciar um atributo numérico com zero causará problemas, pois números que começam com zero são considerados strings. Quando a Braze converte essa string, ela pode ser tratada como um valor octal (que usa dígitos de zero a sete), o que significa que é convertida para seu valor decimal correspondente. Por exemplo, se o valor no arquivo CSV for 0130, o perfil da Braze mostrará 88. Para evitar esse problema, use atributos com tipo de dados string. No entanto, esse tipo de dados não está disponível na comparação numérica de segmentação.

Tipos de atributos padrão

Alguns atributos padrão podem aceitar apenas certos valores como válidos para atualizações de usuários. Para orientação, consulte Construindo seu arquivo CSV.

Espaços no final e diferenças na capitalização podem fazer com que um valor seja interpretado como inválido. Por exemplo, no seguinte arquivo CSV, apenas o usuário na primeira linha (brazetest1) teve seus status de e-mail e push atualizados com sucesso, porque os valores aceitos são unsubscribed, subscribed e opted_in.

1
2
3
external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

“Selecionar arquivo CSV” não está funcionando

Existem várias razões pelas quais o botão Selecionar arquivo CSV pode não funcionar: