Exportar dados do Segment para CSV
Esta página aborda como solicitar uma exportação CSV de dados de usuários de um Segment e os dados incluídos na exportação.
As opções de exportação CSV aparecem no menu suspenso User Data apenas para usuários da empresa que possuem a permissão “Export User Data” para esse espaço de trabalho.
Para exportar dados de Segment para um CSV, selecione o menu suspenso User Data ao editar um Segment e selecione exportar os dados do usuário ou os endereços de e-mail do Segment.
Você também pode solicitar uma exportação CSV na página principal de Segments, selecionando o menu suspenso Settings de um Segment:
Para exportar dados de todos os seus perfis de usuários, crie um Segment sem filtros e solicite uma exportação CSV.
A saída CSV contém os dados de cada perfil de usuário capturado no Segment no momento da exportação. Você pode exportar qualquer Segment selecionando o ícone de engrenagem e a exportação CSV. A Braze gerará o relatório em segundo plano e o enviará por e-mail para o usuário que estiver conectado no momento.
Detalhes da exportação CSV de Segments
Os usuários do dashboard precisam da permissão Exportar dados de usuários para usar as opções de exportação CSV. Se não tiverem essa permissão, as opções de exportação CSV não aparecerão.
CSV Export Email Addresses inclui apenas linhas de usuários no Segment que possuem um endereço de e-mail. Por exemplo, se o seu Segment tem 100.000 usuários, mas apenas 50.000 possuem um endereço de e-mail, CSV Export Email Addresses produz cerca de 50.000 linhas. CSV Export User Data exporta todos os dados de usuários do Segment.
Devido a restrições de tamanho de arquivo, sua exportação pode falhar se o tamanho estimado do seu Segment for superior a 500.000 usuários. Essa restrição usa o tamanho estimado do seu Segment, e não o cálculo exato. Para mais detalhes, consulte Exportando Segments grandes.
Se você vinculou suas credenciais do Amazon S3 à Braze, o CSV será enviado para o seu bucket S3 com a chave segment-export/SEGMENT_ID/YYYY-MM-dd/users-RANDOMSTRING.zip. Você precisa estar conectado ao dashboard para acessar o link de download enviado por e-mail.
Os arquivos exportados armazenados em buckets S3 são automaticamente excluídos após o link de download expirar (quatro horas a partir do envio do e-mail de exportação, a menos que indicado de outra forma).
Dados incluídos na exportação
Os dados a seguir são incluídos na sua exportação, dependendo da sua seleção.
Exportação CSV de dados de usuários
| Nome do campo | Descrição |
|---|---|
| Appboy ID | ID interno (não pode ser alterado) |
| country | País |
| created_at | Data e hora em que o perfil de usuário foi criado |
| created_from | Método utilizado para criar o perfil de usuário (por exemplo, REST API, SDK ou importação CSV) |
| devices | Informações do dispositivo |
| date_of_birth | Data de nascimento |
| Endereço de e-mail | |
| unsubscribed_from_emails_at | Data de cancelamento de inscrição de e-mails |
| user_id | ID externo |
| first_name | Nome |
| first_session | Data e hora da primeira sessão |
| gender | Gênero |
| google_ad_ids | IDs de publicidade do Google associados ao usuário |
| city | Cidade |
| IDFAs | Valores de Identificador para Publicidade (IDFA) |
| IDFVs | Valores de Identificador para Fornecedor (IDFV) |
| language | Idioma no padrão ISO-639-1 |
| last_app_version_used | Última versão do app utilizada |
| last_name | Sobrenome |
| last_session | Data e hora da última sessão |
| number_of_google_ad_ids | Contagem de IDs de publicidade do Google associados |
| number_of_IDFAs | Contagem de IDFAs associados |
| number_of_IDFVs | Contagem de IDFVs associados |
| number_of_push_tokens | Contagem de tokens de notificação por push associados |
| number_of_roku_ad_ids | Contagem de IDs de publicidade Roku associados |
| number_of_windows_ad_ids | Contagem de IDs de publicidade Windows associados |
| phone_number | Número de telefone |
| opted_into_push_at | Data de aceitação de notificações por push |
| unsubscribed_from_push_at | Data de cancelamento de inscrição de notificações por push |
| random_bucket | Número de bucket aleatório |
| roku_ad_ids | IDs de publicidade Roku |
| session_count | Número total de sessões |
| timezone | Fuso horário do usuário no mesmo formato do Banco de Dados de Fusos Horários IANA |
| in_app_purchase_total | Valor total gasto em compras no app |
| user_aliases | Aliases do usuário, se houver |
| windows_ad_ids | IDs de publicidade Windows |
| Custom events | Com base na seleção na exportação |
| Custom attributes | Com base na seleção na exportação |
Ao exportar dados de usuários de uma etapa do Canvas, o CSV inclui todos os usuários que passaram por essa etapa durante toda a vida útil da etapa do Canvas. Não é possível limitar a exportação a um intervalo de datas ou outra janela de tempo. Para saber como executar essas exportações, consulte Exportar dados do Canvas.
Exportação CSV de endereços de e-mail
| Nome do campo | Descrição |
|---|---|
| user_id | ID externo do usuário |
| first_name | Nome |
| last_name | Sobrenome |
| unsubscribed_from_emails_at | Data de cancelamento de inscrição de e-mail |
| opted_in_to_emails_at | Data de aceitação de e-mail |
| user_aliases | Aliases do usuário, se houver |
Os dados de grupo de inscrições não estão disponíveis por meio de exportações de Segments. Para identificar usuários por status de inscrição, crie um Segment separado com base na associação ao grupo de inscrições e exporte esse Segment.
Exportando Segments grandes
Existem vários métodos para exportar um Segment grande que contenha mais de 500.000 usuários.
Você pode dividir um Segment grande em Segments menores e depois exportar cada um dos Segments menores da Braze.
Você também pode usar números de bucket aleatórios para dividir sua base de usuários em múltiplos Segments e depois combiná-los após a exportação. Por exemplo, se você precisar dividir seu Segment em dois Segments diferentes, pode fazer isso com os seguintes filtros:
- Segment 1: O número de bucket aleatório é menor que 5000 (inclui 0-4999)
- Segment 2: O número de bucket aleatório é maior que 4999 (inclui 5000-9999)
Você também pode alavancar os seguintes endpoints para exportar dados de usuários de um Segment específico. Note que esses endpoints estão sujeitos a limites de dados e limites de frequência.
Se você conectou credenciais do Amazon S3, exportações grandes podem ser entregues ao seu bucket, além do link de download enviado por e-mail, conforme descrito em Detalhes da exportação CSV de Segment.