Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

Solución de problemas de exportación

Usa esta página para diagnosticar problemas de exportación CSV y API en el panel y las API de exportación. Para flujos de trabajo y límites de exportación, consulta Exportar datos de segmento a CSV y API de exportación.

Empieza aquí: identifica tu problema

Busca el comportamiento que estás observando en la tabla y, a continuación, dirígete a esa sección para revisar las comprobaciones específicas.

Problema	Ir a
El enlace de descarga del CSV devuelve `AccessDenied`, `ExpiredToken` o “el archivo no existe”	Exportación predeterminada: errores de CSV o Almacenamiento en el cloud: errores de CSV
La URL de descarga de la exportación de la API devuelve `403 Forbidden`	No se puede descargar un ZIP de Segment exportado
La exportación de Segment falla o indica que el segmento es demasiado grande	El segmento es demasiado grande
No se recibe el correo electrónico de exportación de Segment	No se recibe el correo electrónico de exportación de Segment
El recuento de filas del CSV no coincide con los análisis de Campaign	Discrepancia en los análisis de Campaign y Canvas
Faltan columnas esperadas en el archivo de exportación	Columnas faltantes
La exportación al almacenamiento en el cloud muestra `AccessDenied` o `ExpiredToken`	Almacenamiento en el cloud conectado: errores de API

Ruta de investigación estándar

Usa este flujo de trabajo para cada incidente de exportación. Comienza en el paso 1.

Confirma si estás exportando al contenedor de S3 predeterminado de Braze o a un partner de almacenamiento en el cloud conectado. La expiración de enlaces y el comportamiento de reintento difieren entre ambos.
Para las exportaciones CSV del panel, confirma que has iniciado sesión en Braze al abrir el enlace de descarga. Los enlaces del contenedor predeterminado requieren una sesión activa en el panel.
Comprueba cuánto tiempo ha pasado desde que se completó la exportación. Los enlaces de descarga enviados por correo electrónico desde el panel expiran después de cuatro horas, tanto si usas el contenedor predeterminado de Braze como si usas un partner de almacenamiento conectado. Cuando hay un partner de almacenamiento conectado, Braze también entrega una copia a tu contenedor; esa copia sigue tus políticas de retención y puede seguir disponible después de que el enlace del correo electrónico expire.
Para exportaciones de Segments grandes, confirma que la audiencia está por debajo del límite de 500 000 usuarios para exportaciones CSV del panel. Las estimaciones del constructor de Segments pueden diferir de la evaluación del pipeline de exportación.
Para exportaciones de API, espera a que el procesamiento termine antes de descargar. Usa callback_endpoint en /users/export/segment o consulta con retirada exponencial en lugar de solicitar la URL de inmediato.
Si sigues sin poder avanzar, contacta con soporte de Braze indicando el tipo de exportación (CSV o API), el ID de Segment o Campaign, la marca de tiempo (con zona horaria) y el mensaje de error exacto.

Destinos de almacenamiento

Usa las pestañas para seleccionar si estás exportando al contenedor de S3 predeterminado de Braze o a un partner de almacenamiento en el cloud. Para orientación sobre almacenamiento en el cloud, abre la pestaña Almacenamiento en el cloud conectado y revisa las secciones de CSV y API.

default export
cloud storage connected

Cuando no tienes un partner de almacenamiento marcado como destino de exportación predeterminado, Braze utiliza su propio contenedor de Amazon S3 para almacenar tus archivos de exportación. Los archivos en esta configuración son temporales y caducan a las cuatro horas.

Exportaciones CSV

Síntoma: llega un correo electrónico de exportación CSV del panel, pero el enlace de descarga falla, o la exportación nunca se completa.

Cuando exportas un CSV desde el panel, Braze envía por correo electrónico un enlace de descarga al usuario que ha iniciado sesión. Ese enlace apunta a un archivo ZIP alojado en el contenedor de S3 de Braze. Dentro del ZIP hay varios archivos más pequeños que, juntos, conforman tu exportación.

