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 CSV

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

Utilizar la importación CSV

Paso 1: Descargar una plantilla CSV

Para abrir la importación en CSV, ve a Audiencias > Importar usuarios. Aquí encontrarás una tabla con detalles sobre las importaciones más recientes, como la fecha de carga, el nombre del cargador, el nombre del archivo, la disponibilidad de destino, 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.

Página “Importar usuarios” del panel de Braze.](/docs/es/assets/img/csv_import/import_users_page.png?0df1987be02a12967c97903c8182d403)

Paso 2: Elige un identificador

El CSV que importes necesitará un identificador específico. Puedes elegir entre lo siguiente:

• 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 como un único archivo CSV. Para subir más de un tipo de datos, sube varios archivos CSV.

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

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

• user attributes
• custom events

Paso 4: Carga y vista previa de tus datos

Antes de que Braze procese tu CSV, generará una vista previa de las primeras filas para que puedas comprobar si hay algún problema. Para generar tu vista previa, elige Atributos o Eventos, luego selecciona Examinar archivos y carga tu CSV.

Se ha completado la carga de CSV con errores relacionados con tipos de datos mixtos en una sola columna](/docs/es/assets/img/csv_import/upload_csv.png?2dd609127c56229f139a1416c5a28ef3){: style=”max-width:70%”}

Paso 5: Elige las preferencias de segmentación

También puedes elegir entre las siguientes preferencias de orientació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.

Un grupo de filtros con el filtro “Actualizado/Importado de CSV” que incluye un archivo CSV titulado “Diversión en la temporada de Halloween”.](/docs/es/assets/img/csv_import/add_filter_group.png?59c959394e0cb32af8c093f00378dc8f){: style=”max-width:85%;”}

Paso 6: Inicia tu importación CSV

Cuando estés listo, selecciona Iniciar importación. Puedes seguir el progreso actual en la página de Importación de usuarios, que se actualiza automáticamente cada cinco segundos.

Si no hay problemas, el estado se actualizará a Completo y se mostrará el número de filas procesadas. Todos los datos de las filas procesadas se añadirán a los perfiles existentes o a los perfiles de nueva creación.

Consideraciones sobre el punto de datos

Cada dato de clientes importado de un archivo CSV sobrescribirá el valor existente en los perfiles de usuario y registrará 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 Braze, tu administrador de cuentas Braze puede responderte.

Solución de problemas

Revisa estos problemas comunes si tienes problemas con la importación de CSV. ¿Aún necesitas ayuda? Ponte en contacto con [email protected].

Problemas de 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 encabezamiento. Cada fila debe tener el mismo número de celdas que la fila de cabecera. Las filas con una longitud de más o menos valores que la fila de cabecera 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 importa menos filas que el total de líneas del archivo CSV, puede que esto no indique un problema con la importación, ya que no sería necesario importar las filas en blanco. Comprueba el número de líneas que se importaron correctamente y asegúrate de que coincide con el número de usuarios que intentas importar.

Fila que falta

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

Cita de cadena

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.

Cuestiones de estructura de datos

Direcciones de correo electrónico no válidas

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

• Al actualizar o importar direcciones de correo electrónico en Braze, utiliza el valor de correo electrónico cifrado siempre que se incluya un correo electrónico. Estos valores hash de correo electrónico los proporciona tu equipo interno.
• Al crear un nuevo usuario, debes añadir email_encrypted con el valor de correo electrónico encriptado del usuario. De lo contrario, no se creará el usuario. Del mismo modo, si vas a añadir 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, el usuario no se actualizará.

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 importaría como un atributo personalizado, mientras que first_name se importaría correctamente en el campo “nombre” del perfil de un usuario.

Múltiples tipos de datos

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

Además, empezar un atributo numérico por cero causará problemas, porque los números que empiezan por ceros se consideran cadenas. Cuando Braze convierta esa cadena, podrá tratarla como un valor octal (que utiliza dígitos del cero al siete), lo que significa que se convertirá a su valor decimal correspondiente. Por ejemplo, si el valor del archivo CSV es 0130, el perfil Braze mostrará 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 sólo aceptan determinados valores como válidos para las actualizaciones de los usuarios. Para orientarte, consulta Construir tu CSV.

Los espacios al final y las diferencias de mayúsculas pueden hacer que un valor se interprete como no válido. Por ejemplo, en el siguiente archivo CSV, sólo se actualizarán correctamente los estados de correo electrónico y push del usuario de la primera fila (brazetest1) 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

“Seleccionar archivo CSV” no funciona

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