Importación CSV

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

Acerca de la importación en CSV

Puedes usar la importación en 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 Audiencias > Importar usuarios. 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 comenzar, selecciona Atributos o Eventos y luego descarga la plantilla correspondiente para ayudarte a crear tu archivo CSV para la carga.

Paso 2: Elige un identificador

El archivo CSV que importes necesita un identificador dedicado. Elige uno de los siguientes tipos de identificador para tu importación:

• id externo
• alias de usuario
• id de braze
• dirección de correo electrónico y números de teléfono

Al importar los datos de tus clientes, puedes usar un external_id como identificador único de cada cliente. Cuando proporcionas un external_id en tu importación, Braze actualiza cualquier usuario existente con el mismo external_id o crea un usuario recién identificado con ese external_id establecido si no se encuentra uno.

• Descargar: Plantilla de importación de atributos CSV: ID externo
• Descargar: Plantilla de importación de eventos CSV: ID externo

Nota

Si estás cargando una mezcla de usuarios con un external_id y usuarios sin él, necesitas crear un CSV para cada importación. Un CSV no puede contener tanto external_id como alias de usuario.

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

Si estás cargando o actualizando perfiles de usuario que son solo de alias, debes tener las siguientes dos columnas en tu CSV:

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

user_alias_name	user_alias_label	last_name	email	sample_attribute
182736485	my_alt_identifier	Smith	[email protected]	TRUE
182736486	my_alt_identifier	Nguyen	[email protected]	FALSE

Cuando proporcionas tanto un user_alias_name como un user_alias_label en tu importación, Braze actualiza cualquier usuario existente con el mismo user_alias_name y user_alias_label. Si no se encuentra un usuario, Braze crea un usuario recién identificado con ese user_alias_name establecido.

Importante

No puedes usar una importación CSV para actualizar un usuario existente con un user_alias_name si ya tiene un external_id. En su lugar, esto crea un nuevo perfil de usuario con el user_alias_name asociado. Para asociar un usuario de solo alias con un external_id, usa el endpoint Identificar usuarios.

Descargar: Plantilla de importación de atributos CSV: Alias de usuario

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

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

Importante

No puedes usar una importación CSV para crear un nuevo usuario usando braze_id. Este método solo se puede usar para actualizar usuarios preexistentes dentro de la plataforma Braze.

Consejo

El valor de braze_id puede estar etiquetado como Appboy ID en las exportaciones CSV del panel de Braze. Este ID será el mismo que el braze_id de un usuario, por lo que puedes renombrar esta columna a braze_id cuando reimportes el CSV.

Puedes omitir un ID externo o alias de usuario y usar 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, verifica lo siguiente:

• Verifica que no tengas ningún ID externo ni alias de usuario para estos perfiles en tu archivo CSV. Si los tienes, Braze priorizará el uso del ID externo o alias de usuario antes que la dirección de correo electrónico para identificar perfiles.
• Confirma que tu archivo CSV tenga el formato correcto.

Nota

Si incluyes tanto direcciones de correo electrónico como números de teléfono en tu archivo CSV, la dirección de correo electrónico tiene prioridad sobre el número de teléfono al buscar perfiles.

Si un perfil existente tiene esa dirección de correo electrónico o número de teléfono, ese perfil se actualiza y Braze no crea un nuevo perfil. Si hay múltiples perfiles con la misma dirección de correo electrónico, Braze usará la misma lógica que el endpoint /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 crea un nuevo perfil con ese identificador. Puedes usar el endpoint /users/identify para identificar este perfil más adelante. Para eliminar un perfil de usuario, también puedes usar el endpoint /users/delete.

Paso 3: Crea tu archivo CSV

Puedes cargar cualquiera de los siguientes tipos de datos como un solo 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 únicos para tu negocio (como last_destination_searched).
• Eventos personalizados: Son únicos para tu negocio y reflejan acciones que un usuario ha realizado, como trip_booked para una aplicación de reservas de viajes.

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

• atributos de usuario
• eventos personalizados

Identificadores obligatorios

