Importación de usuarios

Braze ofrece diversas formas de importar los datos de los usuarios a la plataforma: SDK, API, ingesta de datos en la nube, integraciones de socios tecnológicos y archivos CSV.

Antes de continuar, nota que Braze no sanea (valida o formatea correctamente) los datos HTML durante la importación. Esto significa que las etiquetas de script deben eliminarse de todos los datos de importación destinados a la personalización web.

Al importar datos a Braze destinados específicamente al uso de personalización en un navegador web, asegúrese de que estén desprovistos de HTML, JavaScript o cualquier otra etiqueta de secuencia de comandos que pueda ser aprovechada de forma malintencionada al visualizarse en un navegador web.

Alternativamente, para HTML, puedes utilizar los filtros Braze Liquid (strip_html) para escapar caracteres HTML del texto representado. Por ejemplo:

• entrada
• salida

1
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}

1
Have you read Ulysses?

API REST

Utiliza el punto final /users/track para registrar eventos personalizados, atributos de usuario y compras de usuarios.

Ingesta de datos de Cloud

Utiliza Braze Ingesta de datos en la nube para importar y mantener los atributos de los usuarios.

Importación CSV

Puedes subir y actualizar perfiles de usuario mediante archivos CSV desde Audiencia > Importar usuarios.

La importación de CSV permite registrar y actualizar atributos de usuario como el nombre y el correo electrónico, además de atributos personalizados como la talla de calzado. Puede importar un CSV especificando uno de los dos identificadores únicos de usuario: un external_id o un alias de usuario.

Creación del CSV

Existen varios tipos de datos en Braze. Al importar o actualizar perfiles de usuario con un archivo CSV, puede crear o actualizar atributos de usuario predeterminados o atributos personalizados.

• Los atributos de usuario por defecto son claves reservadas en Braze. Por ejemplo, first_name o email.
• Los atributos personalizados se adaptan a su empresa. Por ejemplo, una aplicación de reservas de viajes puede tener un atributo personalizado llamado last_destination_searched.

Braze acepta datos de usuario en formato CSV estándar de archivos de hasta 500 MB de tamaño. Consulte las secciones anteriores sobre importación para descargar plantillas CSV.

Consideraciones sobre los puntos de datos

Cada dato de cliente importado de un archivo CSV sobrescribirá el valor existente en los perfiles de usuario y contará como un punto de datos, excepto los ID externos y los valores en blanco.

• Los ID externos cargados desde un archivo CSV no consumirán puntos de datos. Si está cargando un CSV para segmentar usuarios Braze existentes cargando sólo ID externos, puede hacerlo sin consumir puntos de datos. Si tuviera que añadir datos adicionales como correos electrónicos o números de teléfono de usuarios en su importación, eso sobrescribiría los datos de usuarios existentes, consumiendo sus puntos de datos.
  • Las importaciones CSV con fines de segmentación (importaciones realizadas con external_id, braze_id, o user_alias_name como único campo) no consumirán puntos de datos.
• Los valores en blanco no sobrescribirán los valores existentes en el perfil de usuario, y no es necesario que incluya todos los atributos de usuario existentes en su archivo CSV.
• La actualización de email_subscribe, push_subscribe, subscription_group_id o subscription_state no contará para el consumo de puntos de datos.

Encabezados de columna de datos de usuario por defecto

Importar un CSV

Para importar tu archivo CSV, ve a Audiencias > Importación de usuarios. Aquí encontrará una tabla que enumera las importaciones más recientes, que incluye detalles 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 cada importación.

Seleccione Examinar archivos y su archivo. Braze cargará su archivo y comprobará los encabezados de columna y los tipos de datos de cada columna.

Para descargar una plantilla CSV, consulte las secciones Importar con ID externo o Importar con alias de usuario en esta página.

Una vez completada la carga, verás un modal con una vista previa del contenido de tu archivo. Toda la información de esta tabla se basa en los valores de las primeras filas de su archivo CSV. En las cabeceras de columna, los atributos estándar se escriben en texto normal, mientras que los atributos personalizados aparecen en cursiva y su tipo se indica entre paréntesis. También hay un resumen de su expediente en la parte superior de la ventana emergente.

Puede importar más de un CSV al mismo tiempo. Las importaciones de CSV se ejecutan simultáneamente, por lo que no se garantiza que el orden de las actualizaciones sea en serie. Si necesita que las importaciones CSV se ejecuten una tras otra, espere a que una importación CSV haya finalizado antes de cargar una segunda.

Si Braze detecta algo malformado en tu archivo durante la carga, estos errores se mostrarán con el resumen. Por ejemplo, si su archivo incluye una fila mal formada, ese error se observa en la vista previa al importar el archivo. Así, un archivo puede importarse con errores, pero una importación no puede cancelarse o revertirse una vez iniciada. Revise la vista previa y, si encuentra algún error, cancele la importación y modifique su archivo.

Las filas malformadas y las que carecen de ID externo no se importarán. Todos los demás errores pueden importarse, pero pueden interferir con el filtrado al crear un segmento. Para más información, pasa a la sección Solución de problemas.

