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
iSearchStream
.Zapytania
SearchAds360Service
zwraca listę instancjiSearchAds360Row
:- 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ę instancjiSearchAds360Field
:- 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 obiektowicampaign
. - 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 polemetrics
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.
Zapytanie o atrybuty powiązanego zasobu
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 obiektowicampaign
wypełnionemu wybranymi atrybutami kampanii oraz wybranym atrybutem strategii ustalania stawekbidding_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
lubcampaign
) albo polem (takim jakcampaign.id
,metrics.impressions
lubad_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: