importação de CSV

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

Sobre a importação CSV

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

Usando a importação CSV

Etapa 1: Baixar um modelo CSV

Para abrir a importação CSV, acesse Audiências > Importar Usuários. Aqui, você encontrará uma tabela que lista detalhes sobre as importações mais recentes, como a data de upload, nome do uploader, 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 do Usuário: Isso inclui tanto atributos de usuário padrão quanto personalizados. Atributos de usuário padrão são chaves reservadas no Braze (como first_name ou email) e atributos personalizados são atributos de usuário únicos para o seu negócio (como last_destination_searched).
• Eventos Personalizados: Estes são únicos para o seu negócio e refletem ações que um usuário realizou, como trip_booked para um aplicativo de reserva de viagens.

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

• user attributes
• custom events

Etapa 4: Fazer upload do seu arquivo

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

No campo Nome da importação, 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 Validar arquivo antes de importar, em seguida, clique em Iniciar importação.

A validação pode levar até 2 minutos para arquivos no tamanho máximo permitido. Enquanto a validação é executada, você pode selecionar Ignorar validação 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 em 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 você não precisar criar um novo filtro ou segmento de direcionamento a partir da sua importação, selecione Não tornar esta lista disponível como um filtro de direcionamento.

Etapa 7: Inicie sua importação de CSV

Quando estiver pronto, clique em Iniciar importação. Você pode acompanhar o progresso atual na página Importar Usuários, que atualiza automaticamente a cada 5 segundos.

Status da importação

Após iniciar sua importação, você pode verificar seu status na página Importar Usuários.

O relatório de erro 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 no 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 alguma dúvida sobre as nuances dos pontos de dados do Braze, seu gerente de conta do Braze pode respondê-las.

Solução de problemas

Se você usou validação de arquivo, comece com o relatório de erros—ele inclui o problema específico para cada linha sinalizada e uma descrição de como corrigi-lo. Para linhas que falharam durante a importação em vez da validação, baixe o relatório de erros no menu de três pontos na página Importar Usuários.

Se você está tendo problemas com a importação de CSV, revise esses problemas comuns abaixo. Ainda precisa de ajuda? Entre em contato com [email protected].

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 um comprimento de mais ou menos valores do que a linha de cabeçalho serão excluídas da importação. As vírgulas em um valor serão interpretadas como um separador e podem levar a 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:

String com aspas

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

Datas formatadas incorretamente

As 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 o Braze.

• **Quando atualizando ou importando endereços de e-mail<1> no Braze, use o valor de e-mail hash sempre que um e-mail for incluído. Esses valores de e-mail 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, o 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, você deve adicionar email_encrypted. Caso contrário, o Braze não atualizará o usuário.

Dados importados como atributo personalizado

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

Múltiplos tipos de dados

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

Além disso, começar um atributo numérico com zero causará problemas, pois números que começam com zeros são considerados strings. Quando o 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 do Braze mostrará 88. Para evitar esse problema, use atributos com tipos de dados string. No entanto, esse tipo de dado não está disponível na comparação de números 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 em branco 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 e-mails e status de 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: