Raporty w interfejsie Google Ads

Interfejs Google Ads udostępnia funkcje raportowania. Aby utworzyć raport, zaloguj się na konto Google Ads, w menu nawigacyjnym po lewej stronie kliknij Kampanie, a potem Statystyki i raporty. Aby utworzyć raport od zera, kliknij Edytor raportów.

Ten przewodnik zawiera mapowanie typowych pojęć związanych z raportowaniem i konwencji nazewnictwa w interfejsie Google Ads na raporty, które możesz generować za pomocą języka zapytań Google Ads (GAQL) i interfejsu Google Ads API. Możesz też postępować zgodnie z instrukcjami w interfejsie, aby utworzyć raport, który najlepiej odpowiada Twoim wymaganiom.

Narzędzia i zasoby

Bardziej szczegółowe przykłady i automatyczną pomoc w mapowaniu ekranów interfejsu użytkownika na API znajdziesz w tych materiałach:

Typowe terminy związane z interfejsem

W tabeli poniżej znajdziesz podsumowanie niektórych typowych terminów używanych w interfejsie i ich odpowiedników w języku zapytań Google Ads (GAQL).

UI GAQL
Kolumny Dowolny zasób, pole segmentu lub dane w klauzuli SELECT zapytania GAQL.
Zakres dat Zakresy dat są mapowane na klauzulę WHERE filtrującą dane według segments.date.
Filtry Co najmniej 1 warunek w WHERE klauzuli.
Pola segmentu Zastosuj segmentację, uwzględniając w zapytaniu GAQL pola segmentu.
Podział na strony Stronicowanie dzieli zestaw wyników zapytania na kilka stron.

Kolumny

Kolumny w interfejsie są odpowiednikiem klauzuli SELECT w przypadku pól zasobów, pól segmentów lub danych w GAQL.

Więcej informacji znajdziesz w artykule Kolumny w tabeli statystyk.

Zakresy dat

W interfejsie Google Ads znajduje się tabela ze statystykami konta i menu, w którym możesz wybrać zakres dat tych statystyk.

W GAQL możesz to samo osiągnąć, filtrując segments.date w klauzuli WHERE zapytania GAQL.

Filtry

Filtry w interfejsie są odpowiednikiem co najmniej 1 warunku w klauzuli WHERE GAQL.

Więcej informacji znajdziesz w artykule Filtrowanie widoku danych o skuteczności.

Podział na segmenty

Aby uzyskać bardziej szczegółowe statystyki, podziel dane na segmenty. Załóżmy na przykład, że chcesz wyświetlić liczbę wyświetleń w sieci wyszukiwania Google oddzielnie od liczby wyświetleń w sieci reklamowej Google. W takim przypadku podziel raport na segmenty według sieci. Więcej informacji o tym, jak uwzględniać pola segmentów w klauzuli SELECT, znajdziesz w sekcji Segmentacja.

Podział na strony

Poruszaj się po raportach w interfejsie, korzystając z opcji dostępnych u dołu każdej tabeli danych, które umożliwiają przełączanie stron i wybieranie liczby wyników do wyświetlenia z określonego zestawu rozmiarów.

Aby przeglądać wyniki podczas pobierania raportów, użyj symbolu GoogleAdsService.Search z symbolem next_page_token. Aby pobrać cały zestaw wyników bez podziału na strony, użyj GoogleAdsService.SearchStream.

Wyniki zamówienia

W interfejsie możesz uporządkować wyniki, wybierając kolumnę.

W GAQL możesz używać klauzuli ORDER BY i klauzuli LIMIT, aby porządkować i ograniczać wyniki zapytania.

Formaty pobierania

W interfejsie raporty można pobierać w różnych formatach, np. CSV, TSV lub XML.

Interfejs API nie formatuje bezpośrednio danych wyjściowych w plikach, takich jak CSV, więc aplikacja kliencka musi sformatować odpowiedź. Aby dowiedzieć się, jak wdrożyć formatowanie CSV w kliencie, zapoznaj się z przykładowym kodem raportu o kampanii w formacie CSV.

Planowanie i wysyłanie raportów e-mailem

Raport możesz zaplanować i wysłać e-mailem z interfejsu, ale te funkcje nie są obsługiwane w interfejsie API.

Mapowanie widoków interfejsu Map na zasoby interfejsu API

Oto lista typowych widoków interfejsu i odpowiadających im nazw zasobów GAQL.

Wyświetlenia interfejsu Nazwa zasobu GAQL
(określona w klauzuli FROM)
Konto klient
Kampania,
Szczegóły kampanii		 kampania
Grupa reklam,
Szczegóły grupy reklam		 ad_group
Reklama,
Końcowy URL		 ad_group_ad
Słowo kluczowe w sieci wyszukiwania keyword_view
Wyszukiwane hasła search_term_view
Płatne i bezpłatne
(szablon Widoczność na tle konkurencji)*		 paid_organic_search_term_view
Strona docelowa landing_page_view
Rozwinięty URL strony docelowej expanded_landing_page_view
Treść > Miejsca docelowe managed_placement_view
Treść > Gdzie wyświetlają się reklamy group_placement_view
Treści > Gdzie wyświetlały się reklamy > Wyświetl szczegóły detail_placement_view
Odbiorcy > Dane demograficzne > Wiek age_range_view
Odbiorcy > Dane demograficzne > Płeć gender_view
Lokalizacje location_view
Treść > Tematy topic_view
Lokalizacje > Raport geograficzny geographic_view

* Aby wygenerować raport Płatne i bezpłatne wyniki wyszukiwania, musisz połączyć konto Google Search Console z kontem Google Ads na poziomie klienta.

Na przykład na podstawie powyższej tabeli możesz użyć tego zapytania GAQL, aby wygenerować zagregowany raport o koncie z ostatnich 7 dni (jeśli chcesz, aby dane były podzielone według dnia, dodaj segments.date do klauzuli SELECT):

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

Typowe różnice

Jedną z najczęstszych różnic między raportami interfejsu a raportami interfejsu API jest to, że interfejs użytkownika niejawnie odfiltrowuje usunięte obiekty, a interfejs API tego nie robi.

Aby odtworzyć domyślny widok interfejsu, dodaj filtr z polem status, aby wykluczyć usunięte wiersze (lub wyraźnie uwzględnić jednostki ENABLED i PAUSED). Przykład:

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'
Wstecz
Paging
Dalej
Mapowanie parametrów ValueTrack w polach raportu