Aunque external_id no es obligatorio, tu archivo CSV debe incluir un identificador de usuario que pueda mapearse a uno de los siguientes identificadores. Para más detalles sobre cada uno, consulta Elige un identificador.

• external_id
• braze_id
• user_alias_name y user_alias_label
• email
• phone

Atributos personalizados

Los siguientes tipos de datos se pueden usar como atributos personalizados para la importación CSV. Los encabezados de columna que no coincidan exactamente con un atributo predeterminado se importan como atributos personalizados en Braze, a menos que se cambien durante el paso de mapeado.

Tipo de datos	Descripción
Datetime	Debe almacenarse en formato ISO-8601.
Boolean	Acepta true o false.
Número	Debe ser un entero o flotante sin espacios ni comas. Los flotantes deben usar un punto (.) como separador decimal.
Cadena	Puede contener comas si el valor está envuelto en comillas dobles ("").
En blanco	Los valores en blanco no sobrescribirán los valores existentes en el perfil de usuario, y no necesitas incluir todos los atributos de usuario existentes en tu archivo CSV.

Importante

Los tipos de datos de arrays, tokens de notificaciones push y eventos personalizados no son compatibles con la importación de usuarios, ya que las comas en tu archivo CSV se interpretarán como separadores de columna y causarán errores al analizar tu archivo.

Para cargar este tipo de valores, usa el endpoint /users/track o la ingesta de datos en la nube en su lugar.

Atributos predeterminados

Importante

Al importar atributos predeterminados, los encabezados de columna que uses deben coincidir exactamente con la ortografía y las mayúsculas de los atributos de usuario predeterminados. De lo contrario, Braze los detectará como atributos personalizados.

Consejo

Para la lista completa de atributos estándar que Braze reconoce (a través de SDK, API, CSV e ingesta de datos en la nube), consulta Atributos estándar. La siguiente tabla cubre solo el subconjunto que se puede establecer a través de la importación CSV.

Los siguientes atributos predeterminados están disponibles para la importación de usuarios.

Campo del perfil de usuario	Tipo de datos	Descripción	¿Obligatorio?
external_id	Cadena	Un identificador único de usuario para tu cliente.	Condicional. Consulta Identificadores obligatorios.
user_alias_name	Cadena	Un identificador único de usuario para usuarios anónimos que es una alternativa al external_id. Debe usarse con user_alias_label.	Condicional. Consulta Identificadores obligatorios.
user_alias_label	Cadena	Una etiqueta común para agrupar alias de usuario. Debe usarse con user_alias_name.	Condicional. Consulta Identificadores obligatorios.
first_name	Cadena	El nombre de tus usuarios según lo han indicado (por ejemplo, Jane).	No
last_name	Cadena	El apellido de tus usuarios según lo han indicado (por ejemplo, Doe).	No
email	Cadena	El correo electrónico de tus usuarios según lo han indicado (por ejemplo, [email protected]).	No
country	Cadena	Los códigos de país deben pasarse a Braze en el estándar ISO-3166-1 alfa-2 (por ejemplo, GB).	No
dob	Cadena	Debe pasarse en el formato “AAAA-MM-DD” (por ejemplo, 1980-12-21). Esto importa la fecha de nacimiento de tu usuario y te permite dirigirte a usuarios cuyo cumpleaños sea “hoy”.	No
gender	Cadena	“M”, “F”, “O” (otro), “N” (no aplica), “P” (prefiere no decir), o nil (desconocido).	No
home_city	Cadena	La ciudad de residencia de tus usuarios según lo han indicado (por ejemplo, London).	No
language	Cadena	El idioma debe pasarse a Braze en el estándar ISO-639-1 (por ejemplo, en). Consulta nuestra lista de idiomas aceptados.	No
phone	Cadena	Un número de teléfono según lo indicado por tus usuarios, en formato E.164 (por ejemplo, +442071838750). Consulta Números de teléfono de usuario para orientación sobre el formato.	No
email_open_tracking_disabled	Boolean	Se acepta true o false. Establece en true para deshabilitar la adición del píxel de seguimiento de apertura a todos los correos electrónicos futuros enviados a este usuario. Disponible solo para SparkPost y SendGrid.	No
email_click_tracking_disabled	Boolean	Se acepta true o false. Establece en true para deshabilitar el seguimiento de clics en todos los enlaces dentro de un correo electrónico futuro enviado a este usuario. Disponible solo para SparkPost y SendGrid.	No
email_subscribe	Cadena	Los valores disponibles son opted_in (registrado explícitamente para recibir mensajes de correo electrónico), unsubscribed (optó explícitamente por no recibir mensajes de correo electrónico) y subscribed (ni optó por recibir ni por no recibir).	No
push_subscribe	Cadena	Los valores disponibles son opted_in (registrado explícitamente para recibir mensajes push), unsubscribed (optó explícitamente por no recibir mensajes push) y subscribed (ni optó por recibir ni por no recibir).	No
time_zone	Cadena	La zona horaria debe pasarse a Braze en el mismo formato que la base de datos de zonas horarias de IANA (por ejemplo, America/New_York o Eastern Time (US & Canada)).	No
date_of_first_session date_of_last_session	Cadena	Puede pasarse en uno de los siguientes formatos ISO 8601: “AAAA-MM-DD” “AAAA-MM-DDTHH:MM:SS+00:00” “AAAA-MM-DDTHH:MM:SSZ” “AAAA-MM-DDTHH:MM:SS” (por ejemplo, 2019-11-20T18:38:57)	No
subscription_group_id	Cadena	El id de tu grupo de suscripción. Este identificador se puede encontrar en la página del grupo de suscripción de tu panel.	No
subscription_state	Cadena	El estado de suscripción para el grupo de suscripción especificado por subscription_group_id. Los valores permitidos son unsubscribed (no está en el grupo de suscripción) o subscribed (está en el grupo de suscripción).	No, pero se recomienda encarecidamente si se usa subscription_group_id

