Informes síncronos

¿Qué es un informe síncrono?

Un informe síncrono es un informe pequeño que se debe ejecutar muy rápido. Cuando se recibe una solicitud para ejecutar un informe síncrono, la plataforma de informes de DCM comenzará a ejecutarlo de inmediato. Este tipo de informes se usan mejor en situaciones en las que necesitas un pequeño fragmento de datos con rapidez, como cuando muestras métricas en una interfaz gráfica de usuario.

¿Cuál es la diferencia entre la generación de informes síncronos y asíncronos?

Ejecutar un informe de forma asíncrona siempre tomará al menos unos minutos, incluso si solicitas una pequeña cantidad de datos. Los informes síncronos muestran estos datos mucho más rápido, a costa de un tiempo de espera bajo para el tiempo que lleva ejecutar el informe. Deberías usar la generación asíncrona de informes cuando no se pueda ejecutar dentro del tiempo de espera síncrono o cuando no estés en un entorno urgente, como una interfaz de usuario.

¿Cuál es el tiempo de espera del informe síncrono?

Si el informe es lo suficientemente pequeño como para ejecutarlo en 10 segundos o menos, el sistema mostrará un archivo de informe completo en tu solicitud de ejecución inicial. De lo contrario, los informes de DCM ejecutarán su informe durante un período de 50 segundos antes de que se agote el tiempo de espera.

¿Qué sucede si un informe síncrono tarda demasiado?

Si la generación de un informe síncrono no se completa dentro del tiempo de espera, la generación se detiene y el informe se conmuta por error a nuestra cola de informes asíncronos. Tu informe no fallará ni mostrará un error, pero pasar a la cola de informes asíncronos implicará que tu informe tardará unos minutos en generarse.

No recibirás ninguna indicación de que el informe superó el tiempo de espera del informe síncrono, excepto por el tiempo de generación del informe. Se completará de forma síncrona en 50 segundos o menos o se volverá asíncrona y requerirá varios minutos.

¿Qué tipos de informes admiten la ejecución síncrona?

Todos los tipos de informes admiten la ejecución síncrona, excepto:

Los otros tipos de informes admiten la ejecución síncrona, pero se agotará el tiempo de espera si se usan demasiados datos o una combinación de métricas y dimensiones que usan muchos recursos.

¿Cómo puedo ejecutar un informe síncrono?

De forma predeterminada, todos los informes se ejecutan de forma asíncrona. Cuando solicites la generación de un archivo de informe nuevo, puedes configurar el parámetro opcional synchronous como true para solicitar que el informe se ejecute de forma síncrona. Consulta el código de ejemplo en nuestra documentación.

¿Debo solicitar todos mis informes con ejecución síncrona?

No, solo debes solicitar la ejecución síncrona cuando esperas que el informe termine en el tiempo de espera. Si tu informe comienza con la ejecución síncrona y alcanza el límite de tiempo de espera, el informe se moverá a la cola asíncrona, es decir, el tiempo total de ejecución del informe será el tiempo necesario para generar el informe de forma asíncrona y el período de tiempo de espera síncrono. Por lo tanto, si hubieras solicitado el informe de forma asíncrona, habrías evitado el retraso adicional del período de tiempo de espera síncrono.

¿Las métricas y dimensiones que solicito afectarán el tiempo de generación de mis informes?

Sí. Ciertas métricas y dimensiones demoran más en compilarse que otras, y algunas de ellas incluso pueden hacer que se agote el tiempo de espera de tus informes síncronos. Las dimensiones geográficas son una de esas dimensiones que rara vez serán lo suficientemente rápidas como para incluirse en los informes síncronos.

¿Cómo puedo acortar el tiempo necesario para generar mis informes a fin de permitir la generación de informes síncronos?

Muchos factores, como el tamaño de las campañas incluidas y el período que abarca el informe, afectan la velocidad. Un poco de ajuste manual suele ser la mejor manera de lograr que tus informes se incluyan en fragmentos lo suficientemente pequeños. Comienza con todo lo que quieras que pueda mostrarse rápidamente y, luego, intenta reducirlo hasta que se complete de forma síncrona.