Interfejs Google Ads udostępnia funkcje raportowania. Aby utworzyć raport, zaloguj się na konto Google Ads, w menu nawigacyjnym po lewej stronie kliknij Kampanie, a potem kliknij Statystyki i raporty. Aby utworzyć raport od podstaw, kliknij Edytor raportów.
Ten przewodnik mapuje typowe pojęcia i konwencje nazewnictwa dotyczące raportowania w interfejsie Google Ads na raporty, które możesz generować za pomocą języka Google Ads Query Language (GAQL) i interfejsu Google Ads API. Możesz też postępować zgodnie z instrukcjami w interfejsie, aby utworzyć raport, który najlepiej odpowiada Twoim potrzebom.
Narzędzia i zasoby
Więcej szczegółowych przykładów i automatyczną pomoc w mapowaniu ekranów interfejsu na interfejs API znajdziesz w tych materiałach:
- Query Cookbook: kolekcja zapytań GAQL, które odtwarzają dane widoczne na wielu popularnych ekranach interfejsu Google Ads.
- Google Ads API Reporting Extension: rozszerzenie do Chrome, które pomaga identyfikować nazwy zasobów i pól interfejsu Google Ads API bezpośrednio w interfejsie Google Ads.
Typowe terminy związane z interfejsem
W tabeli poniżej znajdziesz podsumowanie niektórych typowych terminów używanych w interfejsie oraz ich odpowiedników w języku Google Ads Query Language (GAQL).
| UI | GAQL |
|---|---|
| Kolumny | Dowolny zasób, pole segmentu lub dane w klauzuli SELECT zapytania GAQL. |
| Zakres dat | Zakresy dat są mapowane na klauzulę WHERE, która filtruje dane według segments.date. |
| Filtry | Co najmniej 1 warunek w klauzuli WHERE. |
| Pola segmentu | Zastosuj segmentację, dodając do zapytania GAQL pola segmentu. |
| Podział na strony | Stronicowanie dzieli zbiór wyników zapytania na wiele stron. |
Kolumny
Kolumny w interfejsie odpowiadają użyciu klauzuli SELECT w przypadku pól zasobów, pól segmentów lub danych w GAQL.
Więcej informacji znajdziesz w artykule Kolumny w tabeli statystyk.
Zakresy dat
W interfejsie Google Ads znajduje się tabela ze statystykami konta oraz menu, które umożliwia określanie zakresu dat tych statystyk.
W GAQL masz taką samą kontrolę, ponieważ możesz filtrować według segments.date w klauzuli WHERE zapytania GAQL.
Filtry
Filtry w interfejsie odpowiadają co najmniej 1 warunkowi w klauzuli WHERE języka GAQL.
Więcej informacji znajdziesz w artykule Filtrowanie widoku danych o skuteczności.
Podział na segmenty
Aby uzyskać bardziej szczegółowe statystyki, podziel dane według segmentów. Załóżmy na przykład, że chcesz zobaczyć 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ędniać pola segmentów w klauzuli SELECT, znajdziesz w artykule o segmentacji.
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, które umożliwiają przełączanie stron i wybieranie liczby wyników do wyświetlenia z określonego zestawu rozmiarów.
Aby przeglądać wyniki podczas pobierania raportów, użyj GoogleAdsService.Search z next_page_token. Aby pobrać cały zestaw wyników bez podziału na strony, użyj GoogleAdsService.SearchStream.
Wyniki zamówienia
W interfejsie możesz porządkować wyniki, wybierając kolumnę.
W GAQL możesz używać klauzuli ORDER BY i klauzuli LIMIT, aby porządkować i ograniczać wyniki zapytania.
Formaty pobierania
W interfejsie raporty można pobierać w różnych formatach, np. CSV, TSV lub XML.
Interfejs API nie formatuje bezpośrednio danych wyjściowych do plików takich jak CSV, więc aplikacja kliencka musi sformatować odpowiedź. Aby dowiedzieć się, jak zaimplementować formatowanie CSV w kliencie, zapoznaj się z przykładowym kodem raportu kampanii w formacie CSV.
Planowanie i wysyłanie raportów e-mailem
Możesz zaplanować raport i wysłać go e-mailem z poziomu interfejsu, ale te funkcje nie są obsługiwane w interfejsie API.
Mapowanie widoków interfejsu na zasoby interfejsu API
Oto lista typowych widoków interfejsu i odpowiadających im nazw zasobów GAQL.
| Widoki interfejsu | Nazwa zasobu GAQL (określona 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 (szablon widoczności na tle konkurencji)* |
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 |
| Odbiorcy > Dane demograficzne > Wiek | age_range_view |
| Odbiorcy > Dane demograficzne > Płeć | gender_view |
| Lokalizacje | location_view |
| Treść > Tematy | topic_view |
| Lokalizacje > Raport geograficzny | geographic_view |
* Aby wygenerować raport Płatne i bezpłatne, musisz połączyć konto Google Search Console z kontem Google Ads na poziomie klienta.
Na przykład, korzystając z powyższej tabeli, możesz użyć tego zapytania GAQL, aby wygenerować zagregowany raport dotyczący konta z ostatnich 7 dni (jeśli chcesz, aby dane były podzielone według dni, dodaj segments.date do klauzuli SELECT):
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 odfiltrowuje usunięte elementy, a interfejs API tego nie robi.
Aby odtworzyć domyślny widok interfejsu, dodaj filtr, który używa pola status do wykluczania usuniętych wierszy (lub do wyraźnego uwzględniania elementów ENABLED i PAUSED). Przykład:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'