Cuando estés satisfecho con la carga, inicia la importación. La ventana emergente se cerrará y la importación comenzará en segundo plano. Puede seguir su progreso en la página Importación de usuarios, que se actualizará cada cinco segundos, o pulsando el botón de actualización del cuadro Importaciones recientes.

Bajo Líneas procesadas se muestra el progreso de la importación; el estado cambiará a Completo cuando haya finalizado. Puedes seguir utilizando el resto del panel de control de Braze durante la importación, y recibirás notificaciones cuando comience y termine la importación.

Si el proceso de importación se topa con un error, aparecerá un icono amarillo de advertencia junto al número total de líneas del archivo. Puede pasar el ratón por encima del icono para ver detalles sobre por qué fallaron determinadas líneas. Una vez finalizada la importación, todos los datos se añadirán a los perfiles existentes o se crearán perfiles nuevos.

Importación con ID externo

Al importar tus datos de clientes, tendrás que especificar el identificador único de cada cliente (external_id). Antes de iniciar la importación de CSV, es importante que su equipo de ingeniería sepa cómo se identificarán los usuarios en Braze. Normalmente, se trata de un ID interno de la base de datos. Esto debería alinearse con la forma en que los usuarios serán identificados por el SDK Braze en móviles y web y está diseñado para que cada cliente tenga un único perfil de usuario dentro de Braze en todos sus dispositivos. Más información sobre el ciclo de vida del perfil de usuario de Braze.

Cuando proporcione un external_id en su importación, Braze actualizará cualquier usuario existente con el mismo external_id o creará un nuevo usuario identificado con ese conjunto external_id si no se encuentra ninguno.

Descargar: [Plantilla de importación CSV][plantilla]

Importación con alias de usuario

Para dirigirse a usuarios que no tienen un external_id, puede importar una lista de usuarios con alias de usuario. Un alias sirve como identificador de usuario único alternativo, y puede ser útil si estás intentando comercializar con usuarios anónimos que no se han registrado o creado una cuenta en tu aplicación.

Si está cargando o actualizando perfiles de usuario que son sólo alias, debe tener las dos columnas siguientes en su CSV:

• user_alias_name: Un identificador único de usuario; una alternativa al external_id
• user_alias_label: Una etiqueta común para agrupar los alias de usuario

Cuando proporcione user_alias_name y user_alias_label en su importación, Braze actualizará cualquier usuario existente con los mismos user_alias_name y user_alias_label. Si no se encuentra un usuario, Braze creará un nuevo usuario identificado con ese conjunto user_alias_name.

Descargar: Plantilla de importación de alias CSV

Importación con Braze ID

Para actualizar perfiles de usuario existentes en Braze utilizando un valor interno de ID de Braze en lugar de un valor de external_id o user_alias_name y user_alias_label, especifica braze_id como cabecera de columna.

Esto puede ser útil si has exportado datos de usuario desde Braze a través de nuestra opción de exportación CSV dentro de la segmentación y quieres añadir un nuevo atributo personalizado a esos usuarios existentes.

Importación con direcciones de correo electrónico y números de teléfono

Puedes omitir un ID externo o un alias de usuario y utilizar una dirección de correo electrónico o un número de teléfono para importar usuarios. Antes de importar un archivo CSV con direcciones de correo electrónico o números de teléfono, comprueba lo siguiente:

• Comprueba que no tienes ID externos ni alias de usuario para estos perfiles en tu archivo CSV. Si lo haces, Braze dará prioridad al uso del ID externo o alias de usuario antes que a la dirección de correo electrónico para identificar perfiles.
• Confirma que tu archivo CSV tiene el formato adecuado.

Si un perfil existente tiene esa dirección de correo electrónico o número de teléfono, ese perfil se actualizará, y Braze no creará un perfil nuevo. Si hay varios perfiles con esa misma dirección de correo electrónico, Braze utilizará la misma lógica que el punto final/users/track , donde se actualizará el perfil actualizado más recientemente.

Si no existe un perfil con esa dirección de correo electrónico o número de teléfono, Braze creará un nuevo perfil con ese identificador. Puedes utilizar el punto final/users/identify para identificar este perfil más adelante. Para eliminar un perfil de usuario, también puedes utilizar el punto final /users/delete.

Importar datos personalizados

Cualquier encabezado que no coincida exactamente con los datos de usuario predeterminados creará un atributo personalizado dentro de Braze.

En la importación de usuarios se aceptan los siguientes tipos de datos:

• Fecha y hora: Debe almacenarse en formato ISO-8601
• Booleano: true o false
• Número: Número entero o flotante sin espacios ni comas, los flotantes deben utilizar un punto (.) como separador decimal
• Cadena: Puede contener comas si hay comillas dobles ("") rodeando el valor de la columna
• En blanco: Los valores en blanco no sobrescribirán los valores existentes en el perfil de usuario, y no es necesario que incluyas todos los atributos de usuario existentes en tu archivo CSV

Importación de usuarios Lambda en CSV

Puede utilizar nuestro script de importación CSV de S3 Lambda sin servidor para cargar atributos de usuario en la plataforma. Esta solución funciona como un cargador de CSV en el que depositas tus CSV en un bucket de S3 y los scripts los cargan a través de nuestra API.

