Język zapytań Search Ads 360

Język zapytań Search Ads 360 umożliwia tworzenie zapytań do pobierania danych raportowania i metadanych zasobów za pomocą interfejsu Search Ads 360 Reporting API.

Wyszukaj usługi

Zapytanie do interfejsu API możesz wykorzystać w języku zapytań Search Ads 360:

SearchAds360Service

Ta usługa pozwala wysyłać zapytania o zasoby oraz powiązane z nimi atrybuty, segmenty i wskaźniki. Są 2 metody: Search i SearchStream.

Zapytania SearchAds360Service zwraca listę instancji SearchAds360Row:

  • Każdy wiersz odpowiada zasobowi.
  • W razie potrzeby wiersze zawierają atrybuty i pola danych.
  • Jeśli poprosisz o segmenty, dla każdej krotki zasobu segmentu zostaną uwzględnione dodatkowe wiersze.

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

SearchAds360FieldService

Ta usługa służy do wysyłania zapytań o metadane dotyczące dostępnych pól i zasobów. Usługa udostępnia katalog pól, o których można wykonywać zapytania, wraz ze szczegółowymi informacjami na temat ich zgodności i typu.

SearchAds360FieldService zwraca listę instancji SearchAds360Field:

  • Każde pole zawiera szczegółowe informacje o żądanym polu.

Więcej informacji znajdziesz w artykule Pobieranie metadanych zasobów.

Przykłady podstawowych zapytań

W sekcjach poniżej znajdziesz podstawowe przykłady zapytań, które możesz dostosować, aby tworzyć własne zapytania.

Zapytanie o atrybuty zasobu

To jest 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 SearchAds360Row odpowiada obiektowi campaign.
  • Wiersze zawierają wybrane pola (w tym resource_name danej kampanii).
  • Zapytanie o zamówienia według identyfikatora kampanii.

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

Zapytanie o wskaźniki

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 zwrócony wynik SearchAds360Row ma pole metrics wypełnione wybranymi danymi.
  • Zapytanie o zamówienia według identyfikatora kampanii.

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

Zapytanie dotyczące segmentów

To jest podstawowe zapytanie o segmenty związane 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ą segmentowane według daty.
  • W efekcie podziału na segmenty każdy element SearchAds360Row reprezentuje kropkę kampanii i segment dat.
  • Zapytanie o zamówienia według identyfikatora kampanii.

Listę segmentów, których możesz używać w zapytaniach, znajdziesz w sekcji segments. Więcej informacji o segmentowaniu raportów znajdziesz w sekcji Segmentacja.

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 zasobem przypisanym.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • Zapytanie wybiera atrybuty kampanii i powiązane z nimi atrybuty z każdej wybranej kampanii.
  • Każdy zwrócony SearchAds360Row odpowiada obiektowi campaign wypełnionemu wybranymi atrybutami kampanii oraz wybranym atrybutem strategii ustalania stawek bidding_strategy.name.

Aby dowiedzieć się, które przypisane zasoby są dostępne w przypadku zapytań dotyczących kampanii, zajrzyj do sekcji campaign.

Zapytanie o metadane pól

Do pobierania metadanych pól możesz użyć SearchAds360FieldService.

To jest podstawowe zapytanie o metadane pól:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Zastąp RESOURCE LUB FIELD zasobem (takim jak customer lub campaign) albo polem (takim jak 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

Więcej informacji o tworzeniu zapytań w interfejsie Search Ads 360 Reporting API: