Rapports synchrones

Qu'est-ce qu'un rapport synchrone ?

Un rapport synchrone est un petit rapport qui doit être généré très rapidement. Lorsqu'elle reçoit une requête d'exécution d'un rapport synchrone, la plate-forme de création de rapports DCM commence immédiatement à l'exécuter pour vous. Rapports similaires Elles sont plus adaptées lorsque vous avez besoin d'un petit bloc de données rapidement, par exemple lorsque vous affichez des métriques dans une interface utilisateur de commande.

Quelle est la différence entre la génération de rapports synchrone et asynchrone ?

L'exécution asynchrone d'un rapport nécessite toujours au moins quelques minutes, même si vous demandez une petite quantité de données. Synchrone les rapports renvoient ces données beaucoup plus rapidement, au prix d'une le délai d'exécution du rapport. Vous devez utiliser génération de rapport asynchrone lorsque le rapport ne peut pas être exécuté dans le avant expiration synchrone ou lorsque vous n'êtes pas dans une période comme une interface utilisateur.

Quel est le délai d'expiration pour un rapport synchrone ?

Si le rapport est suffisamment petit pour être exécuté en 10 secondes ou moins, renvoie un fichier de rapport complet à votre demande d'exécution initiale. Sinon, les rapports DCM exécuteront votre rapport pendant 50 secondes avant d'expirer.

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

Si la génération d'un rapport synchrone n'est pas terminée dans le délai avant expiration, la génération est interrompue et le rapport bascule dans notre file d'attente de rapports asynchrones. Votre rapport ne échouera pas et ne renverra pas d'erreur, mais le passage dans la file d'attente de rapports asynchrones signifie que la génération de votre rapport prendra désormais au moins quelques minutes.

Vous ne recevrez aucune indication que votre rapport a dépassé le délai avant expiration des rapports synchrones, sauf l'heure de génération du rapport. Elle sera effectuée de manière synchrone en 50 secondes ou moins, ou deviendra asynchrone et prendra plusieurs minutes.

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

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

Les autres types de rapports sont tous compatibles avec l'exécution synchrone, s'il y a trop de données ou si un ensemble de métriques et de ressources gourmandes en ressources sont utilisées.

Comment exécuter un rapport synchrone ?

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

Dois-je demander tous mes rapports avec une exécution synchrone ?

Non, vous ne devez demander une exécution synchrone que lorsque vous prévoyez que le rapport sera terminé dans le délai avant expiration. Si votre rapport commence avec une exécution synchrone et que le délai avant expiration est atteint, le rapport placé dans la file d'attente asynchrone, c'est-à-dire l'exécution totale du rapport "time" correspond au temps nécessaire pour générer le rapport de manière asynchrone, plus le délai avant expiration synchrone. Ainsi, si vous aviez demandé le rapport de manière asynchrone, vous auriez évité le délai supplémentaire le délai avant expiration synchrone.

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

Oui. Le traitement de certaines métriques et dimensions prend plus de temps que d'autres, et certains d'entre eux peuvent même provoquer les rapports expirent toujours. Les dimensions géographiques sont un exemple de dimension qui sera rarement, voire jamais, assez rapide pour être incluse dans des rapports synchrones.

Comment réduire le temps nécessaire pour générer mon pour générer des rapports synchrones ?

De nombreux facteurs, tels que la taille des campagnes incluses et la période couverte par le rapport, ont une incidence sur la vitesse. Quelques notions manuelles L'ajustement est souvent le meilleur moyen de réduire le volume de vos rapports. en partant de zéro. Commencez par tout ce que vous voulez pouvoir afficher rapidement, puis essayez de réduire le rapport jusqu'à ce qu'il soit terminé. de manière synchrone.