Raporty w interfejsie Google Ads

Interfejs Google Ads udostępnia funkcje raportowania. Aby utworzyć raport, zaloguj się na konto Google Ads. 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 w interfejsie, aby utworzyć raport, który najlepiej odpowiada Twoim potrzebom.

Narzędzia i zasoby

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

• Query Cookbook: zbiór zapytań GAQL, które odtwarzają dane widoczne na wielu typowych ekranach 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 w interfejsie

W tabeli poniżej znajdziesz podsumowanie niektórych typowych terminów używanych w interfejsie i ich mapowania na język Google Ads Query Language (GAQL).

Interfejs	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 segmentów	Aby zastosować segmentację, uwzględnij pola segmentów 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 tabeli statystyk.

Zakresy dat

Interfejs Google Ads zawiera tabelę z danymi statystycznymi konta 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 artykule Filtrowanie widoku danych o skuteczności.

Podział na segmenty

Aby uzyskać bardziej szczegółowe dane statystyczne, 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 segmentów w klauzuli SELECT, znajdziesz w artykule 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.

Przeglądanie wyników jest możliwe podczas pobierania raportów za pomocą GoogleAdsService.Search przez 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ć klauzuli ORDER BY i klauzuli LIMIT aby posortować wyniki zapytania.

Formaty pobierania

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

Interfejs API nie obsługuje bezpośrednio różnych formatów danych wyjściowych, dlatego musisz przeprowadzić pewne przetwarzanie końcowe. Zapoznaj się z tym przykładem kodu, który pokazuje, jak zaimplementować formatowanie CSV w kliencie.

Planowanie i wysyłanie raportów e-mailem

W interfejsie możesz zaplanować wysyłanie raportów 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 na temat położenia geograficznego	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ć raport o koncie, możesz użyć tego kodu GAQL:

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 z interfejsu z raportami z 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, musisz dodać filtr, zwykle za pomocą pola status, aby wykluczyć usunięte wiersze. Na przykład:

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'