Raporty w interfejsie

Ten przewodnik przedstawia powiązania między pojęciami i konwencjami nazewnictwa raportów w interfejsie Google Ads a raportami, 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 podsumowaliśmy niektóre typowe terminy używane w interfejsie użytkownika oraz ich odwzorowanie w języku zapytań Google Ads (GAQL).

Interfejs użytkownika	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 zasobów, pól segmentów i danych w GAQL.

Filtrowanie

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, możesz podzielić dane na segmenty. Możesz np. chcieć zobaczyć liczbę wyświetleń w sieci wyszukiwania Google osobno od liczby wyświetleń w sieci reklamowej Google. W takim przypadku możesz posegmentować 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

Pomiędzy raportami w interfejsie możesz się poruszać za pomocą elementów sterujących dostępnych u dołu każdej tabeli danych. Umożliwiają one przełączanie się między stronami 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 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 konieczne będzie przeprowadzenie dodatkowego przetwarzania. Zobacz przykład kodu pokazujący, jak zastosować formatowanie CSV w kliencie.

Planowanie i wysyłanie raportów e-mailem

Planowanie i wysyłanie e-maila z raportami jest dostępne w interfejsie użytkownika, ale nie jest 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 tabeli powyżej możesz użyć tego zapytania GAQL, aby wygenerować raport Konta:

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 użytkownika, 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"