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"