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 quais dados estão incluídos na exportação.
Pré-requisitos
Para exportar dados de Segment para um CSV, você precisa da permissão “Export User Data” no seu espaço de trabalho.
Solicitar uma exportação CSV
Para exportar dados de Segment para um CSV, selecione o menu suspenso Dados do usuário enquanto edita um Segment. Em seguida, escolha exportar os dados de usuários ou os endereços de e-mail desse Segment.
Você também pode solicitar uma exportação CSV na página principal de Segments. Para isso, selecione o menu suspenso Configurações de um Segment:
Para exportar dados de todos os seus perfis de usuário, crie um Segment sem filtros e, em seguida, solicite uma exportação CSV.
O arquivo CSV contém os dados de cada perfil de usuário incluído no Segment no momento da exportação. Você pode exportar qualquer Segment selecionando o ícone de engrenagem e a opção de exportação CSV. A Braze gera o relatório em segundo plano e o envia por e-mail ao usuário que estiver conectado no momento.
Detalhes da exportação de Segment em CSV
CSV Export Email Addresses inclui apenas linhas para os usuários do Segment que têm endereço de e-mail. Por exemplo, se o seu Segment tiver 100.000 usuários, mas apenas 50.000 tiverem endereço de e-mail, CSV Export Email Addresses vai gerar cerca de 50.000 linhas. Já CSV Export User Data exporta todos os dados de usuários do Segment.
Por causa das restrições de tamanho de arquivo, a 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 Segment, e não o cálculo exato. Para saber mais, consulte Exportação de segmentos grandes.
Se você tiver vinculado 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. É preciso 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, de acordo com a sua seleção.
Dados de usuários da exportação de CSV
| 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 usado para criar o perfil de usuário (por exemplo, REST API, SDK ou importação de CSV) |
| devices | Informações do dispositivo |
| date_of_birth | Data de nascimento |
| Endereço de e-mail | |
| unsubscribed_from_emails_at | Data de cancelamento da inscrição em 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 do identificador de publicidade (IDFA) |
| IDFVs | Valores do identificador do fornecedor (IDFV) |
| language | Idioma no padrão ISO-639-1 |
| last_app_version_used | Última versão do app usada |
| last_name | Sobrenome |
| last_session | Data e hora da última sessão |
| number_of_google_ad_ids | Quantidade de IDs de publicidade do Google associados |
| number_of_IDFAs | Quantidade de IDFAs associados |
| number_of_IDFVs | Quantidade de IDFVs associados |
| number_of_push_tokens | Quantidade de tokens de notificação por push associados |
| number_of_roku_ad_ids | Quantidade de IDs de publicidade da Roku associados |
| number_of_windows_ad_ids | Quantidade de IDs de publicidade do Windows associados |
| phone_number | Número de telefone |
| opted_into_push_at | Data de aceitação das notificações por push |
| unsubscribed_from_push_at | Data de cancelamento da inscrição em notificações por push |
| random_bucket | Número de bucket aleatório |
| roku_ad_ids | IDs de publicidade da 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 da IANA |
| in_app_purchase_total | Valor total gasto em compras no app |
| user_aliases | Aliases de usuário, se houver |
| windows_ad_ids | IDs de publicidade do Windows |
| Eventos personalizados | Com base na seleção feita na exportação |
| Atributos personalizados | Com base na seleção feita na exportação |
Quando você exporta dados de usuários de uma etapa do Canvas, o CSV inclui todos os usuários que passaram por essa etapa durante todo o tempo de vida da etapa do Canvas. Não é possível limitar a exportação a um intervalo de datas ou outro período. Para saber como executar essas exportações, consulte Exportar dados do Canvas.
Endereços de e-mail da exportação de CSV
| 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 da inscrição em e-mails |
| opted_in_to_emails_at | Data de aceitação de e-mails |
| user_aliases | Aliases de usuário, se houver |
Os dados de grupos de inscrições não estão disponíveis nas exportações de segmentos. Para identificar usuários pelo status de inscrição, crie um segmento separado com base na participação em grupos de inscrições e exporte esse segmento.
Exportação de Segments grandes
Há vários métodos para exportar um Segment grande com mais de 500.000 usuários.
Você pode dividir um Segment grande em Segments menores e depois exportar cada um deles da Braze.
Você também pode usar números de bucket aleatórios para dividir sua base de usuários em vários Segments e depois combiná-los após a exportação. Por exemplo, para dividir seu Segment em dois Segments diferentes, use os seguintes filtros:
- Segment 1: Número de bucket aleatório é menor que 5000 (inclui 0-4999)
- Segment 2: Número de bucket aleatório é maior que 4999 (inclui 5000-9999)
Você também pode usar os endpoints a seguir para exportar dados de usuários de um Segment específico. Esses endpoints estão sujeitos a limites de dados e limites de frequência.
Se você conectou credenciais do Amazon S3, as exportações grandes podem ser entregues no seu bucket, além do link de download enviado por e-mail, conforme descrito em Detalhes da exportação de CSV do Segment.