Raporty w interfejsie

W tym przewodniku pokazujemy pojęcia i konwencje nazewnictwa raportów w interfejsie Google Ads, które możesz generować za pomocą języka zapytań Google Ads i interfejsu Google Ads API.

Typowe terminy interfejsu

Poniższa tabela zawiera zestawienie niektórych popularnych terminów używanych w interfejsie użytkownika oraz ich mapowania na język zapytań Google Ads (GAQL).

Interfejs użytkownika GAQL
Kolumny Dowolny zasób, pole segmentu lub dane w klauzuli SELECT zapytania GAQL.
Zakres dat Zakresy dat są mapowane na klauzulę WHERE filtrowaną według wartości 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 Podział na strony dzieli zestaw wyników zapytania na wiele stron.

Kolumny

Kolumny w interfejsie użytkownika są równoważne z polami zasobów, polami segmentów i danymi w GAQL.

Filtrowanie

Zakresy dat

W interfejsie Google Ads dostępne są tabele ze statystykami konta oraz menu rozwijane do kontrolowania zakresu dat tych statystyk. W usłudze GAQL masz taką samą kontrolę dzięki filtrowaniu według pozycji segments.date w klauzuli WHERE zapytania GAQL.

Filtry

Filtry w interfejsie są zgodne z co najmniej jednym warunkiem w klauzuli WHERE w GAQL.

Podział na segmenty

Aby uzyskać bardziej szczegółowe statystyki, możesz podzielić dane według segmentów. Na przykład interesują Cię informacje o liczbie wyświetleń w sieci wyszukiwania Google niezależnie od sieci reklamowej Google. W takim przypadku trzeba posegmentować 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 użytkownika za pomocą elementów sterujących dostępnych u dołu każdej tabeli z danymi, które umożliwiają przełączanie stron i wybieranie liczby wyników do wyświetlenia ze zdefiniowanego zestawu rozmiarów.

Pobieranie raportów z GoogleAdsService.Search umożliwia przeglądanie wyników za pomocą next_page_token w sposób podobny do interfejsu użytkownika.

Możesz jednak użyć GoogleAdsService.SearchStream, aby pobrać całe zestawy wyników bez podziału na strony.

Zamawianie

W interfejsie możesz posortować wyniki według określonej kolumny, wybierając ją. W GAQL możesz użyć klauzuli ORDER BY i LIMIT, aby zmienić wynik zapytania.

Formaty pobierania

Można pobierać raporty w interfejsie użytkownika w różnych formatach (CSV, TSV, XML itd.). Interfejs API nie obsługuje formatowania ani generowania danych wyjściowych. Możesz skorzystać z jednego z tych przykładów raportowania w Twoim przypadku:

Oto przykład z funkcją formatowania CSV w kliencie:

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

Planowanie raportów i wysyłanie ich e-mailem jest dostępne w interfejsie użytkownika, ale nie jest obsługiwane przez interfejs API.

Wstępnie zdefiniowane raporty

Listę wstępnie zdefiniowanych raportów możesz utworzyć w interfejsie Google Ads. Oto lista podstawowych wstępnie zdefiniowanych raportów i odpowiadających im nazw zasobów GAQL.

Wstępnie zdefiniowane raporty podstawowe Nazwa zasobu GAQL
(Określ w klauzuli FROM)
Konto klient
Campaign,
Szczegóły kampanii
kampania
Grupa reklam,
Szczegóły grupy reklam
ad_group [grupa_reklam]
Reklama,
Końcowy URL
ad_group_ad (grupa reklam)
Szukaj słowa kluczowego keyword_view
wyszukiwanego hasła. wyszukiwane_hasło
Płatne i bezpłatne paid_organic_search_term_view
Strona docelowa landing_page_view
Rozwinięty adres URL strony docelowej expanded_landing_page_view

W przykładzie z tabeli powyżej możesz wygenerować raport dotyczący konta za pomocą 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

Aby uruchomić powyżej GAQL w interfejsie API, skorzystaj z jednego z poniższych przykładów raportowania:

Typowe różnice

Jedną z najczęstszych różnic w przypadku raportów dotyczących interfejsu z raportami interfejsu API jest to, że domyślnie odfiltrowuje on usunięte elementy, a interfejs API nie.

Aby powielić domyślny widok interfejsu, musisz dodać filtr (zwykle używając pola status), by wykluczyć usunięte wiersze.

Jeśli na przykład pobierasz kampanie, możesz użyć takiego zapytania:

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