Actualización del estado del grupo de suscripción (opcional)

Además, puedes agregar usuarios a grupos de suscripción de correo electrónico o SMS a través de la importación de usuarios. Esto es particularmente útil para SMS, ya que un usuario debe estar inscrito en un grupo de suscripción de SMS para recibir mensajes del canal SMS. Para más información, consulta Grupos de suscripción de SMS.

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

• subscription_group_id: El 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).

external_id	first_name	subscription_group_id	subscription_state
A8i3mkd99	Colby	6ff593d7-cf69-448b-aca9-abf7d7b8c273	subscribed
k2LNhj8Ks	Tom	aea02307-a91e-4bc0-abad-1c0bee817dfa	subscribed

Nota

Solo se puede establecer un único subscription_group_id por fila en la importación de usuarios. Diferentes filas pueden tener diferentes valores de subscription_group_id. Sin embargo, si necesitas inscribir a los mismos usuarios en múltiples grupos de suscripción, deberás realizar múltiples importaciones.

Identificadores obligatorios

Aunque external_id no es obligatorio, tu archivo CSV debe incluir un identificador de usuario que se mapee a uno de los siguientes identificadores. Para más detalles sobre cada uno, consulta Elige un identificador.

• external_id
• braze_id
• user_alias_name y user_alias_label
• email
• phone

Campos de eventos personalizados

Además de los campos estándar listados en la siguiente tabla, tu CSV también puede contener encabezados de columna adicionales para propiedades del evento. Estas propiedades deben tener un encabezado de columna de <event_name>.properties.<property name> o <property name>.

Por ejemplo, el evento personalizado trip_booked puede tener las propiedades destination y duration. Puedes importarlas usando los encabezados de columna trip_booked.properties.destination y trip_booked.properties.duration. También puedes representar las propiedades en los encabezados como <property name>. Braze detecta las propiedades relevantes para cada evento en función de si hay un valor en la celda CSV correspondiente.

