Aby wyświetlić listę komponentów i ich atrybutów, wyślij do usługi Google Ads 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 reklamodawcy 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 w YouTube dla wszystkich obiektów YoutubeVideoAsset
na koncie, filtrując wartość asset.type
. Listę możliwych wartości typu znajdziesz w sekcji 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żesz wysyłać zapytania o dane do poszczególnych poziomów komponentu.
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
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 więc 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 wystarczająco 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 nadal jest w trakcie weryfikacji. |
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 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 komponentu
Wartość Asset.source
jest dokładna tylko w przypadku komponentów mutable
.
W przypadku źródła komponentów RSA użyj:AdGroupAdAsset.source
.