Język zapytań Google Ads

Język zapytań Google Ads może wysyłać zapytania do interfejsu Google Ads API

Zasoby i powiązane z nimi atrybuty, segmenty i dane za pomocą
GoogleAdsService Wyszukiwarka lub SearchStream
Wyniki zapytania Google AdsService zawiera listę wystąpień GoogleAdsRow, przy czym każdy zasób GoogleAdsRow reprezentuje zasób. Jeśli wymagane są jakiekolwiek atrybuty lub dane, wiersz zawiera również te pola. Jeśli zażądano segmentów, w odpowiedzi pojawi się też dodatkowy wiersz dla każdej grupy zasobów zasobu.
Metadane dotyczące dostępnych pól i zasobów w
GoogleAdsFieldService

Ta usługa zawiera katalog pól, których można wysłać, a także szczegółowe informacje o ich zgodności i typie.

Wynik zapytania GoogleAdsFieldService to lista instancji GoogleAdsField, przy czym każda sekcja GoogleAdsField zawiera szczegółowe informacje o żądanym polu.

Zapytanie o atrybuty zasobu

Poniżej przedstawiamy podstawowe zapytanie dotyczące atrybutów zasobu kampanii, ilustrujące sposób zwracania identyfikatora, nazwy i stanu kampanii:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

To zapytanie jest uporządkowane według identyfikatora kampanii. Każdy wynik GoogleAdsRow będzie reprezentować obiekt campaign zawierający wybrane pola (w tym ten resource_name).

Aby dowiedzieć się, jakie inne pola są dostępne w przypadku zapytań dotyczących kampanii, zapoznaj się z dokumentacją referencyjną Campaign.

Zapytanie o wskaźniki

Oprócz wybranych atrybutów danego zasobu możesz też wysyłać zapytania dotyczące powiązanych wskaźników:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

To zapytanie filtruje tylko kampanie, które mają stan PAUSED i uzyskały ponad 1000 wyświetleń, uporządkowane według identyfikatora kampanii. W każdym wyniku GoogleAdsRow znajdowałoby się pole metrics z wybranymi danymi.

Listę danych, których można użyć do wysyłania zapytań, znajdziesz w dokumentacji usługi Metrics.

Zapytania o segmenty

Oprócz wybranych atrybutów danego zasobu możesz też wysyłać zapytania dotyczące powiązanych segmentów:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

Podobnie jak w przypadku zapytań o dane, to zapytanie filtruje tylko kampanie, które mają stan PAUSED i miały ponad 1000 wyświetleń. Jednak zapytanie to dzieli dane według daty. Dzięki temu każdy wynik GoogleAdsRow będzie mnogością kampanii i datą Segment. Pamiętaj, że podział na segmenty dzieli wybrane dane według grupowania w klauzuli SELECT.

Listę segmentów, które można wysyłać do zapytań, znajdziesz w dokumentacji narzędzia Segments.

W zapytaniu dotyczącym danego zasobu możesz dołączyć do innych powiązanych zasobów, jeśli są dostępne. Te powiązane materiały są nazywane "przypisanymi zasobami&quot. Możesz dołączyć bezpośrednio do przypisanych zasobów, wybierając atrybut w zapytaniu.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

To zapytanie nie tylko wybiera atrybuty kampanii, ale też pobiera powiązane atrybuty z każdej wybranej kampanii. Każdy wynik GoogleAdsRow jest obiektem campaign, który uzupełnia wybrane atrybuty kampanii, a także atrybut wybranej strategii ustalania stawek bidding_strategy.name.

Aby sprawdzić, jakie zasoby są dostępne w przypadku zapytań dotyczących kampanii, zapoznaj się z dokumentacją referencyjną Campaign.

Mutacja na podstawie wyników zapytania

Wykonując zapytania o konkretny zasób, możesz od razu pobrać zwrócone wyniki jako obiekty, zmodyfikować je i wysłać z powrotem do metody mutacji w tej usłudze. Oto przykładowy przepływ pracy:

  1. Wyślij zapytanie do wszystkich kampanii, które są obecnie PAUSED i których liczba wyświetleń jest większa niż 1000.
  2. Pobierz obiekt Campaign z pola campaign każdego elementu GoogleAdsRow w odpowiedzi.
  3. Zmień stan każdej kampanii z PAUSED na ENABLED.
  4. Aby je zaktualizować, wywołaj CampaignService.MutateCampaigns ze zmienionymi kampaniami.

Metadane pola

Zapytania wysyłane do GoogleAdsFieldService służą do pobierania metadanych pól. Dzięki temu możesz się dowiedzieć, jak można używać pól w poszczególnych zapytaniach. Dane są dostępne w interfejsie API i dostarczają metadane niezbędne do sprawdzania i kompilowania zapytania, dzięki czemu programiści mogą to zrobić w sposób zautomatyzowany. Oto typowe zapytanie o metadane:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Zapytanie <INSERT_RESOURCE_OR_FIELD> w tym zapytaniu możesz zastąpić zasobem (takim jak customer lub campaign) albo polem (takim jak campaign.id, metrics.impressions lub ad_group.id).

Listę pól, do których można wysyłać zapytania, znajdziesz w dokumentacjiGoogleAdsField.

Przykłady kodu

Biblioteki klienta zawierają przykłady użycia języka zapytań Google Ads w języku GoogleAdsService. Folder Operacje podstawowe zawiera przykłady, takie jak GetCampaigns, GetKeywords i SearchForGoogleAdsFields. Folder reporting zawiera przykład GetKeywordStats.