Importación CSV

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

Acerca de la importación CSV

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

Uso de la importación CSV

Paso 1: Descarga una plantilla CSV

Para abrir la importación CSV, ve a Audiences > Import Users. Aquí encontrarás una tabla con los detalles de las importaciones más recientes, como la fecha de carga, el nombre de quien realizó la carga, el nombre del archivo, la disponibilidad de segmentación, el número de filas importadas y el estado de la importación.

Para empezar, selecciona Attributes o Events y luego descarga la plantilla correspondiente para ayudarte a construir 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:

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

Al importar los datos de tus clientes, puedes utilizar 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 nuevo usuario identificado con ese external_id establecido si no se encuentra uno.

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

Nota

Si estás cargando una mezcla de usuarios con external_id y usuarios sin él, necesitas crear un CSV para cada importación. Un CSV no puede contener tanto external_ids 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 intentas dirigirte 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 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 nuevo usuario 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 que solo tiene alias con un external_id, utiliza el punto de conexión Identificar usuarios.

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

Para actualizar perfiles de usuario existentes en Braze utilizando un valor interno de Braze ID 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 añadir un nuevo atributo personalizado a esos usuarios existentes.

Importante

No puedes usar una importación CSV para crear un nuevo usuario utilizando braze_id. Este método solo puede utilizarse 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 dashboard 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 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, verifica lo siguiente:

• Confirma que no tienes 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 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 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 utilizará la misma lógica que el punto de conexión /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 utilizar el punto de conexión /users/identify para identificar este perfil más adelante. Para eliminar un perfil de usuario, también puedes utilizar el punto de conexión /users/delete.

Paso 3: Construye tu archivo CSV

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

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

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

• user attributes
• custom events

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 pueden utilizarse 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 modifiquen durante el paso de mapeado.

Tipo de datos	Descripción
Fecha y hora	Debe almacenarse en formato ISO-8601.
Booleano	Acepta true o false.
Número	Debe ser un entero o decimal sin espacios ni comas. Los decimales 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 arrays, tokens de notificaciones push y tipos de datos de 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, utiliza el punto de conexión /users/track o la Ingesta de datos de Cloud en su lugar.

Atributos predeterminados

Importante

Al importar atributos predeterminados, los encabezados de columna que utilices 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 de Cloud), consulta Atributos estándar. La siguiente tabla cubre solo el subconjunto que puede establecerse 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 a 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 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 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 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 usuario para orientación sobre el formato.	No
email_open_tracking_disabled	Booleano	Se acepta true o false. Establécelo en true para desactivar el píxel de seguimiento de apertura en todos los correos electrónicos futuros enviados a este usuario. Disponible solo para SparkPost y SendGrid.	No
email_click_tracking_disabled	Booleano	Se acepta true o false. Establécelo en true para desactivar 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 dashboard.	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 utiliza subscription_group_id

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

Además, puedes añadir 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 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, deberás realizar múltiples importaciones.

Identificadores obligatorios

Aunque external_id no es obligatorio, debes incluir uno de los siguientes identificadores como encabezado en tu archivo CSV. 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 lo siguiente, tu CSV también puede contener encabezados de columna adicionales para propiedades del evento. Estas propiedades deben tener un encabezado de columna con el formato <event_name>.properties.<property name>.

Por ejemplo, el evento personalizado trip_booked puede tener las propiedades destination y duration. Estas pueden importarse teniendo los encabezados de columna trip_booked.properties.destination y trip_booked.properties.duration.

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 a 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 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 usuario para orientación sobre el 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últiples	Una propiedad del evento asociada a un evento personalizado. Un ejemplo es trip_booked.properties.destination	No

Requisitos de formato para eventos personalizados

Al importar eventos personalizados mediante 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

Es importante formatear correctamente tu CSV de eventos personalizados utilizando notación de punto para que cada propiedad se asigne al evento correcto. 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 las propiedades del evento

La notación de punto se utiliza 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.

Un evento por fila

Cada fila en tu CSV representa un único evento personalizado para un único 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 Attributes o Events, haz clic en Browse Files y carga tu CSV. Braze muestra una vista previa de las primeras filas y un resumen de los campos detectados.

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

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

Nota

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

Paso 5: Mapea tus campos (para atributos)

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

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

