Atrybuty zasobu
Aby uzyskać listę zasobów i ich atrybutów, wyślij do Google AdsService zapytanie o język zapytań (GAQL). Zasoby są reprezentowane przez element asset, który udostępnia wiele pól związanych z zasobami.
Poniższe zapytanie GAQL zawiera listę wszystkich zasobów na koncie reklamodawcy wraz z nazwą i typem zasobu.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Istnieją atrybuty dotyczące określonych typów zasobów, które możesz dodać do powyższego zapytania, aby odczytać właściwości powiązane z takimi zasobami jak ImageAsset lub YoutubeVideoAsset.
Na przykład zapytanie poniżej zawiera identyfikatory filmów w YouTube dotyczące wszystkich obiektów YoutubeVideoAsset na koncie. Aby to zrobić, przefiltruj wartość asset.type (w dokumentacji znajdziesz listę możliwych wartości typu) dla YoutubeVideoAsset.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'
Dane zasobu
Wskaźniki dotyczące zasobów są dostępne z kilku źródeł:
Dzięki tym zasobom można wyszukiwać zapytania o zasoby na każdym z poziomów.
Na przykład podczas wykonywania zapytania o zasób ad_group_asset można użyć pola ad_group.id do podzielenia wyników, a tym samym pobrania danych dla każdej unikalnej kombinacji ad_group i asset:
SELECT
ad_group.id,
asset.id,
metrics.clicks,
metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC
Dane na poziomie reklamy
Wskaźniki dotyczące skuteczności na poziomie reklamy są zbierane w narzędziu ad_group_ad_asset_view. Ten widok zbiera dane
o zasobach w każdej reklamie. W związku z tym wysłanie zapytania do tego widoku zwraca wiersz dla grupy reklam i reklamy.
ad_group_ad_asset_view ujawnia atrybut specyficzny dla wyświetlenia performance_label, który daje wgląd w statystyki skuteczności tego konkretnego połączenia zasobów reklamowych. Możliwe wartości pól performance_label są wymienione w tabeli poniżej.
performance_label | Opis |
|---|---|
BEST | Najskuteczniejsze zasoby. |
GOOD | Zasoby o dobrej skuteczności. |
LOW | Zasoby o najniższej skuteczności. |
LEARNING | Zasób zaczął być wyświetlany, ale jego statystyki nie są istotne statystycznie, by uzyskać etykietę skuteczności zasobu. |
PENDING | Nie ma jeszcze żadnych informacji o skuteczności zasobu. Być może jest nadal w trakcie sprawdzania. |
UNKNOWN | Reprezentuje wartość nieznaną w tej wersji. |
UNSPECIFIED | Nie określono. |
Następujące zapytanie GAQL zwraca wyświetlenia, kliknięcia, koszty i konwersje ze wszystkich zasobów na koncie w ostatnim miesiącu, posortowane według wartości performance_label:
SELECT
ad_group_ad_asset_view.ad_group_ad,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.field_type,
ad_group_ad_asset_view.performance_label,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label