Campo del perfil de usuario	Tipo de datos	Información	¿Obligatorio?
external_id	Cadena	Un identificador único de usuario para tu usuario.	Condicional. Consulta Identificadores obligatorios.
braze_id	Cadena	Un identificador asignado por Braze para tu usuario.	Condicional. Consulta Identificadores obligatorios.
user_alias_name	Cadena	Un identificador único de usuario para usuarios anónimos, que es una alternativa al external_id. Debe usarse con user_alias_label.	Condicional. Consulta Identificadores obligatorios.
user_alias_label	Cadena	Una etiqueta común para agrupar alias de usuario. Debe usarse con user_alias_name.	Condicional. Consulta Identificadores obligatorios.
email	Cadena	El correo electrónico de tus usuarios según lo han indicado (por ejemplo, [email protected]).	No, y solo se puede usar en ausencia de otros identificadores. Consulta la siguiente nota.
phone	Cadena	Un número de teléfono según lo indicado por tus usuarios, en formato E.164 (por ejemplo, +442071838750). Consulta Números de teléfono de usuario para orientación sobre el formato.	No, y solo se puede usar en ausencia de otros identificadores. Consulta la siguiente nota.
name	Cadena	Un evento personalizado de tus usuarios.	Sí
time	Cadena	La hora del evento. Puede pasarse en uno de los siguientes formatos ISO-8601: “AAAA-MM-DD” “AAAA-MM-DDTHH:MM:SS+00:00” “AAAA-MM-DDTHH:MM:SSZ” “AAAA-MM-DDTHH:MM:SS” (por ejemplo, 2019-11-20T18:38:57)	Sí
<event name>.properties.<property name>	Múltiple	Una propiedad del evento asociada con un evento personalizado. Un ejemplo es trip_booked.properties.destination	No
<property name>	Múltiple	Una propiedad del evento que puedes usar en múltiples tipos de eventos. Un ejemplo es destination. Esta propiedad se asocia con un evento cuando hay un valor no nulo en la celda CSV correspondiente.	No

Requisitos de formato para eventos personalizados

Al importar eventos personalizados usando CSV, debes formatear tu archivo de acuerdo con los siguientes requisitos para una importación de datos exitosa.

Comprensión del formato de eventos personalizados

Formatea correctamente tu CSV de eventos personalizados usando notación de punto, o con un valor no nulo en la celda correspondiente, para que Braze mapee cada propiedad al evento final. Si el formato es incorrecto, las propiedades pueden descartarse o la importación puede fallar, especialmente cuando se incluyen múltiples tipos de eventos en un solo archivo.

Usa notación de punto para propiedades del evento

Usa notación de punto para definir la relación jerárquica entre un evento personalizado y sus propiedades. Esta convención de formato te permite importar datos de eventos estructurados que incluyen atributos específicos para cada evento.

El formato de notación de punto sigue esta estructura: event_name.properties.property_name

La notación de punto funciona en la siguiente secuencia:

1. El nombre del evento va primero
2. Seguido de .properties. para indicar que lo que sigue es una propiedad del evento
3. Finalmente, el nombre específico de la propiedad

Ejemplo:

Para un evento personalizado llamado rented_movie con las propiedades movie_name y genre, los encabezados de columna de tu CSV serían:

• rented_movie.properties.movie_name
• rented_movie.properties.genre

Esta notación le indica a Braze que cree un evento personalizado llamado rented_movie y adjunte las propiedades movie_name y genre a esa instancia específica del evento.

Si usas una combinación de notación de punto y notación sin punto para importar propiedades, tu carga CSV puede fallar porque Braze detecta encabezados duplicados. Esto ocurre cuando tienes encabezados rented_movie.properties.movie_name y movie_name dentro del mismo archivo. Para evitar esto, usa solo un formato de propiedades para tus encabezados.

Un evento por fila

Cada fila en tu CSV representa un solo evento personalizado para un solo usuario. Si un usuario tiene múltiples eventos, debes incluir una fila separada para cada evento, incluso si comparten el mismo identificador de usuario.

Importante

Cuando una fila contiene datos para un evento específico, solo completa las columnas de las propiedades de ese evento. Deja en blanco las columnas de otros eventos.

Ejemplo de estructura CSV

La siguiente tabla muestra el formato correcto para importar eventos personalizados con propiedades. Este ejemplo muestra dos usuarios que realizaron diferentes eventos: uno alquiló una película y otro compró una película.

