Ir al contenido

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.

Comienza aquí: Identifica tu síntoma

Busca en la tabla el comportamiento que observas y luego ve a esa sección para realizar comprobaciones específicas.

Síntoma	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 API devuelve `403 Forbidden`	No puedo descargar un ZIP de Segment exportado
La exportación de Segment falla o indica que el Segment es demasiado grande	El Segment es demasiado grande
No se recibe ningún correo electrónico de exportación de Segment	Sin correo electrónico de exportación de Segment
El número de filas del CSV no coincide con el análisis de la campaña	Discrepancia en el 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. Empieza por el paso 1.

Confirma si vas a exportar al contenedor de S3 predeterminado de Braze o a un partner de almacenamiento en el cloud conectado. La caducidad de los enlaces y el comportamiento de reintento son distintos en cada caso.
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 del panel enviados por correo electrónico caducan a las cuatro horas, tanto si usas el contenedor predeterminado de Braze como un partner de almacenamiento conectado. Cuando hay un partner de almacenamiento conectado, Braze también entrega una copia en tu contenedor; esa copia sigue tus políticas de retención y puede seguir disponible después de que caduque el enlace del correo electrónico.
Para exportaciones de Segments grandes, confirma que la audiencia está por debajo del límite de exportación CSV del panel de 500 000 usuarios. Las estimaciones del creador de Segments pueden diferir de la evaluación del proceso de exportación.
Para exportaciones por API, espera a que termine el procesamiento antes de descargar. Usa callback_endpoint en /users/export/segment o consulta periódicamente con retirada exponencial en lugar de solicitar la URL inmediatamente.
Si sigues sin poder avanzar, ponte en contacto con el soporte de Braze e indica el tipo de exportación (CSV o API), el ID del Segment o de la campaña, 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 ni con Destinatarios únicos

Síntoma: La exportación CSV de una Campaign muestra un recuento de usuarios distinto 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 distinto de Mensajes enviados y Destinatarios únicos por estos motivos:

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 de 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 Exportar datos de usuario en CSV enumera usuarios únicos (una fila por cada 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 llegaron 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 determinados. Como los usuarios pueden eliminarse o fusionarse, el recuento de la exportación CSV puede ser inferior al 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 desde el 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 un Segment desde el panel falla o muestra un error de tamaño, aunque la estimación del Segment parezca aceptable.

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

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

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

Primero, revisa tu carpeta de correo no deseado y busca un correo 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 no puede, ten en cuenta 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, ponte en contacto con el soporte.

Descargas de la API de exportación de Segment

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

Síntoma: aparece 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 volver a intentar la descarga.

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

Las exportaciones tardan en completarse, por lo que el acceso inmediato desde un script suele fallar. Puedes:

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

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

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

Síntoma: Faltan campos que esperabas en una exportación desde la API o el panel.

La opción Exportar datos de usuario en CSV del panel para un Segment usa un conjunto fijo de columnas (consulta Exportar datos de Segment a CSV). No incluye ninguna columna ni parámetro fields_to_export.

En las exportaciones de Segment mediante la 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 ver los nombres de campo válidos y los requisitos.

Si faltan columnas en un ZIP de exportación de la API, confirma que la matriz fields_to_export de tu solicitud incluye todos los campos que necesitas y que tu espacio de trabajo usa los permisos de exportación necesarios.

Cuándo contactar con el soporte

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

New Stuff!