Importación CSV

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

Acerca de la importación CSV

Puedes utilizar la importación CSV para registrar y actualizar los siguientes atributos de usuario y eventos personalizados. Braze acepta estos datos como archivos CSV estándar dentro de los tamaños máximos indicados en la siguiente tabla.

Uso de la importación CSV

Paso 1: Descarga una plantilla CSV

Para abrir la importación CSV, ve a Audiences > Import Users. Aquí encontrarás una tabla con los detalles de las importaciones más recientes, como la fecha de carga, el nombre de quien realizó la carga, 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 CSV que importes necesitará un identificador dedicado. Puedes elegir entre los siguientes:

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

Paso 3: Construye tu archivo CSV

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

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

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

• user attributes
• custom events

Paso 4: Carga tu archivo

Para cargar tu archivo, selecciona Attributes o Events, haz clic en Browse Files y carga tu CSV. Braze muestra una vista previa de las primeras filas y un resumen de los campos detectados.

Para archivos grandes (hasta 500 MB para atributos predeterminados y atributos personalizados, o 50 MB para eventos personalizados), el dashboard puede parecer temporalmente sin respuesta mientras el archivo se carga y Braze calcula la importación. Estas cargas y cálculos pueden tardar más en completarse que para archivos más pequeños. Deja que este paso se complete. Para más contexto sobre los límites de archivo y los tiempos, consulta Construir tu CSV.

En el campo Import name, puedes renombrar tu importación. De forma predeterminada, se utiliza el nombre del archivo.

Paso 5: Valida tu archivo (opcional)

Antes de iniciar tu importación, puedes ejecutar la validación de archivo para verificar cada fila en busca de errores y advertencias. Para validar tu archivo, selecciona Validate file before importing y luego haz clic en Start import.

La validación puede tardar hasta 2 minutos para archivos del tamaño máximo permitido. Mientras se ejecuta la validación, puedes seleccionar Skip validation para omitirla y continuar inmediatamente.

Resultados de la validación

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

Comprensión del informe de errores

El informe de errores es un archivo CSV que contiene cada fila marcada 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 cargarlo, o continuar con la importación y aceptar los resultados parciales.

Paso 6: Elige las 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 ni un segmento a partir de tu importación, selecciona Do not make this list available as a targeting filter.

Paso 7: Inicia tu importación CSV

Cuando estés listo, selecciona Start import. Puedes seguir el progreso actual en la página Import Users, que se actualiza automáticamente cada 5 segundos. El procesamiento puede tardar desde unos minutos hasta varias horas dependiendo del tamaño de tu CSV. Durante este tiempo, el dashboard puede parecer sin respuesta o responder lentamente, pero la importación sigue ejecutándose.

Estados de importación

Después de iniciar tu importación, puedes verificar su estado en la página Import Users.

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

Consideraciones sobre 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 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 responderlas.

Solución de problemas

Si utilizaste la validación de archivo, comienza con el informe de errores, ya 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 Import Users.

Para la solución de problemas de importación CSV, revisa estos problemas comunes a continuación.

Problemas de formato de archivo

Fila malformada

Si tu carga se completó con errores, puede haber una fila malformada 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 dentro de un valor se interpretarán como 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 importa menos filas que el total de líneas en el archivo CSV, esto puede no indicar un problema con la importación, ya que las filas en blanco no necesitarían importarse. Verifica el número de líneas que se importaron correctamente y asegúrate de que coincida con el número de usuarios que intentas importar.

Fila faltante

Hay algunas razones por las que el número de usuarios importados podría no coincidir con el total de filas en tu archivo CSV:

Comillas en cadenas

Los valores encapsulados en 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 de estructura de datos

Direcciones de correo electrónico no válidas

Si tu carga se completó con errores, puede haber una o más 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 de correo electrónico con hash dondequiera que se incluya un correo electrónico. Estos valores de correo electrónico con hash son proporcionados por tu equipo interno.
• Al crear un nuevo usuario, debes añadir email_encrypted con el valor de correo electrónico cifrado del usuario. De lo contrario, Braze no creará al usuario. De manera similar, si estás añadiendo 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, verifica las mayúsculas y los espacios de tu archivo CSV. Por ejemplo, First_name se importa como atributo personalizado, mientras que first_name se importa correctamente en el campo “first name” del perfil de un 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 Custom Attributes del dashboard antes de importar tu CSV. Si el tipo de datos en tu CSV no coincide con el tipo de datos actualmente definido del atributo, la importación falla con un error.

Múltiples tipos de datos

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

Además, comenzar un atributo numérico con cero causará problemas porque los números que comienzan con ceros se consideran cadenas. Cuando Braze convierte esa cadena, puede tratarse como un valor octal (que usa dígitos del cero al siete), lo que significa que se convierte a su valor decimal correspondiente. Por ejemplo, si el valor en el 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 numérica de segmentación.

Tipos de atributos predeterminados

Algunos atributos predeterminados solo pueden aceptar ciertos valores como válidos para las actualizaciones de usuario. Para orientación, consulta Construir tu CSV.

Los espacios finales y las diferencias en las 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 sus estados de correo electrónico y push actualizados correctamente porque 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

“Select CSV File” no funciona

Hay varias razones por las que el botón Select CSV File puede no funcionar: