Raporty

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:

• ad_group_asset
• campaign_asset
• customer_asset

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 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

Ważna uwaga: ad_group_ad_asset_view zwraca informacje tylko o komponentach powiązanych z reklamami aplikacji, kampaniami generującymi popyt i elastycznymi reklamami w wyszukiwarce.

Dane o wskaźnikach 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 do tego widoku zwraca po jednym wierszu na grupę reklam i reklamę.

ad_group_ad_asset_view udostępnia atrybut performance_label, który daje wgląd w charakterystykę skuteczności tej konkretnej pary komponentu i reklamy. 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	Komponenty o najniższej skuteczności.
LEARNING	Komponent zaczął uzyskiwać wyświetlenia, ale statystyki nie są 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 on nadal w trakcie sprawdzania.
UNKNOWN	Reprezentuje wartość nieznaną w tej wersji.
UNSPECIFIED	Nie określono.

Podane niżej zapytanie GAQL zwraca wyświetlenia, kliknięcia, koszty i konwersje dotyczące wszystkich komponentów na koncie Google Ads w ciągu ostatniego miesiąca, 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

Asset.source jest dokładny tylko w przypadku zasobów modyfikowalnych.

Jako źródła komponentów elastycznych reklam w wyszukiwarce używaj ad_group_ad_asset_view.source.