Exportar datos de Segment a CSV
Esta página explica cómo solicitar una exportación CSV de los datos de usuario de un Segment y qué datos incluye la exportación.
Requisitos previos
Para exportar datos de Segment a un CSV, necesitas el permiso “Exportar datos de usuario” para tu espacio de trabajo.
Solicitar una exportación CSV
Para exportar datos de Segment a un CSV, selecciona el desplegable Datos de usuario mientras editas un Segment y elige exportar los datos de usuario o las direcciones de correo electrónico del Segment.
También puedes solicitar una exportación CSV desde la página principal de Segments seleccionando el desplegable Configuración de un Segment:
Para exportar datos de todos tus perfiles de usuario, crea un Segment sin filtros y, a continuación, solicita una exportación CSV.
La salida CSV contiene los datos de cada perfil de usuario capturado en el Segment en el momento de la exportación. Puedes exportar cualquier Segment seleccionando el icono de engranaje y la exportación CSV. Braze generará el informe en segundo plano y lo enviará por correo electrónico al usuario que tenga la sesión iniciada en ese momento.
Detalles de la exportación CSV de Segment
Exportar direcciones de correo electrónico en CSV solo incluye filas de los usuarios del Segment que tienen una dirección de correo electrónico. Por ejemplo, si tu Segment tiene 100 000 usuarios, pero solo 50 000 tienen una dirección de correo electrónico, Exportar direcciones de correo electrónico en CSV genera unas 50 000 filas. Exportar datos de usuario en CSV exporta todos los datos de usuario del Segment.
Debido a las restricciones de tamaño de archivo, tu exportación puede fallar si el tamaño estimado de tu Segment supera los 500 000 usuarios. Ten en cuenta que esta restricción usa el tamaño estimado de tu Segment, no el cálculo exacto. Para más información, consulta Exportar Segments grandes.
Si has vinculado tus credenciales de S3 de Amazon a Braze, el CSV se cargará en tu contenedor de S3 con la clave segment-export/SEGMENT_ID/YYYY-MM-dd/users-RANDOMSTRING.zip. Debes haber iniciado sesión en el panel para acceder al enlace de descarga que recibirás por correo electrónico.
Los archivos de exportación almacenados en los contenedores de S3 se eliminan automáticamente una vez que caduca el enlace de descarga (cuatro horas después del envío del correo electrónico de exportación, a menos que se indique lo contrario).
Datos incluidos en la exportación
Lo siguiente se incluye en tu exportación en función de lo que selecciones.
Datos de usuario de la exportación CSV
| Nombre del campo | Descripción |
|---|---|
| Appboy ID | ID interno (no se puede cambiar) |
| country | País |
| created_at | Fecha y hora en que se creó el perfil de usuario |
| created_from | Método utilizado para crear el perfil de usuario (por ejemplo, REST API, SDK o importación CSV) |
| devices | Información del dispositivo |
| date_of_birth | Fecha de nacimiento |
| Dirección de correo electrónico | |
| unsubscribed_from_emails_at | Fecha de cancelación de la suscripción a correos electrónicos |
| user_id | ID externo |
| first_name | Nombre |
| first_session | Fecha y hora de la primera sesión |
| gender | Género |
| google_ad_ids | ID de publicidad de Google asociados al usuario |
| city | Ciudad |
| IDFAs | Valores del identificador para publicidad (IDFA) |
| IDFVs | Valores del identificador para proveedores (IDFV) |
| language | Idioma según el estándar ISO-639-1 |
| last_app_version_used | Última versión de la aplicación utilizada |
| last_name | Apellido |
| last_session | Fecha y hora de la última sesión |
| number_of_google_ad_ids | Número de ID de publicidad de Google asociados |
| number_of_IDFAs | Número de IDFA asociados |
| number_of_IDFVs | Número de IDFV asociados |
| number_of_push_tokens | Número de tokens de notificaciones push asociados |
| number_of_roku_ad_ids | Número de ID de publicidad de Roku asociados |
| number_of_windows_ad_ids | Número de ID de publicidad de Windows asociados |
| phone_number | Número de teléfono |
| opted_into_push_at | Fecha de adhesión voluntaria a las notificaciones push |
| unsubscribed_from_push_at | Fecha de cancelación de la suscripción a las notificaciones push |
| random_bucket | Número de contenedor aleatorio |
| roku_ad_ids | ID de publicidad de Roku |
| session_count | Número total de sesiones |
| timezone | Zona horaria del usuario en el mismo formato que la base de datos de zonas horarias de la IANA |
| in_app_purchase_total | Importe total gastado en compras dentro de la aplicación |
| user_aliases | Alias de usuario, si los hay |
| windows_ad_ids | ID de publicidad de Windows |
| Eventos personalizados | En función de la selección al exportar |
| Atributos personalizados | En función de la selección al exportar |
Cuando exportas datos de usuario desde un paso en Canvas, el CSV incluye a todos los usuarios que han estado en ese paso durante toda la vida útil del paso en Canvas. No puedes limitar la exportación a un intervalo de fechas ni a otro periodo de tiempo. Para saber cómo realizar estas exportaciones, consulta Exportar datos de Canvas.
Direcciones de correo electrónico de la exportación CSV
| Nombre del campo | Descripción |
|---|---|
| user_id | ID externo del usuario |
| first_name | Nombre |
| last_name | Apellido |
| Correo electrónico | |
| unsubscribed_from_emails_at | Fecha de cancelación de la suscripción al correo electrónico |
| opted_in_to_emails_at | Fecha de adhesión voluntaria al correo electrónico |
| user_aliases | Alias de usuario, si los hay |
Si necesitas ayuda con las exportaciones CSV y de API, consulta nuestro artículo de solución de problemas.
Los datos de grupos de suscripción no están disponibles mediante las exportaciones de Segment. Para identificar a los usuarios por su estado de suscripción, crea un Segment independiente basado en la pertenencia al grupo de suscripción y exporta ese Segment.
Exportar Segments grandes
Hay varios métodos para exportar un Segment de usuarios grande que contenga más de 500 000 usuarios.
Puedes dividir un Segment grande en Segments más pequeños y luego exportar cada uno de ellos desde Braze.
También puedes usar números de contenedor aleatorios para dividir tu base de usuarios en varios Segments y luego combinarlos después de la exportación. Por ejemplo, si necesitas dividir tu Segment en dos Segments diferentes, puedes hacerlo con los siguientes filtros:
- Segment 1: El número de contenedor aleatorio es menor que 5000 (incluye 0-4999)
- Segment 2: El número de contenedor aleatorio es mayor que 4999 (incluye 5000-9999)
También puedes aprovechar los siguientes endpoints para exportar datos de usuario de un Segment específico. Ten en cuenta que estos endpoints están sujetos a límites de datos y límites de velocidad.
Si has conectado credenciales de Amazon S3, las exportaciones grandes pueden entregarse en tu contenedor además del enlace de descarga enviado por correo electrónico, como se describe en Detalles de la exportación CSV de Segment.