Importación CSV

Aprende a registrar y actualizar atributos de usuario y eventos personalizados mediante la importación de CSV.

Acerca de la importación de CSV

Puedes utilizar la importación CSV para registrar y actualizar los siguientes atributos de usuario y eventos personalizados.

Usar la importación CSV

Paso 1: Descargar una plantilla CSV

Para abrir la importación de usuarios en CSV, ve a Audiencias > Importar usuarios. Aquí encontrarás una tabla con información detallada sobre las importaciones más recientes, como la fecha de carga, el nombre del usuario que la subió, el nombre del archivo, la disponibilidad de segmentación, el número de filas importadas y el estado de la importación.

Para empezar con tu CSV, descarga una plantilla para atributos o eventos.

Paso 2: Elige un identificador

El archivo CSV que importes necesitará un identificador específico. Puedes elegir entre las siguientes opciones:

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

Paso 3: Crea tu archivo CSV

Puedes cargar cualquiera de los siguientes tipos de datos en un único archivo CSV. Para cargar más de un tipo de datos, carga varios archivos CSV.

• Atributos de usuario: Esto incluye tanto los atributos predeterminados como los personalizados del usuario. Los atributos de usuario predeterminados son claves reservadas en Braze (como first_name o email) y los atributos personalizados son atributos de usuario únicos de tu empresa (como last_destination_searched).
• Eventos personalizados: Son únicos de tu negocio y reflejan las acciones que ha realizado un usuario, como trip_booked en el caso de una aplicación de reservas de viajes.

Cuando estés listo para empezar a crear tu archivo CSV, consulta la siguiente información:

• user attributes
• custom events

Paso 4: Sube tu archivo

Para cargar tu archivo, selecciona Atributos o Eventos, haz clic en Examinar archivos y carga tu CSV. Braze muestra una vista previa de las primeras filas y un resumen de los campos detectados.

En el campo Nombre de la importación, puedes cambiar el nombre de la importación. De forma predeterminada, se utiliza el nombre del archivo.

Paso 5: Valida tu archivo (opcional)

Antes de iniciar la importación, puedes ejecutar la validación de archivos para comprobar si hay errores y advertencias en cada fila. Para validar tu archivo, selecciona Validar archivo antes de importar y, a continuación, haz clic en Iniciar importación.

La validación puede tardar hasta 2 minutos para los archivos con el tamaño máximo permitido. Mientras se ejecuta la validación, puedes seleccionar Omitir validación para saltártela y continuar inmediatamente.

Resultados de la validación

Cuando finaliza la validación, aparece uno de los siguientes resultados.

Comprender el informe de errores

El informe de errores es un archivo CSV que contiene todas las filas marcadas junto con sus datos originales y una descripción del problema.

Después de revisar el informe, puedes corregir los problemas en tu archivo original y volver a subirlo, o continuar con la importación y aceptar los resultados parciales.

Paso 6: Elige tus preferencias de segmentación

También puedes elegir entre las siguientes preferencias de segmentación. Si no necesitas crear un nuevo filtro de segmentación o segmento a partir de tu importación, selecciona No hacer que esta lista esté disponible como filtro de segmentación.

Paso 7: Inicia la importación de CSV

Cuando estés listo, selecciona Iniciar importación. Puedes hacer seguimiento del progreso actual en la página Importar usuarios, que se actualiza automáticamente cada 5 segundos.

Estados de importación

Una vez iniciada la importación, puedes comprobar su estado en la página Importar usuarios.

El informe de errores posterior a la importación incluye filas que fallaron por motivos que la validación no cubre, como cuando un usuario no existe en Braze.

Consideraciones sobre los puntos de datos

Cada dato de cliente importado desde un archivo CSV sobrescribe el valor existente en los perfiles de usuario y registra un punto de datos, excepto en el caso de los ID externos y los valores en blanco. Si tienes alguna pregunta sobre los matices de los puntos de datos de Braze, tu director de cuentas de Braze puede responderla.

Solución de problemas

Si utilizaste la validación de archivos, comienza por el informe de errores, que incluye el problema específico de cada fila marcada y una descripción de cómo solucionarlo. Para las filas que fallaron durante la importación en lugar de la validación, descarga el informe de errores pasando el cursor sobre la fila y seleccionando el botón en la página Importar usuarios.

