Raporty w interfejsie Google Ads

W tym przewodniku znajdziesz informacje o koncepcjach i konwencjach nazewnictwa raportów w interfejsie Google Ads, które możesz generować za pomocą języka zapytań Google Ads (GAQL) i interfejsu Google Ads API.

Typowe terminy dotyczące interfejsu

W tabeli poniżej podano niektóre typowe terminy używane w interfejsie użytkownika oraz ich odwzorowanie w języku zapytań Google Ads (GAQL).

Interfejs	GAQL
Kolumny	dowolny zasób, pole segmentu lub dane w nawiasie SELECT zapytania GAQL;
Zakres dat	Zakresy dat są mapowane na klauzulę WHERE, która filtruje według kolumny segments.date.
Filtry	co najmniej 1 warunek w klauzuli WHERE.
Pola segmentu	Stosuj segmentację, uwzględniając pola segmentów w zapytaniu GAQL.
Podział na strony	Paginacja dzieli zbiór wyników zapytania na kilka stron.

Kolumny

Kolumny w interfejsie są odpowiednikami pól Zasoby, pól Segment i danych w GAQL.

Filtrowanie

Możesz filtrować i porządkować dane w raportach.

Zakresy dat

Interfejs Google Ads zawiera tabelę ze statystykami konta oraz menu, w którym można określić zakres dat tych statystyk.

W GAQL masz te same możliwości, filtrując według kolumny segments.date w nawiasach klamrowych WHERE zapytania GAQL.

Filtry

Filtry w interfejsie są równoważne co najmniej 1 warunkowi w klauzuli WHERE w GAQL.

Podział na segmenty

Aby uzyskać bardziej szczegółowe statystyki, podziel dane według segmentów. Załóżmy na przykład, że chcesz zobaczyć liczbę wyświetleń w sieci wyszukiwania Google oddzielnie od liczby wyświetleń w sieci reklamowej Google. W takim przypadku posegmentuj raport według sieci. Więcej informacji o uwzględnianiu pól segmentów w klauzuli SELECT znajdziesz w artykule Podział na segmenty.

Podział na strony

Przechodzenie między raportami w interfejsie 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 wyświetlanych wyników z określonego zbioru rozmiarów.

Przeglądanie wyników jest dostępne podczas pobierania raportów z GoogleAdsService.Search na next_page_token. Aby pobrać cały zbiór wyników bez podziału na strony, użyj parametru GoogleAdsService.SearchStream.

Zamawianie 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 możesz pobierać raporty w różnych formatach, np. CSV, TSV czy XML.

Interfejs API nie obsługuje bezpośrednio różnych formatów w danych wyjściowych, więc musisz wykonać dodatkowe przetwarzanie. Zapoznaj się z tym przykładem kodu, który pokazuje, jak zaimplementować formatowanie CSV w kliencie.

Planowanie i wysyłanie raportów e-mailem

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

Wstępnie zdefiniowane raporty

W interfejsie Google Ads możesz utworzyć listę wstępnie zdefiniowanych raportów.

Oto lista podstawowych wstępnie zdefiniowanych raportów i odpowiadających im nazw zasobów GAQL.

Podstawowe wstępnie zdefiniowane raporty	Nazwa zasobu GAQL (określ ją w klauzuli FROM)
Konto	customer
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	paid_organic_search_term_view
Strona docelowa	landing_page_view
Rozwinięty URL strony docelowej	expanded_landing_page_view

Na przykład w przypadku tabeli z poprzedniej tabeli możesz użyć tego zapytania GAQL, aby wygenerować raport Konto:

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

Porównując raporty interfejsu użytkownika z raportami interfejsu API, warto zwrócić uwagę na jedną z najczęstszych różnic: interfejs użytkownika domyślnie odfiltrowuje usunięte elementy, a interfejs API nie.

Aby odtworzyć domyślny widok interfejsu, musisz dodać filtr, zazwyczaj za pomocą pola status, aby wykluczyć usunięte wiersze. Na przykład:

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