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ęć i konwencji nazewnictwa w interfejsie Google Ads na raporty, które możesz generować za pomocą języka Google Ads Query Language (GAQL) i interfejsu Google Ads API. Możesz też postępować zgodnie z instrukcjami wyświetlanymi w interfejsie, aby utworzyć raport najlepiej odpowiadający Twoim potrzebom.

Narzędzia i zasoby

Więcej szczegółowych przykładów i automatycznej pomocy w mapowaniu ekranów interfejsu na interfejs API znajdziesz w tych materiałach:

• Query Cookbook: zbiór zapytań GAQL, które odtwarzają dane z wielu typowych ekranów interfejsu Google Ads.
• Google Ads API Reporting Extension: rozszerzenie do Chrome, które pomaga identyfikować nazwy zasobów i pól interfejsu Google Ads API bezpośrednio w interfejsie Google Ads.

Typowe terminy używane w interfejsie

W tabeli poniżej znajdziesz podsumowanie niektórych typowych terminów używanych w interfejsie i ich odpowiedników w języku Google Ads Query Language (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ą według segments.date.
Filtry	Co najmniej 1 warunek w klauzuli WHERE.
Pola segmentu	Aby zastosować podział na segmenty, uwzględnij pola segmentu w zapytaniu GAQL.
Podział na strony	Podział na strony dzieli zestaw wyników zapytania na kilka stron.

Kolumny

Kolumny w interfejsie są równoznaczne z użyciem klauzuli SELECT dla pól zasobów, pól segmentów lub danych w GAQL.

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

Zakresy dat

Interfejs Google Ads zawiera tabelę z danymi o koncie i menu, które umożliwia kontrolowanie zakresu dat tych danych.

W GAQL masz taką samą kontrolę, filtrując według segments.date w klauzuli WHERE zapytania GAQL.

Filtry

Filtry w interfejsie są równoznaczne z co najmniej 1 warunkiem w klauzuli WHERE w GAQL.

Więcej informacji znajdziesz w sekcji 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 zobaczyć liczbę wyświetleń w sieci wyszukiwania Google oddzielnie od sieci reklamowej Google. W takim przypadku podziel raport na segmenty według sieci. Więcej informacji o tym, jak uwzględnić pola segmentu w klauzuli SELECT, znajdziesz w sekcji Podział na segmenty.

Podział na strony

W interfejsie możesz poruszać się po raportach za pomocą elementów sterujących 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 przechodzić między stronami wyników podczas pobierania raportów, użyj GoogleAdsService.Search z next_page_token. Aby pobrać cały zestaw wyników bez podziału na strony, użyj GoogleAdsService.SearchStream.

Sortowanie wyników

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

W GAQL możesz użyć ORDER BY klauzuli i LIMIT klauzuli, aby sortować 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, dlatego aplikacja kliencka musi sformatować odpowiedź. Aby dowiedzieć się, jak zaimplementować formatowanie CSV w kliencie, zapoznaj się z przykładem kodu Raport kampanii do CSV sample.

Planowanie i wysyłanie raportów e-mailem

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

Mapowanie widoków interfejsu na zasoby interfejsu API

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

Widoki interfejsu	Nazwa zasobu GAQL (określ w klauzuli FROM)
Konto	customer
Kampania, Szczegóły kampanii	campaign
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ści 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ść > Gdzie wyświetlają 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, aby wygenerować zbiorczy raport o koncie z ostatnich 7 dni, możesz użyć tego zapytania GAQL (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

Podczas porównywania raportów interfejsu z raportami interfejsu API jedną z najczęstszych różnic jest to, że interfejs domyślnie filtruje usunięte jednostki, a interfejs API nie.

Aby odtworzyć domyślny widok interfejsu, dodaj filtr za pomocą pola 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'