Aby uzyskać listę zasobów i ich atrybutów, wyślij zapytanie Google Ads
Zapytanie Language (GAQL) do usługi GoogleAdsService. Komponenty
są reprezentowane przez element asset
, który ujawnia liczbę
pól dotyczących zasobów.
Atrybuty komponentów
Następujące zapytanie GAQL zawiera listę wszystkich zasobów na koncie reklamodawcy wraz z nazwę i typ zasobu.
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 poniższe zapytanie zawiera listę identyfikatorów filmów w YouTube dla wszystkich
YoutubeVideoAsset
obiektów na koncie według
filtrując wartość asset.type
(zobacz
dokumentacji z listą możliwych wartości typów) dla argumentu
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
ad_group_ad_asset_view
Ten widok danych zbiera
zasobów poszczególnych reklam. Dlatego też wykonywanie zapytania dotyczącego tego widoku zwraca wiersz dla każdego
grupie reklam i reklamie.
ad_group_ad_asset_view
udostępnia
atrybut związany z widokiem danych
performance_label
tam
zawiera informacje o charakterze skuteczności konkretnej reklamy opartej na komponentach
parowanie. Możliwe wartości pól performance_label
są wyliczane
w poniższej tabeli.
performance_label | Opis |
---|---|
BEST | Najskuteczniejsze komponenty. |
GOOD | Zasoby o dobrej skuteczności. |
LOW | Najmniej skuteczne komponenty. |
LEARNING | Zarabianie na tym zasobie ale statystyki nie są wystarczająco istotne statystycznie, etykietę skuteczności zasobu. |
PENDING | Ten komponent nie ma jeszcze żadnych dane na temat skuteczności. Przyczyną może być to, że wciąż trwa jego sprawdzanie. |
UNKNOWN | Reprezentuje wartość nieznaną w tej wersji. |
UNSPECIFIED | Nie określono. |
Następujące 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
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