Importação de CSV

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

Sobre a importação de CSV

Você pode 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: Faça o download de um modelo CSV

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

Para começar a criar seu CSV, faça o download de um modelo para atributos ou eventos.

A página “Importar usuários” no painel de controle do Braze.](/docs/pt-br/assets/img/csv_import/import_users_page.png?0df1987be02a12967c97903c8182d403)

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 carregar qualquer um dos seguintes tipos de dados como um único arquivo CSV. Para carregar mais de um tipo de dados, carregue vários arquivos CSV.

• Atributos 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 aplicativo 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 visualize seus dados

Antes de o Braze processar seu CSV, ele gerará uma visualização das primeiras linhas para que você possa verificar se há algum problema. Para gerar sua visualização, escolha Attributes (Atributos ) ou Events (Eventos), selecione Browse Files (Procurar arquivos) e carregue seu CSV.

!Upload de CSV concluído com erros envolvendo tipos de dados mistos em uma única coluna

Etapa 5: Escolha as preferências de segmentação

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

!Um grupo de filtros com o filtro “Updated/Imported from CSV” (Atualizado/Importado de CSV), incluindo um arquivo CSV intitulado “Halloween season fun” (Diversão na temporada de Halloween).

Etapa 6: Iniciar sua importação de CSV

Quando estiver pronto, selecione Iniciar importação. Você pode acompanhar o progresso atual na página User Import, 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 os 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 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 do cabeçalho. As linhas com um comprimento de mais ou menos valores do que a linha do 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 ele corresponde ao número de usuários que você está tentando importar.

Linha ausente

Há alguns motivos pelos quais o número de usuários importados pode não corresponder ao total de linhas no seu arquivo CSV:

Cotação de strings

Os valores encapsulados entre aspas simples ('') ou duplas ("") serão lidos como cadeias de caracteres 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 upload for 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 um endereço 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 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 você estiver adicionando um endereço de e-mail a um usuário existente que não tenha um e-mail, deverá 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 do usuário (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 importado corretamente para o campo “primeiro nome” no perfil de um usuário.

Vários tipos de dados

O Braze espera que cada valor em uma coluna seja do mesmo tipo de dados. Os valores que não corresponderem ao tipo de dados do atributo causarão erros na segmentação.

Além disso, iniciar um atributo numérico com zero causará problemas porque os números que começam com zeros são considerados cadeias de caracteres. 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 Braze mostrará 88. Para evitar esse problema, use atributos com tipos de dados de cadeia de caracteres. No entanto, esse tipo de dados 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 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: