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

Usar importación en CSV

Paso 1: Descargar una plantilla CSV

Para abrir la importación de 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, selecciona Attributes o Events y luego descarga la plantilla correspondiente que te ayudará a construir tu archivo CSV para la carga.

Paso 2: Elegir 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 combinación de usuarios con un external_id y usuarios sin uno, 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 tratando de llegar 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 solo tienen alias, debes tener las siguientes dos columnas en tu CSV:

• user_alias_name: un identificador único del 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 solo con alias a 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 interno de ID 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 mediante nuestra opción de exportación CSV dentro de la segmentación y quieres 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 puede usarse para actualizar usuarios preexistentes dentro de la plataforma Braze.

Consejo

El valor de braze_id puede aparecer 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 vuelvas a importar 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:

• Confirma que no tienes ningún ID externo o 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 tiene 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 se prioriza 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: Construir 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 de tu negocio (como last_destination_searched).
• Eventos personalizados: Son únicos de tu negocio 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:

• atributos de usuario
• eventos personalizados

Identificadores requeridos

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 Elegir un identificador.

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

Atributos personalizados

Los siguientes tipos de datos pueden usarse 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 estos tipos de valores, usa el endpoint /users/track o Cloud Data Ingestion 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 predeterminados de usuario. 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 y Cloud Data Ingestion), consulta Atributos estándar. La siguiente tabla cubre solo el subconjunto que puede establecerse mediante 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 del usuario para tu cliente.	Condicional. Consulta Identificadores requeridos.
user_alias_name	Cadena	Un identificador único del usuario para usuarios anónimos que es una alternativa al external_id. Debe usarse con user_alias_label.	Condicional. Consulta Identificadores requeridos.
user_alias_label	Cadena	Una etiqueta común para agrupar alias de usuario. Debe usarse con user_alias_name.	Condicional. Consulta Identificadores requeridos.
first_name	Cadena	El nombre de tus usuarios tal como lo han indicado (por ejemplo, Jane).	No
last_name	Cadena	El apellido de tus usuarios tal como lo han indicado (por ejemplo, Doe).	No
email	Cadena	El correo electrónico de tus usuarios tal como 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 alpha-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 es “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 tal como la 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 indicado por tus usuarios, en formato E.164 (por ejemplo, +442071838750). Consulta Números de teléfono de usuarios para orientación sobre formato.	No
email_open_tracking_disabled	Boolean	Se acepta true o false. Establécelo en true para desactivar el pixel de seguimiento de aperturas en todos los correos electrónicos futuros enviados a este usuario.	No
email_click_tracking_disabled	Boolean	Se acepta true o false. Establécelo en true para desactivar el seguimiento de clics en todos los enlaces de futuros correos electrónicos enviados a este usuario.	No
email_subscribe	Cadena	Los valores disponibles son opted_in (registrado explícitamente para recibir correos electrónicos), unsubscribed (optó explícitamente por no recibir correos electrónicos) 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 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

Actualizar el estado del grupo de suscripción (opcional)

Adicionalmente, puedes agregar usuarios a grupos de suscripción de correo electrónico o SMS mediante la importación de usuarios. Esto es particularmente útil para SMS, ya que un usuario debe estar inscrito en un grupo de suscripción SMS para recibir mensajes a través del canal SMS. Para más información, consulta Grupos de suscripción 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, tendrás que hacer múltiples importaciones.

Identificadores requeridos

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 Elegir 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 de eventos. 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 importar estas 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 basándose en 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 del usuario para tu usuario.	Condicional. Consulta Identificadores requeridos.
braze_id	Cadena	Un identificador asignado por Braze para tu usuario.	Condicional. Consulta Identificadores requeridos.
user_alias_name	Cadena	Un identificador único del usuario para usuarios anónimos, que es una alternativa al external_id. Debe usarse con user_alias_label.	Condicional. Consulta Identificadores requeridos.
user_alias_label	Cadena	Una etiqueta común para agrupar alias de usuario. Debe usarse con user_alias_name.	Condicional. Consulta Identificadores requeridos.
email	Cadena	El correo electrónico de tus usuarios tal como lo han indicado (por ejemplo, [email protected]).	No, y solo puede usarse en ausencia de otros identificadores. Consulta la siguiente nota.
phone	Cadena	Un número de teléfono indicado por tus usuarios, en formato E.164 (por ejemplo, +442071838750). Consulta Números de teléfono de usuarios para orientación sobre formato.	No, y solo puede usarse 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 evento. 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 lograr una importación de datos exitosa.

Comprender el 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 evento en un solo archivo.

Usar notación de punto para propiedades de eventos

Usa la 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 dice 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 de CSV puede fallar porque Braze detecta encabezados duplicados. Esto ocurre cuando tienes los 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 rellena las columnas de las propiedades de ese evento. Deja las columnas de otros eventos en blanco.

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 desencadenó el evento rented_movie con las propiedades movie_name (Ghostbusters) y genre (Action)
• El usuario 456 desencadenó el evento bought_movie con las propiedades movie_name (Ghostbusters) y genre (Action)
• Cada evento solo rellena sus columnas de propiedades relevantes, dejando las columnas de propiedades de otros eventos en blanco

Paso 4: Cargar 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 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 con archivos más pequeños. Deja que este paso se complete. Para más contexto sobre los límites de archivo y tiempos, consulta Construir tu CSV.

Antes de cargar tu archivo CSV, renómbralo con el nombre de importación que quieres 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 del archivo.

Importante

Las importaciones CSV de usuarios 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: Mapear tus campos

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

Para las propiedades de eventos, Braze detecta las propiedades y las asocia con eventos relevantes basándose en 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 del mapeado

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

Editar 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 Edit new attribute, Edit new event o Edit new property junto al estado del 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 requeridos para más información.

Paso 6: Elegir 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 o Segment a partir de tu importación, selecciona Do not make this list available as a targeting filter.

Paso 7: Validar tu archivo (opcional)

Antes de iniciar tu importación, puedes ejecutar la validación del archivo para verificar cada fila en busca de errores y advertencias. Para validar tu archivo, selecciona Validate file before importing en la página de configuración de importación y luego selecciona Next.

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

Resultados de la validación

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

Comprender el 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 proceder con la importación y aceptar los resultados parciales.

Paso 8: Iniciar tu importación CSV

Cuando estés listo, selecciona Start Import. Puedes hacer seguimiento del 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 panel puede parecer sin respuesta o responder lentamente, pero la importación sigue ejecutándose.

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 serial. Si necesitas que las importaciones CSV se ejecuten una después de otra, espera a que una importación CSV haya terminado antes de cargar una segunda.

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.

Importante

Los archivos CSV cargados previamente están disponibles para descargar desde la página Import Users 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

Establecer language o country en un usuario a través de la importación CSV o la 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 colocando 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.

Importación de CSV atascada en Calculando

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

Si tu importación parece atascada en Calculando:

• Deja que la importación continúe. No canceles ni vuelvas a subir el archivo a menos que 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: Sube 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 a 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 ambas columnas external_id y 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 una comilla doble, escápala duplicando el carácter (""), como se describe en Comillas dobles sin escape 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, encuentra tu importación de CSV.
2. Verifica si aparece Go to Segment para esa importación.
3. Si aparece Go to Segment, tu CSV está disponible en el filtro de segmento Updated/Imported from CSV.
4. Si Go to 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 subir el archivo y, en el Paso 6: Elige preferencias de segmentación, selecciona Create targeting filter o Create targeting filter and add to new segment.

Si tu objetivo es crear un segmento sin actualizar datos de perfil, sube un CSV que incluya solo columnas de identificadores (por ejemplo, external_id o columnas de identificadores de alias), luego selecciona Create targeting filter and add to new segment.

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 causar 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 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 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 en cadenas

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 correctamente cifradas antes de importarlas a Braze.

• Al actualizar o importar direcciones de correo electrónico en Braze, usa el valor de correo electrónico hasheado en cualquier lugar donde se incluya un correo electrónico. Estos valores de correo electrónico hasheados son proporcionados por tu equipo interno.
• Al crear un nuevo usuario, debes agregar 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 agregando una dirección de correo electrónico a un usuario existente que no tiene correo electrónico, debes agregar 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 el espaciado 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 actualmente definido del 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 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, 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 causar 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 podría no funcionar: