Ten przewodnik zawiera omówienie pojęć i konwencji nazewnictwa stosowanych w raportach w interfejsie Google Ads oraz ich odpowiedników w raportach, które można generować za pomocą języka zapytań Google Ads (GAQL) i interfejsu Google Ads API.
Typowe terminy używane w interfejsie
W tabeli poniżej znajdziesz podsumowanie typowych terminów używanych w interfejsie oraz ich odpowiedników w języku zapytań Google Ads (GAQL).
| UI | GAQL |
|---|---|
| Kolumny | Dowolny zasób, pole segmentu lub dane w klauzuli SELECT zapytania GAQL. |
| Zakres dat | Zakresy dat odpowiadają klauzuli WHERE
filtrującej według segments.date. |
| Filtry | Co najmniej 1 warunek w klauzuli WHERE. |
| Pola segmentu | Aby zastosować podział na segmenty, uwzględnij pola segmentu w zapytaniu GAQL. |
| Podział na strony | Podział na strony dzieli zestaw wyników zapytania na kilka stron. |
Kolumny
Kolumny w interfejsie odpowiadają polom zasobów, polom segmentów i danym w GAQL.
Filtrowanie
Dane w raportach możesz filtrować i porządkować.
Zakresy dat
W interfejsie Google Ads znajduje się tabela z danymi statystycznymi konta oraz menu, które umożliwia określenie zakresu dat tych danych.
W GAQL masz taką samą kontrolę, filtrując według
segments.date w klauzuli WHERE zapytania GAQL.
Filtry
Filtry w interfejsie odpowiadają co najmniej 1 warunkowi w klauzuli WHERE w GAQL.
Podział na segmenty
Aby uzyskać bardziej szczegółowe dane statystyczne, podziel dane na segmenty. Załóżmy na przykład, że chcesz wyświetlić liczbę wyświetleń w sieci wyszukiwania Google oddzielnie od liczby wyświetleń w sieci reklamowej Google. W takim przypadku podziel raport na segmenty według sieci. Więcej informacji o tym, jak uwzględnić pola segmentu w klauzuli SELECT, znajdziesz w artykule Podział na segmenty.
Podział na strony
W interfejsie możesz poruszać się po raportach 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ł na strony jest dostępny podczas pobierania raportów za pomocą
GoogleAdsService.Search przez
next_page_token. Aby pobrać cały zestaw wyników
bez podziału na strony, użyj
GoogleAdsService.SearchStream.
Sortowanie 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 raporty można pobierać w różnych formatach, np. CSV, TSV lub XML.
Interfejs API nie obsługuje bezpośrednio różnych formatów danych wyjściowych, dlatego musisz przeprowadzić pewne przetwarzanie końcowe. Zapoznaj się z tym przykładem kodu, który pokazuje, jak zaimplementować formatowanie CSV w kliencie.
Planowanie i wysyłanie raportów e-mailem
W interfejsie możesz zaplanować wysyłanie raportów e-mailem, 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 w klauzuli FROM) |
|---|---|
| Konto | customer |
| Kampania, Szczegóły kampanii |
campaign |
| 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 |
| Treść > Miejsca docelowe | managed_placement_view |
| Treść > Gdzie wyświetlają się reklamy | group_placement_view |
| Treść > Gdzie wyświetlają się reklamy > Wyświetl szczegóły | detail_placement_view |
Na przykład, aby wygenerować raport o koncie, możesz użyć 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
Typowe różnice
Podczas porównywania raportów z interfejsu z raportami z interfejsu API jedną z najczęstszych różnic jest to, że interfejs domyślnie filtruje usunięte jednostki, a interfejs API nie.
Aby odtworzyć domyślny widok interfejsu, musisz dodać filtr, zwykle za pomocą pola status, aby wykluczyć usunięte wiersze. Na przykład:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"