external_id	name	time	rented_movie.properties.movie_name	rented_movie.properties.genre	bought_movie.properties.movie_name	bought_movie.properties.genre
123	rented_movie	2024-06-10T12:00:00Z	Ghostbusters	Action
456	bought_movie	2024-06-12T12:00:00Z			Ghostbusters	Action

En este ejemplo:

• El usuario 123 activó el evento rented_movie con las propiedades movie_name (Ghostbusters) y genre (Action)
• El usuario 456 activó el evento bought_movie con las propiedades movie_name (Ghostbusters) y genre (Action)
• Cada evento solo completa sus columnas de propiedades relevantes, dejando en blanco las columnas de propiedades de otros eventos

Paso 4: Carga 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.

Para archivos grandes (hasta 500 MB para atributos predeterminados y atributos personalizados, o 50 MB para eventos personalizados), el panel 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.

Antes de cargar tu archivo CSV, renómbralo con el nombre de importación que deseas ver en Braze. No puedes editar el nombre de importación después de la carga.

Nota

La vista previa del archivo solo muestra las primeras filas de tu archivo. Para verificar cada fila antes de importar, usa la validación de archivo.

Importante

Las importaciones de usuarios CSV están disponibles para descargar desde el panel durante 14 días después de la carga. Después de este período, el archivo se elimina del almacenamiento y ya no es accesible.

Paso 5: Mapea tus campos

Después de la vista previa, puedes mapear los encabezados de tu CSV a atributos, eventos o propiedades del evento de Braze. Braze mapea automáticamente los campos de tu archivo CSV a atributos, eventos o propiedades del evento con nombres idénticos, y crea nuevos campos cuando es necesario. También tendrás la flexibilidad de ajustar manualmente las sugerencias o seleccionar diferentes atributos, eventos o propiedades.

Para las propiedades del evento, Braze detecta las propiedades y las asocia con los eventos relevantes en función de si una celda CSV contiene un valor no nulo, o a partir de encabezados que usan notación de punto en el formato <event name>.properties.<property name>.

Estados de mapeado

La columna de estado de mapeado indica la acción que ocurre cuando se importa tu archivo CSV y puede ser cualquiera de los siguientes.

Edición de nuevos atributos, eventos y propiedades

Cuando un atributo, evento o propiedad del evento coincidente no existe en tu espacio de trabajo, Braze intenta crear un nuevo atributo, evento o propiedad en la importación usando el nombre del campo CSV y el tipo de datos detectado. Puedes editar este nuevo campo antes de la importación seleccionando el botón Editar nuevo atributo, Editar nuevo evento o Editar nueva propiedad junto al estado de mapeado.

Nota

No puedes avanzar más allá del paso de mapeado hasta que se mapee un identificador. Braze mapea automáticamente un identificador cuando es posible. Para eventos personalizados, también debes mapear las columnas name y time. Consulta la sección Campos obligatorios para más información.

Paso 6: Elige las preferencias de segmentación

Después del mapeado, puedes elegir entre las siguientes preferencias de segmentación en la página de configuración de importación. Si no necesitas crear un nuevo filtro de segmentación ni un Segment a partir de tu importación, selecciona No hacer esta lista disponible como filtro de segmentación.

Paso 7: 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 Validar archivo antes de importar en la página de configuración de importación y luego selecciona Siguiente.

La validación puede tardar hasta 2 minutos para archivos del tamaño máximo permitido. Mientras se ejecuta la validación, puedes seleccionar Omitir validación para saltarla 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 8: Inicia tu importación CSV

Cuando estés listo, selecciona Iniciar importación. Puedes seguir el progreso actual en la página Importar usuarios, 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 panel puede parecer sin respuesta o responder lentamente, pero la importación sigue en ejecución.

Nota

Puedes importar más de un CSV al mismo tiempo. Las importaciones CSV se ejecutan de forma concurrente, por lo que no se garantiza que el orden de las actualizaciones sea secuencial. Si necesitas que las importaciones CSV se ejecuten una tras otra, espera a que una importación CSV haya finalizado antes de cargar una segunda.

Estados de importación

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

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.

Importante

Los archivos CSV cargados previamente están disponibles para descargar desde la página Importar usuarios durante 14 días después de la fecha de carga. Después de 14 días, el archivo se elimina permanentemente y ya no se puede acceder a él.

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.

