Listę zasobów i ich atrybutów możesz uzyskać, wysyłając zapytanie Google Ads Query Language (GAQL) do usługi Google AdsService. Zasoby są reprezentowane przez element asset, który udostępnia różne pola dotyczące konkretnych zasobów.
Atrybuty komponentów
Następujące zapytanie GAQL zawiera listę wszystkich zasobów na koncie reklamodawcy wraz z ich nazwą i typem.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Istnieją atrybuty specyficzne dla typu, które można dodać do powyższego zapytania, aby odczytać właściwości powiązane z komponentami takimi jak ImageAsset lub YoutubeVideoAsset.
Na przykład to zapytanie wyświetla identyfikatory filmów w YouTube dla wszystkich obiektów YoutubeVideoAsset na koncie po przefiltrowaniu wartości asset.type (listę możliwych wartości typów znajdziesz w dokumentacji) 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 komponentów
Dane komponentów są dostępne w kilku zasobach:
Dzięki tym zasobom można wysyłać zapytania o dane do poszczególnych poziomów komponentu.
Na przykład w zapytaniach dotyczących zasobu ad_group_asset pole ad_group.id może służyć do segmentowania wyników, a tym samym pobierania danych dla każdej unikalnej kombinacji parametrów 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
Dane o skuteczności zasobów na poziomie reklamy są zbierane w narzędziu ad_group_ad_asset_view. Zawiera on dane o komponentach poszczególnych reklam. Zapytanie w tym widoku zwraca wiersz dla każdej grupy reklam i reklamy.
ad_group_ad_asset_view ujawnia atrybut performance_label dotyczący wyświetlenia, który daje wgląd w charakterystyki skuteczności tej konkretnej pary komponentów i reklam. Możliwe wartości pól performance_label zostały wymienione w tej tabeli.
performance_label | Opis |
|---|---|
BEST | Najskuteczniejsze komponenty. |
GOOD | Zasoby o dobrej skuteczności. |
LOW | Najmniej skuteczne komponenty. |
LEARNING | Zasób zaczął uzyskiwać wyświetlenia, ale statystyki nie są wystarczająco istotne statystycznie, aby otrzymać etykietę skuteczności zasobu. |
PENDING | Nie ma jeszcze żadnych informacji o wydajności tego zasobu. Przyczyną może być to, że wciąż trwa jego sprawdzanie. |
UNKNOWN | Reprezentuje wartość nieznaną w tej wersji. |
UNSPECIFIED | Nie określono. |
To zapytanie GAQL zwraca wyświetlenia, kliknięcia, koszty i konwersje dla wszystkich zasobów na koncie w ciągu ostatniego miesiąca, posortowanych 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