Debes haber iniciado sesión en el panel de Braze para usar el enlace, y el archivo solo está disponible durante cuatro horas. Después de eso, el enlace deja de funcionar y los datos se eliminan. Si se producen fallos repetidos con exportaciones muy grandes (más de 500 000 usuarios), la exportación puede fallar. En ese caso, intenta dividir tu exportación en grupos o campos más pequeños, o considera configurar un partner de almacenamiento.

Errores comunes

Si ves un error AccessDenied, es posible que el archivo ya haya caducado o que hayas intentado abrirlo antes de que estuviera listo. Los informes más grandes tardan más en generarse, así que espera unos minutos y vuelve a intentarlo.
Un error ExpiredToken significa que el plazo de cuatro horas ha vencido. Vuelve a ejecutar la exportación para generar un nuevo enlace.
El mensaje Looks like the file doesn't exist anymore suele aparecer cuando se envía el correo electrónico, pero el archivo no ha terminado de cargarse en S3. Por lo general, esperar unos minutos resuelve el problema.
Los apóstrofos que se añaden al principio de ciertos campos (como -, =, + o @) son un comportamiento esperado. Por ejemplo, -1943 se convierte en '-1943 en el CSV. Braze hace esto para evitar que los programas de hojas de cálculo interpreten erróneamente los datos. Esto no se aplica a las exportaciones JSON, como las devueltas por el endpoint /users/export/segment.

Exportaciones API

Síntoma: una llamada a la API de exportación tiene éxito, pero la URL de descarga falla o devuelve datos vacíos.

Cuando exportas a través de las API de exportación sin almacenamiento en el cloud, Braze escribe los archivos en su contenedor de S3. No recibirás ningún correo electrónico; en su lugar, la respuesta de la API incluye una URL de descarga temporal. La exportación se presenta como un archivo ZIP que contiene varios archivos JSON, cada uno con un usuario por línea.

Al igual que las exportaciones CSV, los enlaces de la API caducan a las cuatro horas. Si abres el enlace demasiado pronto, es posible que aparezcan errores porque el archivo aún no está listo. Puedes proporcionar un callback_endpoint en tu solicitud si deseas que Braze te avise cuando el archivo esté disponible.

Las exportaciones API de gran tamaño también pueden agotar el tiempo de espera. Si eso ocurre, intenta realizar solicitudes más pequeñas o conecta un partner de almacenamiento para gestionar el volumen.

Errores comunes

AccessDenied o ExpiredToken normalmente significan que el enlace ha caducado o aún no estaba listo. Vuelve a ejecutar la exportación o espera un poco más.

Cuando conectas un partner de almacenamiento (como Amazon S3, Google Cloud Storage o Azure Blob) y lo marcas como tu destino de exportación predeterminado desde la página Partners tecnológicos del panel, Braze escribe tus exportaciones directamente en tu contenedor. Esta configuración suele ser más fiable para exportaciones de mayor tamaño.

Exportaciones CSV

Síntoma: el enlace CSV enviado por correo electrónico falla, pero los archivos aparecen (o no aparecen) en tu contenedor conectado.

Con las exportaciones CSV, Braze te envía un enlace de descarga por correo electrónico. Ese enlace caduca tras un breve periodo de tiempo (normalmente unas cuatro horas). Cuando tienes un partner de almacenamiento conectado y marcado como tu destino de exportación predeterminado, Braze también entrega una copia de la exportación a tu contenedor conectado. Esa copia reside en tu propia infraestructura, donde la caducidad y la retención siguen tus políticas de almacenamiento.

En el almacenamiento en el cloud, las exportaciones CSV se agrupan en un archivo ZIP. Dentro del ZIP hay varios archivos CSV más pequeños. Las exportaciones grandes suelen dividirse en fragmentos (por ejemplo, unos 5000 usuarios cada uno), y el tamaño de los fragmentos puede variar. Los archivos más pequeños no indican que falten datos. Si el enlace enviado por correo electrónico falla, pero la copia en tu almacenamiento funciona, siempre puedes recuperar tus datos directamente desde tu contenedor.