Importante

Configurar language o country en un usuario a través de una importación de CSV o API impide que Braze capture automáticamente esta información a través del SDK.

Solución de problemas

Si usaste la validación de archivos, 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 Importar usuarios.

Para solucionar problemas de importación de CSV, revisa estos problemas comunes en las siguientes secciones.

La importación de CSV se queda en Calculando

En Importar usuarios, Calculating significa que Braze aún está preparando el archivo para su procesamiento. Durante este paso, el recuento de filas puede mostrarse como 0 / Calculating hasta que la preparación finalice.

Si tu importación parece estar atascada en Calculando:

• Deja que la importación continúe. No canceles ni vuelvas a cargar a menos que el soporte de Braze te lo indique.
• Confirma que tu archivo está dentro de los límites admitidos en Construir tu CSV.
• Revisa el Paso 4: Carga tu archivo y el Paso 8: Inicia tu importación de CSV para conocer el comportamiento esperado del panel y los tiempos de procesamiento.
• Contacta con el soporte de Braze si Calculating dura mucho más de lo esperado para el tamaño de tu archivo después de haber confirmado esas verificaciones.

Usar correo electrónico como external_id

Braze no recomienda usar una dirección de correo electrónico como external_id. Si usas el correo electrónico como external_id, incluye tanto la columna external_id como la columna email en tu CSV para que los usuarios sigan siendo segmentables en el canal de correo electrónico. Usa una coma (,) como delimitador de columnas, no dos puntos (:).

Caracteres de comillas en valores de external_id

Si una celda de external_id contiene comillas dobles, escápalas duplicando el carácter (""), como se describe en Comillas dobles sin escapar o desbalanceadas. La importación de CSV no usa escape con barra invertida.

La importación de CSV no está disponible como filtro de segmento

Solo puedes usar una importación de CSV como filtro de segmento si habilitaste una preferencia de segmentación durante la carga.

Para verificar si la disponibilidad de segmentación está habilitada para una importación existente:

1. En la página Importar usuarios, busca tu importación de CSV.
2. Comprueba si aparece Ir a Segment para esa importación.
3. Si aparece Ir a Segment, tu CSV está disponible en el filtro de segmento Updated/Imported from CSV.
4. Si Ir a Segment no aparece, la disponibilidad de segmentación no se habilitó para esa importación.

No puedes habilitar la disponibilidad de segmentación después de que se complete una carga de CSV. Para usar ese CSV como filtro de segmento, vuelve a cargar el archivo y, en el Paso 6: Elige las preferencias de segmentación, selecciona Crear filtro de segmentación o Crear filtro de segmentación y añadir a un nuevo segmento.

Si tu objetivo es crear un segmento sin actualizar los datos del perfil, carga un CSV que incluya solo columnas de identificadores (por ejemplo, external_id o columnas de identificadores de alias), y luego selecciona Crear filtro de segmentación y añadir a un nuevo segmento.

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 separadores y pueden provocar este error.

Además, todos los datos deben estar codificados en UTF-8. Si el archivo se guarda con una codificación heredada (por ejemplo, algunos valores predeterminados de Excel), los caracteres especiales y las URL en las celdas pueden corromperse y aparecer como signos de interrogación (?) en Braze o en los mensajes enviados.

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 ser importadas. 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 varias razones por las que el número de usuarios importados podría no coincidir con el total de filas en tu archivo CSV:

Comillas de cadena

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

Fechas con formato incorrecto

Las fechas que no estén en formato ISO-8601 no se leerán como datetimes durante 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, usa el valor de correo electrónico con hash en cualquier lugar donde se incluya un correo electrónico. Estos valores de correo electrónico con hash los proporciona 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 “nombre” 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 Atributos personalizados del panel 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 en una columna sea del mismo tipo de datos. Los valores que no coincidan con el tipo de datos de su atributo causarán 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 tratarla 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, usa 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 obtener orientación, consulta Construir tu CSV.

Los espacios finales y las diferencias en 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

“Seleccionar archivo CSV” no funciona

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