Raporty w interfejsie

Ten przewodnik mapuje pojęcia i konwencje nazewnictwa raportów w interfejsie Google Ads na potrzeby raportów, które możesz generować za pomocą języka Google Ads Query Language (GAQL) i interfejsu Google Ads API.

Często używane terminy związane z interfejsem użytkownika

W tabeli poniżej znajdziesz podsumowanie niektórych często używanych terminów używanych w interfejsie oraz ich mapowania do języka zapytań Google Ads (GAQL).

Interfejs użytkownika	Ocena GAQL
Kolumny	Dowolny zasób, pole segmentu lub dane w klauzuli SELECT zapytania GAQL.
Zakres dat	Zakresy dat są mapowane na filtrowanie klauzuli WHERE w segments.date.
Filtry	Co najmniej jeden warunek w klauzuli WHERE.
Pola segmentu	Zastosuj podział na segmenty, uwzględniając pola segmentów w zapytaniu GAQL.
Podział na strony	Pozycja na stronie służy do podziału zbioru wyników zapytania na wiele stron.

Kolumny

Kolumny w interfejsie odpowiadają polom zasobów, polom segmentu i wskaźnikom w GAQL.

Filtrowanie

Zakresy dat

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

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

Filtry

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

Podział na segmenty

Aby uzyskać bardziej szczegółowe statystyki, możesz podzielić dane według segmentów. Możesz na przykład chcieć sprawdzić liczbę wyświetleń w sieci wyszukiwania Google niezależnie od sieci reklamowej Google. W takim przypadku podzielisz raport na segmenty według sieci. Informacje o uwzględnianiu pól segmentów w klauzuli SELECT znajdziesz w sekcji Segmentacja.

Podział na strony

Do poruszania się po raportach w interfejsie służą elementy sterujące dostępne u dołu każdej tabeli danych. Umożliwiają one przełączanie stron i wybieranie liczby wyników do wyświetlenia w określonym zestawie rozmiarów.

Podział wyników na strony jest dostępny podczas pobierania raportów za pomocą od GoogleAdsService.Search do next_page_token. Aby pobrać cały zestaw wyników bez podziału na strony, użyj polecenia GoogleAdsService.SearchStream.

Wyniki wyszukiwania

Możesz sortować wyniki w interfejsie, wybierając kolumnę.

W GAQL możesz uporządkować wyniki zapytania za pomocą klauzul ORDER BY i LIMIT.

Formaty pobierania

Raporty z interfejsu użytkownika można pobierać w różnych formatach, np. CSV, TSV czy XML.

Interfejs API nie obsługuje bezpośrednio różnych formatów w wynikach, więc trzeba to zrobić później. Zobacz przykładowy kod pokazujący, jak wdrożyć formatowanie CSV w kliencie.

Planowanie generowania raportów i wysyłanie ich e-mailem

Planowanie generowania raportu i wysyłanie go e-mailem 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 wraz z ich nazwą zasobu GAQL.

Podstawowe wstępnie zdefiniowane raporty	Nazwa zasobu GAQL (określ 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	paid_organic_search_term_view
Strona docelowa,	landing_page_view
Rozwinięta strona docelowa	expanded_landing_page_view

Na przykład w powyższej tabeli możesz wygenerować raport dotyczący konta, korzystając z tego 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

Gdy porównujemy raporty w interfejsie z raportami interfejsu API, jedna z najczęstszych różnic polega na tym, że interfejs pośrednio odfiltrowuje usunięte elementy, a interfejs API nie.

Jeśli chcesz odtworzyć domyślny widok interfejsu, musisz dodać filtr, zwykle przy użyciu pola status, aby wykluczyć usunięte wiersze, np.:

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