Omówienie raportowania

Interfejs Campaign Managera 360 API udostępnia kilka sposobów pobierania danych o reklamach trafikowanych przez Campaign Managera 360.

Usługa raportowania

Generowanie raportów za pomocą usługi Reports obejmuje wieloetapowy proces konfigurowania, generowania i pobierania plików raportów (np. w formacie CSV lub Excel). Jest to standardowa ścieżka raportowania w przypadku interfejsu Campaign Manager 360 API, która sprawdza się w przypadku dużych zbiorów danych, zautomatyzowanych skryptów zaplanowanych lub aplikacji podrzędnych, które korzystają z plików.

Proces ten zwykle obejmuje te etapy:

  1. Zdefiniuj lub znajdź Report zasób (określając wymiary, dane, zakresy dat i filtry), który jest zapisany z unikalnym identyfikatorem raportu. Przeczytaj artykuł Tworzenie i aktualizowanie raportów.
  2. Uruchom generowanie raportu, wywołując metodę reports.run. Spowoduje to umieszczenie raportu w kolejce i zwrócenie zastępczego Filezasobu. Zobacz Znajdowanie i generowanie raportów.
  3. Okresowo sprawdzaj stan zasobu File. Ponieważ ten proces jest uruchamiany asynchronicznie, stan pliku będzie początkowo oznaczony jako PROCESSING, a po zakończeniu procesu zmieni się na REPORT_AVAILABLE. Zobacz Znajdowanie i generowanie raportów.
  4. Pobierz zawartość pliku (CSV lub Excel) po wygenerowaniu raportu. Zobacz Pobieranie raportów.

Uruchamianie raportów synchronicznie

Jeśli chcesz wygenerować plik raportu (CSV lub Excel) dla niewielkiej ilości danych, możesz uruchomić raport synchronicznie, wywołując metodę reports.run z parametrem synchronous ustawionym na true. Interfejs API próbuje wygenerować raport w krótkim okresie limitu czasu. Jeśli wykonanie trwa dłużej, raport jest automatycznie przenoszony do kolejki asynchronicznej.

Więcej informacji znajdziesz w artykule Raporty synchroniczne.

Dane raportu zapytania

Użyj metody reportData.query, aby wysyłać zapytania o dane raportowania bezpośrednio, zamiast generować plik raportu.

  • Zamiast tworzyć i zapisywać zasób Report, możesz określić wymiary, dane i inne kryteria filtrowania lub sortowania bezpośrednio w żądaniu.
  • Odpowiedź zawiera uporządkowane dane raportu, co eliminuje konieczność sondowania i pobierania wygenerowanego pliku.
  • Żądanie jest wykonywane synchronicznie z limitem 60 sekund.

Więcej informacji znajdziesz w artykule Wykonywanie zapytań dotyczących danych raportu JSON.