Raportowanie

Aby uzyskać listę zasobów i ich atrybutów, wyślij zapytanie Google Ads Query Language (GAQL) do usługi GoogleAdsService. Zasoby są reprezentowane przez element asset, który udostępnia szereg pól związanych z zasobami.

Atrybuty komponentów

Podane niżej zapytanie GAQL zawiera listę wszystkich zasobów na koncie reklamodawcy wraz z ich nazwą i typem.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

Istnieją atrybuty specyficzne dla typu, które można dodać do powyższego zapytania, aby odczytać właściwości powiązane z komponentami takimi jak ImageAsset lub YoutubeVideoAsset.

Na przykład to zapytanie zawiera identyfikatory filmów w YouTube dla wszystkich obiektów YoutubeVideoAsset na koncie, filtrując wartość asset.type (listę możliwych wartości typu YoutubeVideoAsset znajdziesz w dokumentacji).

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

Dane o skuteczności na poziomie reklamy dotyczące zasobów są zbierane w narzędziu ad_group_ad_asset_view. W tym widoku są zbierane dane o komponentach w poszczególnych reklamach. Stąd zapytanie tego widoku spowoduje zwrócenie wiersza na grupę reklam i reklamę.

ad_group_ad_asset_view eksponuje atrybut powiązany z widokiem danych performance_label, który zapewnia wgląd w cechy efektywności danego połączenia komponentów i reklam. Możliwe wartości pól performance_label zostały wymienione w tej tabeli.

performance_labelOpis
BESTNajskuteczniejsze komponenty.
GOODKomponenty o dobrej skuteczności.
LOWNajmniej skuteczne komponenty.
LEARNINGZasób zaczął uzyskiwać wyświetlenia, ale statystyki nie są wystarczająco istotne statystycznie, aby otrzymać etykietę skuteczności.
PENDINGNie ma jeszcze żadnych informacji o skuteczności tego komponentu. Być może jest ona w trakcie sprawdzania.
UNKNOWNReprezentuje wartość nieznaną w tej wersji.
UNSPECIFIEDNie określono.

To zapytanie GAQL zwraca wyświetlenia, kliknięcia, koszty i konwersje dotyczące wszystkich zasobów na koncie w ciągu ostatniego miesiąca, posortowane według parametru 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