Aby wyświetlić listę komponentów i ich atrybutów, wyślij do GoogleAdsService zapytanie w języku zapytań Google Ads (GAQL). Komponenty są reprezentowane przez element asset, który udostępnia wiele pól związanych z komponentami.
Atrybuty komponentów
Podane niżej zapytanie GAQL wyświetla wszystkie komponenty na koncie Google Ads wraz z nazwami i typami zasobów.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Do tego zapytania możesz dodać atrybuty specyficzne dla typu, 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 na YouTube dla wszystkich obiektów YoutubeVideoAsset na koncie Google Ads, filtrując wartość asset.type. Zobacz listę możliwych wartości asset.type.
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żesz wysyłać zapytania o dane komponentu na poszczególnych poziomach.
Na przykład w zapytaniach dotyczących zasobu ad_group_asset możesz użyć pola ad_group.id 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
Ważne: funkcja ad_group_ad_asset_view zwraca informacje tylko o komponentach powiązanych z reklamami aplikacji, reklamami generującymi popyt i elastycznymi reklamami w wyszukiwarce.
Dane o skuteczności komponentów na poziomie reklamy są agregowane w sekcji ad_group_ad_asset_view. Ten widok zbiera dane o komponentach poszczególnych reklam. Zapytanie dotyczące tego widoku zwraca 1 wiersz na grupę reklam i reklamę.
Element ad_group_ad_asset_view udostępnia atrybut związany z widokiem performance_label, który zawiera informacje o charakterystyce skuteczności tej konkretnej pary komponent – reklama. W tabeli poniżej znajdziesz możliwe wartości pól performance_label.
performance_label | Opis |
|---|---|
BEST | Najskuteczniejsze komponenty. |
GOOD | Komponenty o dobrej skuteczności. |
LOW | najgorzej działające komponenty, |
LEARNING | Komponent zaczął generować wyświetlenia, ale statystyki nie są jeszcze istotne statystycznie, aby można było przypisać mu etykietę skuteczności. |
PENDING | Nie ma jeszcze żadnych informacji o skuteczności tego komponentu. Może to być spowodowane tym, że jest ono nadal w trakcie sprawdzania. |
UNKNOWN | Reprezentuje nieznaną wartość w tej wersji. |
UNSPECIFIED | Nie określono. |
To zapytanie GAQL zwraca wyświetlenia, kliknięcia, koszty i konwersje wszystkich komponentów na koncie Google Ads w ostatnim miesiącu, posortowane 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
Źródło zasobu
Wartość Asset.source jest dokładna tylko w przypadku zmiennych komponentów.
W przypadku źródła komponentów RSA użyj
ad_group_ad_asset_view.source.