importação de CSV

Saiba como registrar e atualizar atributos de usuários e eventos personalizados usando a importação de CSV.

Sobre a importação de CSV

É possível usar a importação de CSV para registrar e atualizar os seguintes atributos de usuário e eventos personalizados.

Usando a importação de CSV

Etapa 1: Baixe um modelo CSV

Para abrir a importação de CSV, vá para Públicos > Importar usuários. Aqui, você encontrará uma tabela que lista detalhes sobre as importações mais recentes, como a data do upload, o nome do responsável pelo upload, o nome do arquivo, a disponibilidade do direcionamento, o número de linhas importadas e o status da importação.

Para começar a criar seu CSV, baixe um modelo para atribuições ou eventos.

Etapa 2: Escolha um identificador

O CSV que você importar precisará de um identificador dedicado. Você pode escolher entre as seguintes opções:

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

Etapa 3: Crie 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 dados, faça upload de vários arquivos CSV.

• Atribuições do usuário: Isso inclui atributos de usuário padrão e personalizados. Os atributos de usuário padrão são chaves reservadas no Braze (como first_name ou email) e os atributos personalizados são atributos de usuário exclusivos da sua empresa (como last_destination_searched).
• Eventos personalizados: Eles são exclusivos da sua empresa e refletem as ações realizadas por um usuário, como trip_booked para um app de reserva de viagens.

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

• user attributes
• custom events

Etapa 4: Faça upload e prévia de seus dados

Antes de o Braze processar seu CSV, ele gerará uma prévia das primeiras linhas para que você possa verificar se há algum problema. Para gerar sua prévia, escolha Attributes (Atribuições ) ou Events (Eventos), selecione Browse Files (Procurar arquivos) e faça upload do CSV.

Etapa 5: Escolha as preferências de direcionamento

Você também pode escolher entre as seguintes preferências de direcionamento. Se não for necessário criar um novo filtro ou segmento de direcionamento a partir de sua importação, selecione Não disponibilizar essa lista como filtro de direcionamento.

Etapa 6: Iniciar sua importação de CSV

Quando estiver pronto, selecione Iniciar importação. É possível rastrear o progresso atual na página Importação de usuário, que é atualizada automaticamente a cada cinco segundos.

Se não houver problemas, o status será atualizado para Complete e o número de linhas processadas será exibido. Todos os dados das linhas processadas serão adicionados aos perfis existentes ou aos perfis recém-criados.

Considerações sobre pontos de dados

Cada dado de cliente importado de um arquivo CSV substituirá o valor existente nos perfis de usuário e registrará 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 Braze, seu gerente de conta Braze poderá respondê-la.

Solução de problemas

Analise esses problemas comuns se estiver tendo problemas com a importação de CSV. Ainda precisa de ajuda? Entre em contato com o [email protected].

Problemas de formatação de arquivos

Linha malformada

Se o seu upload foi concluído com erros, pode haver uma linha malformada em 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 o seu arquivo CSV tiver linhas em branco e importar menos linhas do que o total de linhas no arquivo CSV, isso pode não indicar um problema com a importação, pois 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 de 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 se todos os endereços de e-mail estão criptografados corretamente antes de importá-los para o Braze.

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

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 seria importado como um atributo personalizado, enquanto first_name seria corretamente importado no campo “first name” 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. Os valores que não corresponderem ao tipo de dados do atributo causarão erros na segmentação.

Além disso, iniciar uma atribuição numérica com zero causará problemas porque os 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 será convertida em 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 atribuições com tipos de dados string. No entanto, esse tipo de dados não está disponível na comparação de números de segmentação.

Tipos de atribuição padrão

Algumas atribuições padrão podem aceitar apenas determinados valores como válidos para atualizações de usuários. Para obter orientação, consulte Construção de seu CSV.

Espaços finais e diferenças na capitalização podem fazer com que um valor seja interpretado como inválido. Por exemplo, no arquivo CSV a seguir, somente o usuário da primeira linha (brazetest1) terá seus status de e-mail e push atualizados com êxito 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

“Select CSV File” (Selecionar arquivo CSV) não está funcionando

Há vários motivos pelos quais o botão Selecionar arquivo CSV pode não funcionar: