Übersicht über die Berichterstellung

Die Campaign Manager 360 API bietet verschiedene Möglichkeiten, Daten für Anzeigen abzurufen, die über Campaign Manager 360 getraffickt wurden.

Berichtsdienst

Das Generieren von Berichten mit dem Reports-Dienst umfasst einen mehrstufigen Workflow zum Konfigurieren, Generieren und Abrufen von Berichtsdateien (z. B. im CSV- oder Excel-Format). Dies ist der Standardberichtspfad für die Campaign Manager 360 API und eignet sich für große Datasets, automatisierte geplante Skripts oder Downstream-Anwendungen, die Dateien nutzen.

Der Workflow besteht in der Regel aus den folgenden Schritten:

  1. Definieren oder suchen Sie eine Report-Ressource (mit Dimensionen, Messwerten, Zeiträumen und Filtern), die mit einer eindeutigen Berichts-ID gespeichert ist. Weitere Informationen finden Sie unter Berichte erstellen und aktualisieren.
  2. Rufen Sie die Methode reports.run auf, um Berichte zu erstellen. Dadurch wird die Ausführung des Berichts in die Warteschlange gestellt und eine Platzhalterressource File zurückgegeben. Weitere Informationen finden Sie unter Berichte suchen und erstellen.
  3. Prüfen Sie regelmäßig den Status der File-Ressource. Da dieser Prozess asynchron abläuft, beginnt der Status einer Datei mit PROCESSING und wechselt zu REPORT_AVAILABLE, wenn der Vorgang abgeschlossen ist. Weitere Informationen finden Sie unter Berichte suchen und erstellen.
  4. Rufen Sie den Dateiinhalt (CSV oder Excel) ab, sobald die Berichterstellung abgeschlossen ist. Weitere Informationen finden Sie unter Berichte herunterladen.

Berichte synchron ausführen

Wenn Sie eine Berichtsdatei (CSV oder Excel) für eine kleine Datenmenge erstellen müssen, können Sie den Bericht synchron ausführen, indem Sie die Methode reports.run mit dem Parameter synchronous auf true aufrufen. Die API versucht, den Bericht innerhalb eines kurzen Zeitlimits zu generieren. Wenn die Ausführung länger dauert, wird der Berichtslauf automatisch auf die asynchrone Warteschlange zurückgesetzt.

Weitere Informationen finden Sie unter Synchrone Berichte.

Berichtsdaten abfragen

Mit der Methode reportData.query können Sie Berichtsdaten direkt abfragen, anstatt eine Berichtsdatei zu generieren.

  • Anstatt eine Report-Ressource zu erstellen und zu speichern, geben Sie Dimensionen, Messwerte und andere Filter- oder Sortierkriterien direkt in der Anfrage an.
  • Die Antwort enthält strukturierte Berichtsdaten, sodass keine generierte Datei abgerufen und heruntergeladen werden muss.
  • Die Anfrage wird synchron mit einem Limit von 60 Sekunden ausgeführt.

Weitere Informationen finden Sie unter JSON-Berichtsdaten abfragen.