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 wyświetleniem 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 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 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.