Errores comunes

AccessDenied significa que Braze no pudo escribir en tu contenedor. Comprueba que tus credenciales y permisos siguen siendo válidos.
ExpiredToken aparece si Braze ha perdido el acceso a tu contenedor. Actualiza tus credenciales en el panel de Braze.
Si algunos archivos parecen más pequeños de lo esperado, es un comportamiento normal. El proceso de exportación divide los archivos intencionadamente para garantizar la estabilidad.
Los apóstrofos que se añaden al principio de ciertos campos (como -, =, + o @) son un comportamiento esperado. Por ejemplo, -1943 se convierte en '-1943 en el CSV. Braze hace esto para evitar que los programas de hojas de cálculo interpreten erróneamente los datos. Esto no se aplica a las exportaciones JSON, como las devueltas por el endpoint /users/export/segment.

Exportaciones API

Síntoma: las exportaciones API no aparecen en tu contenedor o los archivos están incompletos.

Cuando exportas datos a través de las API con un partner de almacenamiento conectado, los archivos exportados se escriben en tu contenedor. No se envía ningún correo electrónico. Los objetos subyacentes permanecen en tu almacenamiento y siguen tu configuración de retención, aunque las URL de descarga que devuelve Braze puedan seguir teniendo una duración limitada.

Los archivos suelen aparecer en tu contenedor a medida que se ejecuta la exportación, por lo que no necesitas esperar a que finalice todo el trabajo para acceder a resultados parciales. Braze carga cada lote completado de forma incremental en lugar de retener todo hasta el final. Las exportaciones grandes se dividen en varios archivos comprimidos (ZIP o GZIP), cada uno con objetos JSON, uno por línea. Esto hace que este método sea más fiable para exportaciones pesadas.

Errores comunes

AccessDenied ocurre cuando Braze no puede escribir en tu contenedor o los objetos se han eliminado posteriormente. Comprueba los permisos y confirma que ningún elemento externo esté borrando archivos.
ExpiredToken significa que las credenciales de acceso de Braze a tu contenedor están desactualizadas. Actualízalas en el panel.
Si faltan archivos o son más pequeños de lo esperado, primero confirma que nada fuera de Braze esté eliminando objetos. Los tamaños de archivo más pequeños son un comportamiento esperado.

Análisis de Campaign y Canvas

El número de usuarios en la exportación CSV no coincide con Mensajes enviados o Destinatarios únicos

Síntoma: La exportación CSV de una Campaign muestra un recuento de usuarios diferente al de Mensajes enviados o Destinatarios únicos en la página de análisis.

La exportación CSV de una Campaign puede mostrar un número de usuarios diferente al de Mensajes enviados y Destinatarios únicos por las siguientes razones:

La reelegibilidad está activada

Si los usuarios pueden (o pudieron en algún momento) recibir la Campaign más de una vez, las cifras de análisis de la Campaign y el número de filas en la exportación de datos de usuario no coinciden. Mensajes enviados cuenta cada envío, incluso cuando se envía un mensaje al mismo usuario más de una vez. La descarga de Exportar datos de usuario a CSV muestra usuarios únicos: una fila por perfil que recibió la Campaign, no una fila por envío. Por ejemplo, si Mensajes enviados es 12 y el CSV tiene 10 filas, esos 12 envíos fueron a 10 usuarios distintos (a algunos usuarios se les envió la Campaign más de una vez).

Se eliminaron o fusionaron usuarios desde que se envió la Campaign o el Canvas

La exportación CSV ofrece una instantánea de los usuarios existentes que recibieron una Campaign o un Canvas determinado. Dado que los usuarios pueden eliminarse o fusionarse, el recuento de la exportación CSV puede ser menor que el recuento de destinatarios únicos. Por ejemplo, si 1000 usuarios reciben una Campaign, la Campaign muestra 1000 destinatarios únicos y la exportación CSV de ese mismo día también muestra 1000 usuarios. Si un mes después se eliminan 50 de esos 1000 usuarios, la exportación CSV contiene 950 usuarios, mientras que el recuento acumulado de destinatarios únicos sigue siendo 1000.

