Skip to content

Solución de problemas de exportación

Esta página cubre situaciones comunes de solución de problemas para exportaciones tanto en flujos de trabajo CSV como API.

Utiliza las pestañas para seleccionar si deseas exportar al contenedor de S3 predeterminado de Braze o a un socio de almacenamiento en la nube.

Cuando no tienes un socio 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

Cuando exportas un archivo CSV desde el dashboard, 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 dashboard de Braze para utilizar el enlace, y el archivo solo estará 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), es posible que la exportación falle. En ese caso, intenta dividir tu exportación en grupos o campos más pequeños, o considera configurar un socio 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 punto de conexión /users/export/segment.

Exportaciones API

Cuando exportas a través de las API de exportación sin almacenamiento en la nube, 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 haces clic en 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 socio 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 socio 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 Socios tecnológicos del dashboard, Braze escribe tus exportaciones directamente en tu contenedor. Esta configuración suele ser más fiable para exportaciones de mayor tamaño.

Exportaciones CSV

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 socio 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 la nube, 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 dashboard 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 punto de conexión /users/export/segment.

Exportaciones API

Cuando exportas datos a través de las API con un socio 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. Cada archivo ZIP contiene objetos JSON, uno por línea. Las exportaciones de gran tamaño pueden dividirse en varios archivos ZIP en lugar de un único ZIP, lo que generalmente 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 dashboard.
  • 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 campañas y Canvas

El número de usuarios en la exportación CSV no coincide con Messages Sent o Unique Recipients

La exportación CSV de una campaña puede mostrar un número de usuarios diferente al de Messages Sent y Unique Recipients por las siguientes razones:

La reelegibilidad está activada

Si los usuarios pueden (o pudieron en algún momento) recibir la campaña más de una vez, las cifras de análisis de la campaña y el número de filas en la exportación de datos de usuario no coinciden. Messages Sent cuenta cada envío, incluso cuando el mismo usuario recibe el mensaje más de una vez. La descarga de Exportación de datos de usuario a CSV enumera usuarios únicos: una fila por perfil que recibió la campaña, no una fila por envío. Por ejemplo, si Messages Sent es 12 y el CSV tiene 10 filas, esos 12 envíos se dirigieron a 10 usuarios distintos (algunos usuarios recibieron la campaña más de una vez).

Se eliminaron o fusionaron usuarios desde que se envió la campaña o Canvas

La exportación CSV ofrece una instantánea de los usuarios existentes que recibieron una campaña o Canvas determinados. Dado que los usuarios pueden eliminarse o fusionarse, el recuento de la exportación CSV puede ser inferior al de destinatarios únicos. Por ejemplo, si 1000 usuarios reciben una campaña, esta 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 Segment del dashboard

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

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 puede, 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, ponte en contacto con Soporte.

Descargas de la API de exportación de Segment

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

Si obtienes un error 403 Forbidden al utilizar el punto de conexión /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 utilizas 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 Segment de forma regular, considera conectar tu propia integración con un 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 suele fallar. Puedes:

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