Présentation des rapports

L'API Campaign Manager 360 offre plusieurs façons de récupérer des données pour les annonces suivies dans Campaign Manager 360.

Service Reports

La génération de rapports à l'aide du service Reports implique un workflow en plusieurs étapes pour configurer, générer et récupérer des fichiers de rapport (au format CSV ou Excel, par exemple). Il s'agit du chemin de création de rapports standard pour l'API Campaign Manager 360. Il convient aux ensembles de données volumineux, aux scripts programmés automatisés ou aux applications en aval qui consomment des fichiers.

Le workflow comprend généralement les étapes suivantes :

  1. Définissez ou recherchez une ressource Report (en spécifiant les dimensions, les métriques, les plages de dates et les filtres) qui est enregistrée avec un ID de rapport unique. Consultez Créer et mettre à jour des rapports.
  2. Exécutez la génération de rapports en appelant la reports.run méthode. Cette opération met en file d'attente l'exécution du rapport et renvoie une ressource File espace réservé. Consultez Trouver et générer des rapports.
  3. Vérifiez régulièrement l'état de la ressource File. Étant donné que ce processus s'exécute de manière asynchrone, l'état d'un fichier commence par PROCESSING et passe à REPORT_AVAILABLE une fois l'opération terminée. Consultez Trouver et générer des rapports.
  4. Récupérez le contenu du fichier (CSV ou Excel) une fois la génération du rapport terminée. Consultez Télécharger des rapports.

Exécuter des rapports de manière synchrone

Si vous devez générer un fichier de rapport (CSV ou Excel) pour une petite quantité de données, vous pouvez exécuter le rapport de manière synchrone en appelant la reports.run méthode avec le paramètre synchronous défini sur true. L'API tente de générer le rapport dans un bref délai. Si l'exécution prend plus de temps, l'exécution du rapport revient automatiquement à la file d'attente asynchrone.

Pour en savoir plus, consultez Rapports synchrones.

Interroger les données de rapport

Utilisez la méthode reportData.query pour interroger directement les données de rapport au lieu de générer un fichier de rapport.

  • Au lieu de créer et d'enregistrer une ressource Report, vous spécifiez les dimensions, les métriques et d'autres critères de filtrage ou de tri directement dans la requête.
  • La réponse contient des données de rapport structurées, ce qui élimine la nécessité d'interroger et de télécharger un fichier généré.
  • La requête s'exécute de manière synchrone avec une limite de 60 secondes.

Pour en savoir plus, consultez Interroger des données de rapport JSON.