Si tienes problemas con la importación de CSV, revisa estos problemas comunes a continuación.

Problemas con el formato de los archivos

Fila malformada

Si la carga se completó con errores, es posible que haya una fila mal formada en tu archivo CSV.

Para importar datos correctamente, debe haber una fila de encabezado. Cada fila debe tener el mismo número de celdas que la fila de encabezado. Las filas con más o menos valores que la fila de encabezado se excluirán de la importación. Las comas en un valor se interpretarán como un separador y pueden provocar este error. Además, todos los datos deben estar codificados en UTF-8.

Si tu archivo CSV tiene filas en blanco e importas menos filas que el total de líneas del archivo CSV, esto puede no indicar un problema con la importación, ya que las filas en blanco no necesitarían importarse. Comprueba el número de líneas que se importaron correctamente y asegúrate de que coincide con el número de usuarios que estás intentando importar.

Falta una fila

Existen varias razones por las que el número de usuarios importados puede no coincidir con el total de filas de tu archivo CSV:

Entrecomillado de cadenas

Los valores entre comillas simples ('') o dobles ("") se leerán como cadenas en la importación.

Fechas con formato incorrecto

Las fechas que no estén en formato ISO-8601 no se leerán como datetimes en la importación.

Problemas con la estructura de datos

Direcciones de correo electrónico no válidas

Si la carga se completó con errores, es posible que haya una o varias direcciones de correo electrónico cifradas no válidas. Confirma que todas las direcciones de correo electrónico estén cifradas correctamente antes de importarlas a Braze.

• Al actualizar o importar direcciones de correo electrónico en Braze, utiliza el valor hash del correo electrónico siempre que se incluya un correo electrónico. Estos valores hash de correo electrónico son proporcionados por tu equipo interno.
• Al crear un nuevo usuario, debes añadir email_encrypted con el valor cifrado del correo electrónico del usuario. De lo contrario, Braze no creará el usuario. Del mismo modo, si añades una dirección de correo electrónico a un usuario existente que no tiene correo electrónico, debes añadir email_encrypted. De lo contrario, Braze no actualizará al usuario.

Datos importados como atributo personalizado

Si un dato de usuario predeterminado (como email o first_name) se importa como atributo personalizado, comprueba las mayúsculas y minúsculas y el espaciado de tu archivo CSV. Por ejemplo, First_name se importa como un atributo personalizado, mientras que first_name se importa correctamente en el campo “nombre” del perfil de usuario.

Cambiar el tipo de datos de un atributo personalizado

Si necesitas cambiar el tipo de datos de un atributo personalizado existente (por ejemplo, de cadena a booleano), actualiza el tipo de datos en la página Atributos personalizados del dashboard antes de importar tu CSV. Si el tipo de datos en tu CSV no coincide con el tipo de datos definido actualmente para el atributo, la importación fallará con un error.

Múltiples tipos de datos

Braze espera que cada valor de una columna sea del mismo tipo de datos. Los valores que no coinciden con el tipo de datos de su atributo provocan errores en la segmentación.

Además, comenzar un atributo numérico con cero causará problemas, ya que los números que comienzan con cero se consideran cadenas. Cuando Braze convierte esa cadena, puede tratarla como un valor octal (que utiliza dígitos del cero al siete), lo que significa que se convierte a su valor decimal correspondiente. Por ejemplo, si el valor del archivo CSV es 0130, el perfil de Braze muestra 88. Para evitar este problema, utiliza atributos con tipos de datos de cadena. Sin embargo, este tipo de datos no está disponible en la comparación de números de segmentación.

Tipos de atributos predeterminados

Algunos atributos predeterminados solo pueden aceptar determinados valores como válidos para las actualizaciones de los usuarios. Para obtener orientación, consulta Creación de tu CSV.

Los espacios al final y las diferencias en el uso de mayúsculas pueden hacer que un valor se interprete como no válido. Por ejemplo, en el siguiente archivo CSV, solo el usuario de la primera fila (brazetest1) tiene el correo electrónico y los estados push actualizados correctamente, ya que los valores aceptados son unsubscribed, subscribed y opted_in.

1
2
3
external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

“Seleccionar archivo CSV” no funciona

Hay varias razones por las que el botón Seleccionar archivo CSV puede no funcionar: