Exécuter des rapports de manière synchrone

Qu'est-ce qu'un rapport synchrone ?

Un rapport synchrone est un petit rapport qui doit s'exécuter très rapidement. Lorsque la plate-forme de création de rapports DCM reçoit une demande d'exécution d'un rapport synchrone, elle commence immédiatement à l'exécuter pour vous. Ces rapports sont plus adaptés aux situations où vous avez besoin rapidement d'un petit ensemble de données par exemple lorsque vous affichez des métriques dans une interface utilisateur graphique.

Quelle est la différence entre la génération de rapports synchrones et asynchrones ?

L'exécution d'un rapport de manière asynchrone prend toujours au moins quelques minutes, même si vous demandez une petite quantité de données. Les rapports synchrones renvoient ces données beaucoup plus rapidement, mais ils sont soumis à un délai d'inactivité court. Vous devez utiliser la génération de rapports asynchrones lorsque le rapport ne peut pas être exécuté dans le délai d'inactivité synchrone ou lorsque vous n'êtes pas dans un environnement sensible au temps, comme une interface utilisateur.

Quel est le délai d'inactivité des rapports synchrones ?

Si le rapport est suffisamment petit pour s'exécuter en 10 secondes ou moins, le système renvoie un fichier de rapport complet à votre demande d'exécution initiale. Sinon, la création de rapports DCM exécute votre rapport pendant 50 secondes avant de s'arrêter.

Que se passe-t-il si un rapport synchrone prend trop de temps ?

Si la génération d'un rapport synchrone ne se termine pas dans le délai d'inactivité, elle est interrompue et le rapport est transféré dans notre file d'attente de rapports asynchrones. Votre rapport n'échouera pas et ne renverra pas d'erreur, mais le fait de passer à la file d'attente de rapports asynchrones signifie qu'il faudra au moins quelques minutes pour le générer.

Vous ne recevrez aucune indication que votre rapport a dépassé le délai d'inactivité des rapports synchrones, à l'exception du temps de génération du rapport. Il se terminera de manière synchrone en 50 secondes ou moins, ou deviendra asynchrone et nécessitera plusieurs minutes.

Quels types de rapports sont compatibles avec l'exécution synchrone ?

Tous les types de rapports sont compatibles avec l'exécution synchrone, à l'exception des suivants :

  • Le rapport sur le chemin avant conversion, qui n'est jamais compatible avec les rapports synchrones.
  • Le rapport Floodlight, qui n'est compatible avec les rapports synchrones que si dfa:floodlightImpressions est exclu.

Les autres types de rapports sont tous compatibles avec l'exécution synchrone, mais ils expireront toujours si trop de données ou une combinaison de métriques et de dimensions gourmande en ressources sont utilisées.

Comment exécuter un rapport synchrone ?

Par défaut, tous les rapports s'exécutent de manière asynchrone. Lorsque vous demandez la génération d'un nouveau fichier de rapport, vous pouvez définir le paramètre facultatif synchronous sur true pour demander que le rapport soit exécuté de manière synchrone. Consultez l'exemple de code dans notre documentation.

Dois-je demander l'exécution synchrone de tous mes rapports ?

Non, vous ne devez demander l'exécution synchrone que lorsque vous vous attendez à ce que le rapport se termine dans le délai d'inactivité. Si votre rapport commence avec une exécution synchrone et atteint la limite de délai d'inactivité, il est déplacé vers la file d'attente asynchrone. Le temps d'exécution total du rapport correspond au temps nécessaire pour générer le rapport de manière asynchrone plus le délai d'inactivité synchrone. Ainsi, si vous aviez demandé le rapport de manière asynchrone, vous auriez évité le délai supplémentaire du délai d'inactivité synchrone.

Les métriques et les dimensions que je demande affectent-elles le temps de génération de mes rapports ?

Oui. Certaines métriques et dimensions prennent plus de temps à compiler que d'autres, et certaines d'entre elles peuvent même entraîner l'expiration systématique de vos rapports synchrones. Les dimensions géographiques sont un exemple de dimension qui sera rarement, voire jamais, assez rapide pour être incluse dans les rapports synchrones.

Comment réduire le temps nécessaire pour générer mes rapports afin d'autoriser les rapports synchrones ?

De nombreux facteurs, tels que la taille des campagnes incluses et la période couverte par le rapport, affectent la vitesse. Un ajustement manuel est souvent le meilleur moyen de réduire la taille de vos rapports. Commencez par tout ce que vous voulez pouvoir afficher rapidement, puis essayez de réduire le rapport jusqu'à ce qu'il se termine correctement de manière synchrone.