Język zapytań Search Ads 360

Język zapytań Search Ads 360 umożliwia tworzenie zapytań wyszukiwania, które umożliwiają pobieranie danych raportowania i metadanych zasobów za pomocą interfejsu Search Ads 360 Reporting API.

Wyszukaj usługi

W języku zapytań Search Ads 360 możesz wysyłać zapytania do interfejsu API za pomocą:

SearchAds360Service

Używaj tego serwisu do wysyłania zapytań dotyczących zasobów i powiązanych z nimi atrybutów, segmentów i danych. Możesz to zrobić na 2 sposoby: Search i SearchStream.

Zapytanie SearchAds360Service zwraca listę SearchAds360Row instancji:

  • Każdy wiersz reprezentuje zasób.
  • W razie potrzeby wiersze zawierają atrybuty i pola danych.
  • Jeśli żądasz segmentów, w przypadku każdego ciągu segment–zasób zostaną uwzględnione dodatkowe wiersze.

Więcej informacji znajdziesz w artykule Tworzenie raportów wyszukiwania.

SearchAds360FieldService

Używaj tej usługi do wysyłania zapytań o metadane dotyczące dostępnych pól i zasobów. Usługa udostępnia katalog pól, do których można wykonać zapytania, wraz ze specyfikacjami dotyczącymi ich zgodności i typu.

Funkcja SearchAds360FieldService zwraca listę instancji SearchAds360Field:

  • Każde pole zawiera szczegółowe informacje na temat żądanego pola.

Aby dowiedzieć się więcej, zapoznaj się z artykułem Pobieranie metadanych zasobów.

Przykłady podstawowych zapytań

W sekcjach poniżej znajdziesz podstawowe przykłady zapytań, które możesz dostosowywać do tworzenia własnych zapytań.

Zapytanie o atrybuty zasobu

To podstawowe zapytanie o atrybuty zasobu campaign, które zwraca identyfikator, nazwę i stan kampanii:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • Każdy zwrócony obiekt SearchAds360Row odpowiada obiektowi campaign.
  • Wiersze są wypełniane wybranymi polami (w tym resource_name danej kampanii).
  • Zapytanie z uwzględnieniem identyfikatora kampanii.

Inne dostępne pola, których możesz używać w zapytaniach, znajdziesz w sekcji campaign.

Wysyłanie zapytań o dane

To jest podstawowe zapytanie o wskaźniki związane z atrybutami zasobu campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • Zapytanie zwraca kampanie o stanie PAUSED i ponad 1000 wyświetleń.
  • Każdy z zwróconych obiektów SearchAds360Row ma pole metrics wypełnione wybranymi danymi.
  • Zapytanie z uwzględnieniem identyfikatora kampanii.

Inne dostępne dane, których możesz używać w zapytaniach, znajdziesz w sekcji metrics.

Wykonywanie zapytań dotyczących segmentów

Oto podstawowe zapytanie dotyczące segmentów powiązanych z atrybutami zasobu campaign:

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
  • Zapytanie zwraca kampanie o stanie PAUSED i ponad 1000 wyświetleń.
  • Dane są dzielone na segmenty według daty.
  • W wyniku podziału każdy element SearchAds360Row reprezentuje tuplę kampanii i segmentu dat.
  • Zapytanie z uwzględnieniem identyfikatora kampanii.

Więcej informacji o podziałach na segmenty w raportach znajdziesz w artykule Podział na segmenty.segments

To jest podstawowe zapytanie dotyczące zasobu campaign, które łączy atrybuty zasobu bidding_strategy, jeśli są dostępne. Ten typ powiązanego zasobu jest nazywany przypisanym zasobem.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • Zapytanie wybiera atrybuty kampanii i powiązane atrybuty z każdej wybranej kampanii.
  • Każdy zwrócony atrybut SearchAds360Row reprezentuje obiekt campaign uzupełniony wybranymi atrybutami kampanii, a także wybranym atrybutem strategii ustalania stawek: bidding_strategy.name.

Informacje o tym, które przypisane zasoby są dostępne na potrzeby zapytań dotyczących kampanii, znajdziesz w sekcji campaign.

Zapytanie o metadane pola

Aby pobrać metadane pola, możesz użyć polecenia SearchAds360FieldService.

Oto podstawowe zapytanie dotyczące metadanych pola:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Zastąp ZASOB LUB POLE zasobem (np. customer lub campaign) albo polem (np. campaign.id, metrics.impressions lub ad_group.id).

Więcej informacji o pobieraniu metadanych pól znajdziesz w artykule Pobieranie metadanych zasobów.

Więcej informacji

Dowiedz się więcej o tworzeniu zapytań w interfejsie Search Ads 360 Reporting API: