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
YoutubeVideoAsset obiektów na koncie, filtrując wartość asset.type. Listę możliwych wartości typu dla YoutubeVideoAsset znajdziesz tutaj.
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 komponentów 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 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
ad_group_ad_asset_view. Ten widok zbiera dane o komponentach w poszczególnych reklamach. Dlatego zapytanie w tym widoku zwraca 1 wiersz na grupę reklam i reklamę.
Widok ad_group_ad_asset_view udostępnia atrybut
specyficzny dla widoku
performance_label, który
zawiera informacje o charakterystyce skuteczności tego konkretnego połączenia komponentu z reklamą. 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 | Najmniej skuteczne komponenty. |
LEARNING | Komponent zaczął generować wyświetlenia, ale statystyki nie są jeszcze istotne statystycznie, aby można było przypisać etykietę skuteczności komponentu. |
PENDING | Ten komponent nie ma jeszcze żadnych informacji o skuteczności. Może to być spowodowane tym, że jest on nadal w trakcie sprawdzania. |
UNKNOWN | Reprezentuje wartość nieznaną w tej wersji. |
UNSPECIFIED | Nieokreślone. |
To zapytanie GAQL zwraca wyświetlenia, kliknięcia, koszty i konwersje wszystkich komponentów na koncie w ciągu ostatniego miesiąca, posortowane według ich 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
Asset.source jest dokładne tylko w przypadku
mutable
komponentów.
W przypadku źródła komponentów elastycznych reklam w wyszukiwarce użyj
AdGroupAdAsset.source.