Język zapytań Search Ads 360

Język zapytań Search Ads 360 umożliwia tworzenie zapytań, które pozwalają do raportowania danych 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

Ta usługa służy do wysyłania zapytań dotyczących zasobów i powiązanych z nimi atrybutów, segmentów, i dane. Są 2 metody: 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 poprosisz o segmenty, dla każdego z nich zostaną uwzględnione dodatkowe wiersze krotka zasobu segmentu.

Przeczytaj artykuł Tworzenie raportów wyszukiwania dotyczących: znajdziesz więcej informacji.

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, do których można utworzyć zapytania, ze szczegółowymi informacjami o ich i typu zgodności.

SearchAds360FieldService zwraca listę SearchAds360Field instancji:

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

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ć do swoich potrzeb do własnych zapytań.

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 obiekt SearchAds360Row odpowiada obiektowi campaign.
  • Wiersze zawierają wybrane pola (w tym pola danej kampanii resource_name).
  • Zapytanie ustala kolejność wyświetlania reklam według identyfikatora kampanii.

Zobacz campaign: innych dostępnych pól, których możesz użyć w zapytaniach.

Zapytanie o dane

To jest podstawowe zapytanie o dane związane z atrybutami campaign zasób:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • Zapytanie zwróci kampanie o stanie PAUSED i większym niż 1000 wyświetleń.
  • Każdy zwrócony element SearchAds360Row ma pole metrics wypełnione wartością wybranych danych.
  • Zapytanie ustala kolejność wyświetlania według identyfikatora kampanii.

Zobacz metrics, aby zobaczyć inne dostępnych danych, których możesz użyć w zapytaniach.

Zapytanie dotyczące segmentów

To jest podstawowe zapytanie o segmenty powiązane z atrybutami obiektu campaign zasób:

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 zwróci kampanie o stanie PAUSED i większym niż 1000 wyświetleń.
  • Dzieli dane na segmenty według daty.
  • W wyniku segmentacji każde pole SearchAds360Row to krotka kampanii i segmentu dat.
  • Zapytanie ustala kolejność wyświetlania według identyfikatora kampanii.

Zobacz segments, list segmentów, których możesz używać w zapytaniach, oraz segmentacji, o segmentowaniu raportów.

To jest podstawowe zapytanie o zasób campaign, które łączy atrybuty bidding_strategy zasób, jeśli jest dostępny. Ten typ powiązanego zasobu jest nazywanym 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żdego wybrano kampanię.
  • Każdy zwrócony obiekt SearchAds360Row reprezentuje uzupełniony obiekt campaign z wybranymi atrybutami kampanii i wybraną strategią ustalania stawek bidding_strategy.name.

Zobacz campaign i sprawdzać, które przypisane zasoby są dostępne na potrzeby zapytań związanych z kampanią.

Zapytanie o metadane pola

Możesz użyć usługi SearchAds360FieldService aby pobrać metadane pól.

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 wartość RESOURCE LUB FIELD jednym z zasobów (takich jak customer lub campaign) lub pola (np. campaign.id, metrics.impressions lub ad_group.id).
.

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

Więcej informacji

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