Raportowanie

Raporty zawierają informacje o wszystkich zasobach na koncie. Możesz pobierać informacje o kampaniach, grupach reklam i ich statystykach, zmieniać historię konta itp. Infrastruktura raportowania korzysta z interfejsu Google Ads API i używa GAQL do określenia jakie pola, dane i warunki chcesz skonfigurować.

Istnieją 2 główne mechanizmy raportowania. W obu przypadkach akceptowane są takie same i różnią się głównie sposobem, w jaki zwracają wyniki.

W obu przypadkach użyjemy następującego zapytania:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
Wyświetli to płaskie, podobne do słownika wyniki wyszukiwania wyników. Możesz uzyskiwać dostęp do pól, jak w przypadku słownika, takiego jak row["campaign.id"] i row["metrics.impressions"] bezpośrednio. Za pomocą tego możesz wyeksportować wyniki bezpośrednio do arkusza kalkulacyjnego za pomocą Metoda exportToSheet(). To nie jest format natywny, w którym wyniki są zwracane przez interfejs Google Ads API, więc w niektórych przypadkach niektóre pola mogą być niedostępne. w tym formacie. W takim przypadku użyj zamiast niego search.
AdsApp.search()
Zwróci to listę GoogleAdsRow obiektów, które mają różne pola, które mogą zawierać pola podrzędne. Będziesz więc mieć dostęp do row.campaign.id i row.metrics.impressions, aby pobrać dane. Jest to bardziej przydatne, jeśli zamierzasz przetwarzać dane w sposób zautomatyzowany, a niektóre pola mogą być dostępne w formacie search, jeśli nie można ich przekonwertować na stałą wartość reprezentacja.
.
.

Przykład raportu

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

Zwróć uwagę na: AdsApp.report dokumentacji ze szczegółowymi informacjami na temat korzystania z tego widoku.

Przykład wyszukiwania

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

Zapoznaj się z pełnym Adsapp.search dokumentacji ze wszystkimi możliwymi ustawieniami.