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

Za pomocą języka 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.

Zapytania SearchAds360Service zwracają listę instancji SearchAds360Row:

• 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, które można zapytać, wraz ze szczegółowymi informacjami o ich zgodności i typie.

Funkcja SearchAds360FieldService zwraca listę instancji SearchAds360Field:

• Każde pole zawiera informacje o żądanym polu.

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

Przykłady podstawowych zapytań

W następnych sekcjach znajdziesz przykłady podstawowych zapytań, które możesz dostosować do własnych potrzeb.

Zapytanie o atrybuty zasobu

Oto podstawowe zapytanie dotyczące atrybutów 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 reprezentuje obiekt 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

Oto podstawowe zapytanie dotyczące danych związanych 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

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

Aby dowiedzieć się, które przypisane zasoby są dostępne w przypadku zapytań dotyczących kampanii, zobacz 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:

• Struktura i klauzule zapytania
• Zakresy dat
• Dane o wartości 0
• Przykładowe zapytania
• Gramatyka zapytań