Los tiempos de ejecución estimados para un archivo con 1.000.000 de filas deberían rondar los cinco minutos. Consulte Importación de atributos de usuario CSV a Braze para obtener más información.

Actualización del estado del grupo de suscripción

Puedes añadir usuarios a grupos de suscripción por correo electrónico o SMS mediante la importación de usuarios. Esto es especialmente útil para los SMS, ya que un usuario debe estar inscrito en un grupo de suscripción SMS para recibir mensajes con el canal SMS. Para más información, consulta Grupos de suscripción por SMS.

Si estás actualizando estados del grupo de suscripción, debes tener las dos columnas siguientes en tu CSV:

• subscription_group_id: La dirección id del grupo de suscripción.
• subscription_state: Los valores disponibles son unsubscribed (no está en el grupo de suscripción) o subscribed (está en el grupo de suscripción).

Crear un filtro de reorientación a partir de una importación de usuarios

La importación de usuarios puede utilizarse para convertir el archivo CSV en un filtro de reorientación seleccionando Importar usuarios en este CSV y hacer posible reorientar este lote específico de usuarios como grupo. Para filtrar por el archivo en un segmento o donde sea que el filtrado sea una opción, selecciona el filtro Actualizado/Importado de CSV y luego busca el nombre exacto del archivo.

Crear segmentos a partir de una importación de usuarios

La importación de usuarios también se puede utilizar para crear segmentos seleccionando Importar usuarios en este CSV y hacer posible reorientar este lote específico de usuarios como un grupo y marcando Generar automáticamente un segmento a partir de los usuarios que se importan de este CSV antes de iniciar la importación.

Puede establecer el nombre del segmento o aceptar el predeterminado, que es el nombre de su archivo. Los archivos que se utilizaron para crear un segmento tendrán un enlace para ver el segmento una vez finalizada la importación.

El filtro utilizado para crear el segmento selecciona los usuarios que se crearon o actualizaron en una importación seleccionada y está disponible con todos los demás filtros en la página de edición de segmentos.

Consideraciones

Solución de problemas

Carga completada con errores

Fila malformada

Debe haber una fila de encabezamiento para importar datos correctamente. Cada fila debe tener el mismo número de celdas que la fila de cabecera. Las filas con una longitud superior o inferior a 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 su 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. Compruebe el número de líneas que se han importado correctamente y asegúrese de que coincide con el número de usuarios que está intentando importar.

Direcciones de correo electrónico no válidas

Braze ha detectado direcciones de correo electrónico cifradas 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á.

Filas que faltan

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

• Duplicar ID externos, alias de usuario, ID de Braze, direcciones de correo electrónico o números de teléfono: Si hay columnas ID externas duplicadas, esto puede provocar filas mal formadas o no importadas, aunque las filas estén formateadas correctamente. En algunos casos, esto puede no informar de un error específico. Compruebe si hay ID externos duplicados en su CSV. Si es así, elimine los duplicados e intente cargarlos de nuevo.
• Caracteres acentuados: Su CSV puede tener nombres o atributos que incluyan acentos. Asegúrate de que tu archivo está codificado en UTF-8 para evitar problemas.
• El ID de Braze pertenece a un usuario huérfano: Cuando un usuario queda huérfano, es posible que el usuario restante con el que se fusionó el huérfano siga sin asociar el ID de Braze del usuario huérfano con el perfil. En este caso, Braze no encontrará ningún usuario para actualizar, por lo que la fila no contará como importada.
• Fila vacía: Hay una fila en blanco en el archivo CSV. Esto se puede comprobar si abres el CSV en un programa editor de texto (no utilices Excel ni Sheets). Si subes el CSV con una fila vacía, aparecerá un mensaje de error diciendo que hay filas con datos mal formados.
• Incluidas las comillas dobles ("): Este carácter no es válido y hará que la fila esté malformada. En su lugar, utiliza comillas simples (').
• Saltos de línea incoherentes: Por ejemplo, si el archivo CSV utiliza \n para la primera línea y \r\n para cada línea posterior, la primera fila de datos se procesará como parte de la cabecera, y esos datos no se importarán como se esperaba. Puedes comprobarlo en un editor hexadecimal o en un editor de texto especializado que distinga los caracteres de los espacios en blanco.
• Archivo codificado incorrectamente: El archivo CSV puede incluir nombres o atributos que tengan acentos, pero el archivo debe estar codificado en UTF-8 para importarlos correctamente. Otras codificaciones de caracteres pueden funcionar en algunas instancias, pero solo UTF-8 es totalmente compatible.

Fechas con formato incorrecto

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

Cita de cadena

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

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 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

El botón “Seleccionar archivo CSV” no funciona

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

• Bloqueador de ventanas emergentes: Esto puede impedir que se muestre la página. Confirma que tu navegador permite ventanas emergentes en el sitio web del panel de Braze.
• Navegador anticuado: Asegúrate de que tu navegador está actualizado; si no lo está, actualízalo a la última versión.
• Procesos de fondo: Cierra todas las instancias del navegador y reinicia tu computadora.