Raporty w interfejsie

Ten przewodnik zawiera omówienie koncepcji i konwencji nazewnictwa raportów w interfejsie Google Ads do raportów, które można generować za pomocą języka Google Ads Query Language (GAQL) za pomocą interfejsu Google Ads API.

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

W poniższej tabeli znajdziesz podsumowanie niektórych często używanych terminów w interfejsie i mapowania na Google Ads Query Language (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 WHERE klauzulę w tabeli 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	Metoda Paging dzieli zbiór wyników zapytanie na wielu stronach.

Kolumny

Kolumny w interfejsie są takie same jak Zasób pola, Segment oraz Dane w GAQL.

Filtrowanie

Zakresy dat

W interfejsie Google Ads znajduje się tabela ze statystykami konta oraz menu kontrolować zakres dat dla tych statystyk.

W GAQL masz taką samą kontrolę po zastosowaniu filtra segments.date w klauzuli WHERE na potrzeby GAQL zapytania.

Filtry

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

Podział na segmenty

Aby uzyskać bardziej szczegółowe statystyki, możesz podzielić dane według segmentów. Przykład: może zainteresować Cię liczba wyświetleń konkretnych reklam w sieci wyszukiwania Google i sieci reklamowej Google. W tym przypadku posegmentujesz raport według sieci. Zobacz Segmentacja uwzględniania pól segmentów w klauzuli SELECT.

Podział na strony

Do poruszania się po raportach służą elementy sterujące dostępne na na dole każdej tabeli danych, która umożliwia przełączanie się między stronami i wybór liczby wyników do wyświetlenia ze zdefiniowanego zestawu rozmiarów.

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

Wyniki wyszukiwania

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

Można użyć instrukcji ORDER BY klauzula i LIMIT klauzula aby uporządkować wynik zapytania.

Formaty pobierania

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

Interfejs API nie obsługuje bezpośrednio różnych formatów w danych wyjściowych, które wymagają obróbki. Zobacz przykładowy kod pokazujący, jak zaimplementować formatowanie CSV w .

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

Planowanie wysyłania raportu i wysyłanie go e-mailem jest dostępne w interfejsie, ale nie jest obsługiwane w 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 zasobów GAQL Nazwa.

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 tabeli powyżej można użyć poniższego GAQL do wygenerowania Raport dotyczący konta:

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, że interfejs użytkownika niejawnie odfiltrowuje usunięte elementy, a interfejs API nie.

Aby odtworzyć domyślny widok interfejsu, musisz dodać filtr. Zwykle za pomocą pola status, aby wykluczyć usunięte wiersze, np.:

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