Cuando no existe un atributo coincidente en tu espacio de trabajo, Braze intenta crear un nuevo atributo en la importación utilizando el nombre del campo CSV y el tipo de datos detectado. Puedes editar este nuevo atributo antes de la importación seleccionando el botón Edit new attribute 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. Consulta la sección Required fields para ver si se ha mapeado un identificador.

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

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 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 se ejecuta la validación, puedes seleccionar Skip validation para omitirla y continuar inmediatamente.

Resultados de la validación

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

Comprensión del informe de errores

El informe de errores es un archivo CSV que contiene cada fila marcada junto con sus datos originales y una descripción del problema.

Después de revisar el informe, puedes corregir los problemas en tu archivo original y volver a cargarlo, o continuar con la importación y aceptar los resultados parciales.

Paso 8: Inicia tu importación CSV

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

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 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 API impide que Braze capture automáticamente esta información a través del SDK.

Solución de problemas

Si utilizaste la validación de archivo, comienza con el informe de errores, ya que incluye el problema específico de cada fila marcada y una descripción de cómo solucionarlo. Para las filas que fallaron durante la importación en lugar de la validación, descarga el informe de errores pasando el cursor sobre la fila y seleccionando el botón en la página Import Users.

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

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

Puedes usar una importación CSV como filtro de segmento solo 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 Import Users, busca tu importación 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 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 Create targeting filter o Create targeting filter and add to new segment.

Si tu objetivo es crear un segmento sin actualizar datos de perfil, carga un CSV que incluya solo columnas de identificadores (por ejemplo, external_id o columnas de identificadores de alias) y 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 separador y pueden provocar este error. Además, todos los datos deben estar codificados en UTF-8.

Si tu archivo CSV tiene filas en blanco e importa menos filas que el total de líneas en el archivo CSV, esto puede no indicar un problema con la importación, ya que las filas en blanco no necesitarían importarse. Verifica el número de líneas que se importaron correctamente y asegúrate de que coincida con el número de usuarios que intentas importar.

Fila faltante

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

Comillas en cadenas

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

Fechas con formato incorrecto

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

Problemas de estructura de datos

Direcciones de correo electrónico no válidas

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

• Al actualizar o importar direcciones de correo electrónico en Braze, utiliza el valor de correo electrónico con hash dondequiera que se incluya un correo electrónico. Estos valores de correo electrónico con hash son proporcionados por tu equipo interno.
• Al crear un nuevo usuario, debes añadir email_encrypted con el valor de correo electrónico cifrado del usuario. De lo contrario, Braze no creará al usuario. De manera similar, si estás añadiendo una dirección de correo electrónico a un usuario existente que no tiene correo electrónico, debes añadir email_encrypted. De lo contrario, Braze no actualizará al usuario.

Datos importados como atributo personalizado

Si un dato de usuario predeterminado (como email o first_name) se importa como atributo personalizado, verifica las mayúsculas y los espacios de tu archivo CSV. Por ejemplo, First_name se importa como atributo personalizado, mientras que first_name se importa correctamente en el campo “first name” del perfil de un usuario.

Cambiar el tipo de datos de un atributo personalizado

Si necesitas cambiar el tipo de datos de un atributo personalizado existente (por ejemplo, de cadena a booleano), actualiza el tipo de datos en la página Custom Attributes del dashboard antes de importar tu CSV. Si el tipo de datos en tu CSV no coincide con el tipo de datos actualmente definido del atributo, la importación falla con un error.

Múltiples tipos de datos

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

Además, comenzar un atributo numérico con cero causará problemas porque los números que comienzan con ceros se consideran cadenas. Cuando Braze convierte esa cadena, puede tratarse como un valor octal (que usa dígitos del cero al siete), lo que significa que se convierte a su valor decimal correspondiente. Por ejemplo, si el valor en el archivo CSV es 0130, el perfil de Braze muestra 88. Para evitar este problema, utiliza atributos con tipos de datos de cadena. Sin embargo, este tipo de datos no está disponible en la comparación numérica de segmentación.

Tipos de atributos predeterminados

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

Los espacios finales y las diferencias en las mayúsculas pueden hacer que un valor se interprete como no válido. Por ejemplo, en el siguiente archivo CSV, solo el usuario de la primera fila (brazetest1) tiene sus estados de correo electrónico y push actualizados correctamente porque los valores aceptados son unsubscribed, subscribed y opted_in.

1
2
3
external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

“Select CSV File” no funciona

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