Ejecuta informes de forma síncrona

¿Qué es un informe síncrono?

Un informe síncrono es un informe pequeño que debe ejecutarse muy rápido. Cuando recibas una solicitud para ejecutar un informe síncrono, la plataforma de informes de DCM comenzará a ejecutarlo de inmediato. Los informes como estos son más útiles en situaciones en las que necesitas una pequeña cantidad de datos rápidamente, como cuando muestras métricas en una interfaz gráfica de usuario.

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

La ejecución asíncrona de un informe siempre tardará al menos unos minutos, incluso si solicitas una pequeña cantidad de datos. Los informes síncronos devuelven estos datos mucho más rápido, pero tienen un tiempo de espera bajo sobre cuánto puede tardar en ejecutarse el informe. Debes usar la generación de informes asíncrona cuando el informe no se pueda ejecutar dentro del período de espera síncrono o cuando no te encuentres en un entorno sensible al tiempo, como una interfaz de usuario.

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

Si el informe es lo suficientemente pequeño como para ejecutarse en 10 segundos o menos, el sistema devolverá un archivo de informe completo a tu solicitud de ejecución inicial. De lo contrario, la generación de informes de DCM ejecutará tu 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 período de espera, se detiene y el informe se transfiere a nuestra cola de informes asíncronos. Tu informe no fallará ni devolverá un error, pero pasar a la cola de informes asíncronos significa que ahora tardará al menos unos minutos en generarse.

No recibirás ninguna indicación de que tu informe excedió el período de espera de informes síncronos, aparte del tiempo de generación del informe. Se completará de forma síncrona en 50 segundos o menos, o bien 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 siguientes:

Todos los demás 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 consumen muchos recursos.

¿Cómo ejecuto un informe síncrono?

De forma predeterminada, todos los informes se ejecutan de forma asíncrona. Cuando solicitas la generación de un nuevo archivo de informe, puedes establecer el parámetro opcional synchronous en 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 esperes que el informe finalice dentro del período de tiempo de espera. Si tu informe comienza con una ejecución síncrona y alcanza el límite de tiempo de espera, se moverá a la cola asíncrona. El tiempo total de ejecución del informe será el tiempo necesario para generarlo de forma asíncrona más el período de tiempo de espera síncrono. Por lo tanto, si hubieras solicitado el informe de forma asíncrona, habrías evitado la demora 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í. Algunas métricas y dimensiones tardan más en compilarse que otras, y algunas incluso pueden hacer que tus informes síncronos siempre agoten el tiempo de espera. Las dimensiones geográficas son un ejemplo de dimensión que rara vez, o nunca, será lo suficientemente rápida como para incluirse en informes síncronos.

¿Cómo puedo reducir el tiempo necesario para generar mis informes y 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. A menudo, la mejor manera de reducir tus informes a fragmentos lo suficientemente pequeños es realizar algunos ajustes manuales. Comienza con todo lo que quieras poder mostrar rápidamente y, luego, intenta reducir el informe hasta que se complete de forma síncrona.