Język zapytań Search Ads 360

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

Usługi wyszukiwania

Za pomocą języka zapytań Search Ads 360 możesz wysyłać zapytania do interfejsu API, korzystając z tych usług:

SearchAds360Service

Użyj tej usługi, aby wysyłać zapytania o zasoby i powiązane z nimi atrybuty, segmenty i dane. Dostępne są 2 metody: Search i SearchStream.

SearchAds360Service zapytania zwracają listę SearchAds360Row instancji:

  • Każdy wiersz reprezentuje zasób.
  • Jeśli zażądasz, wiersze będą zawierać atrybuty i pola danych.
  • Jeśli poprosisz o segmenty, zostaną dodane dodatkowe wiersze dla każdej krotki segment-zasób.

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

SearchAds360FieldService

Użyj tej usługi, aby wysyłać zapytania o metadane dotyczące dostępnych pól i zasobów. Usługa udostępnia katalog pól, o które można wysyłać zapytania, wraz ze szczegółowymi informacjami o ich zgodności i typie.

SearchAds360FieldService zwraca listę SearchAds360Field instancji:

  • 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 kolejnych sekcjach znajdziesz przykłady podstawowych zapytań, które możesz dostosować do swoich potrzeb.

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 element SearchAds360Row reprezentuje obiekt campaign.

  • Wiersze są wypełniane wybranymi polami (w tym resource_name danej kampanii).

  • Zapytanie sortuje według identyfikatora kampanii.

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

Zapytanie o dane

To jest podstawowe zapytanie o dane 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 ze stanem PAUSED i ponad 1000 wyświetleń.

  • Każdy zwrócony element SearchAds360Row ma pole metrics wypełnione wybranymi danymi.

  • Zapytanie sortuje według identyfikatora kampanii.

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

Zapytanie o segmenty

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 ze stanem PAUSED i ponad 1000 wyświetleń.

  • Dane są segmentowane według daty.

  • W wyniku segmentacji każdy element SearchAds360Row reprezentuje krotkę kampanii i segmentu daty.

  • Zapytanie sortuje według identyfikatora kampanii.

Listę segmentów, których możesz używać w zapytaniach, znajdziesz w artykule segments, a więcej informacji o segmentowaniu raportów – w artykule Segmentation.

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 z atrybutami.

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 element SearchAds360Row reprezentuje obiekt campaign wypełniony wybranymi atrybutami kampanii oraz wybranym atrybutem strategii ustalania stawek, czyli bidding_strategy.name.

Aby dowiedzieć się które zasoby z atrybutami są dostępne w przypadku zapytań o kampanie, zapoznaj się z artykułem campaign.

Zapytanie o metadane pola

Do pobierania metadanych pola możesz użyć SearchAds360FieldService.

To jest podstawowe zapytanie o metadane pola:

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

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

Więcej informacji

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