Correos electrónicos de exportación de Segments del panel

El Segment es demasiado grande o la exportación falla cuando mi Segment parece tener menos de 500.000 usuarios

Síntoma: La exportación de Segments del panel falla o muestra un error de tamaño aunque la estimación del Segment parezca aceptable.

El tamaño de un Segment del panel es una estimación. La exportación CSV utiliza esa estimación para aplicar el límite de exportación de 500.000 usuarios; el proceso de exportación también puede evaluar el tamaño de forma diferente a la interfaz del creador de Segments. Si las exportaciones fallan para un Segment cercano a ese umbral, usa números de contenedor aleatorio o divide la audiencia en Segments más pequeños, o utiliza el endpoint /users/export/segment como se describe en Exportar Segments grandes.

¿Por qué no recibo correos electrónicos de exportación de Segments?

Síntoma: Se activó una exportación CSV de un Segment pero no llegó ningún correo electrónico.

Primero, revisa tu carpeta de correo no deseado en busca de un correo electrónico de [email protected]. Si el correo está ahí, añade esa dirección a tu lista de remitentes seguros para que los futuros mensajes de exportación no se filtren.

Si el correo no está en tu carpeta de correo no deseado, comprueba si otra persona de tu equipo puede recibir la exportación. Si tampoco pueden, considera el tamaño de tu exportación. El tiempo de entrega varía según el tamaño de la exportación, pero si el correo no ha llegado después de una hora, contacta con soporte de Braze.

Descargas de la API de exportación de Segments

No se puede descargar un ZIP de Segment exportado desde una URL de Braze

Síntoma: Un error 403 Forbidden al descargar desde la URL de respuesta de /users/export/segment.

Si recibes un error 403 Forbidden al usar el endpoint /users/export/segment, es posible que el archivo aún no esté listo. Las exportaciones grandes pueden tardar un tiempo en procesarse. Espera hasta una hora antes de intentar la descarga de nuevo.

Si usas un script automatizado para recuperar el archivo, también puedes recibir un error 403 Forbidden cuando solicitas la URL demasiado pronto. Si exportas datos de Segments con regularidad, considera conectar tu propia integración de contenedor de S3 y pasar los archivos a tu propio pipeline de extracción, transformación y carga (ETL).

Las exportaciones tardan en completarse, por lo que el acceso inmediato desde un script a menudo falla. Puedes:

Consultar la URL de descarga con retirada exponencial, o
Usar el parámetro callback_endpoint y apuntarlo a un servicio que ejecute tu script cuando la exportación esté lista.

Campos de la API de exportación de Segments y usuarios

Faltan columnas esperadas en un archivo de exportación de Segment

Síntoma: A una exportación de la API o del panel le faltan campos que esperabas.

La opción CSV Export User Data del panel desde un Segment utiliza un conjunto fijo de columnas (consulta Exportar datos de Segment a CSV). No incluye una columna ni un parámetro fields_to_export.

Para las exportaciones de Segments por API, debes pasar fields_to_export en el cuerpo de la solicitud. Algunos campos obtienen datos relacionados automáticamente; por ejemplo, solicitar canvases_received también requiere datos de resumen del recorrido en el perfil de usuario. Consulta la referencia del endpoint /users/export/segment para conocer los nombres de campos válidos y los requisitos.

Si faltan columnas en el archivo ZIP de una exportación de la API, confirma que el arreglo fields_to_export en tu solicitud incluye todos los campos que necesitas y que tu espacio de trabajo cuenta con los permisos de exportación requeridos.

Cuándo contactar con soporte

Contacta con soporte de Braze si has completado la ruta de investigación estándar y aún necesitas ayuda. Incluye el tipo de exportación, el ID de Segment o Campaign, la marca de tiempo (con zona horaria) y el mensaje de error exacto o el código de estado HTTP.

New Stuff!