W tym przewodniku omawiamy pojęcia i konwencje nazewnictwa raportów dostępnych w interfejsie Google Ads na podstawie raportów, które można generować za pomocą języka Google Ads Query Language (GAQL) i interfejsu Google Ads API.
Typowe terminy dotyczące interfejsu
W tabeli poniżej znajdziesz zestawienie wybranych terminów używanych w interfejsie użytkownika wraz z ich mapowaniami na język zapytań Google Ads (GAQL).
Interfejs użytkownika | GAQL, |
---|---|
Kolumny | Dowolne zasoby, pole segmentu lub dane w klauzuli SELECT w zapytaniu GAQL. |
Zakres dat | Zakresy dat są mapowane na klauzulę WHERE filtrującą usługę segments.date . |
Filtry | Co najmniej 1 warunek w klauzuli WHERE. |
Pola dotyczące segmentów | Zastosuj podział na segmenty, uwzględniając pola segmentów w zapytaniu GAQL. |
Podział na strony | Etap dzieli zbiór 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, z którego możesz wybrać zakres dat dla tych statystyk.
W GAQL zapewniasz taką samą kontrolę, filtrując według segments.date
w klauzuli WHERE zapytania GAQL.
Filtry
Filtry w interfejsie są równoważne z co najmniej jednym warunkiem w klauzuli WHERE GAQL.
Podział na segmenty
Aby uzyskać bardziej szczegółowe statystyki, możesz podzielić dane według segmentów. Być może chcesz widzieć liczbę wyświetleń w sieci wyszukiwania Google niezależnie od sieci reklamowej Google. W takim przypadku należy podzielić 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 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ł wyników jest dostępny podczas pobierania raportów od GoogleAdsService.Search
do next_page_token
. Aby pobrać cały zbiór wyników bez podziału na strony, użyj metody GoogleAdsService.SearchStream
.
Wyniki zamówienia
W interfejsie możesz sortować wyniki, wybierając kolumnę.
W GAQL, aby uporządkować wynik zapytania, możesz użyć klauzuli ORDER BY i LIMIT.
Formaty pobierania
W interfejsie możesz pobierać raporty w różnych formatach, np. CSV, TSV lub XML.
Interfejs API nie obsługuje bezpośrednio różnych formatów w danych wyjściowych, więc trzeba będzie go przetworzyć. Zobacz przykładowy kod pokazujący, jak wdrożyć formatowanie CSV w kliencie.
Twórz harmonogramy raportów i wysyłaj je e-mailem
Planowanie generowania raportu i wysyłanie go e-mailem jest dostępne w interfejsie użytkownika, ale nie jest obsługiwane przez 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 nazwy 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 |
Sieć wyszukiwania – słowo kluczowe | 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 |
Na przykład z powyższej tabeli możesz wygenerować raport Konto za pomocą 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
Jedna z najczęstszych różnic między raportami interfejsu użytkownika a raportami interfejsu API jest taka, że interfejs API pośrednio odfiltrowuje usunięte elementy, a interfejs API – nie.
Aby powielić domyślny widok interfejsu, musisz dodać filtr, zwykle używając pola status
, który wykluczy usunięte wiersze, np.:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"