Raporty w interfejsie

W tym przewodniku omawiamy pojęcia i konwencje nazewnictwa raportów dostępnych w interfejsie Google Ads na podstawie raportów, które można generować za pomocą języka Google Ads Query Language (GAQL) i interfejsu Google Ads API.

Typowe terminy dotyczące interfejsu

W tabeli poniżej znajdziesz zestawienie wybranych terminów używanych w interfejsie użytkownika wraz z ich mapowaniami na język zapytań Google Ads (GAQL).

Interfejs użytkownika GAQL,
Kolumny Dowolne zasoby, pole segmentu lub dane w klauzuli SELECT w zapytaniu GAQL.
Zakres dat Zakresy dat są mapowane na klauzulę WHERE filtrującą usługę segments.date.
Filtry Co najmniej 1 warunek w klauzuli WHERE.
Pola dotyczące segmentów Zastosuj podział na segmenty, uwzględniając pola segmentów w zapytaniu GAQL.
Podział na strony Etap dzieli zbiór 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, z którego możesz wybrać zakres dat dla tych statystyk.

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

Filtry

Filtry w interfejsie są równoważne z co najmniej jednym warunkiem w klauzuli WHERE GAQL.

Podział na segmenty

Aby uzyskać bardziej szczegółowe statystyki, możesz podzielić dane według segmentów. Być może chcesz widzieć liczbę wyświetleń w sieci wyszukiwania Google niezależnie od sieci reklamowej Google. W takim przypadku należy podzielić raport według sieci. Informacje o tym, jak uwzględnić pola segmentów w klauzuli SELECT, znajdziesz w sekcji Segmentacja.

Podział na strony

Możesz poruszać się po raportach w interfejsie za pomocą elementów sterujących dostępnych u dołu każdej tabeli danych. Umożliwiają one przełączanie stron i wybieranie liczby wyników do wyświetlenia z określonego zestawu rozmiarów.

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

Wyniki zamówienia

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

W GAQL, aby uporządkować wynik zapytania, możesz użyć klauzuli ORDER BY i LIMIT.

Formaty pobierania

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

Interfejs API nie obsługuje bezpośrednio różnych formatów w danych wyjściowych, więc trzeba będzie go przetworzyć. Zobacz przykładowy kod pokazujący, jak wdrożyć formatowanie CSV w kliencie.

Twórz harmonogramy raportów i wysyłaj je e-mailem

Planowanie generowania raportu i wysyłanie go e-mailem jest dostępne w interfejsie użytkownika, ale nie jest obsługiwane przez interfejs 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 ich pasujących nazwy 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
Sieć wyszukiwania – słowo kluczowe 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 z powyższej tabeli możesz wygenerować raport Konto za pomocą 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

Jedna z najczęstszych różnic między raportami interfejsu użytkownika a raportami interfejsu API jest taka, że interfejs API pośrednio odfiltrowuje usunięte elementy, a interfejs API – nie.

Aby powielić domyślny widok interfejsu, musisz dodać filtr, zwykle używając pola status, który wykluczy usunięte wiersze, np.:

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