Raporty

Aby wyświetlić listę komponentów i ich atrybutów, wyślij do usługi 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 reklamodawcy wraz z nazwami i typami zasobów.

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 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 dokumentacji) dla komponentu 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:

• ad_group_asset
• campaign_asset
• customer_asset

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

Najważniejsza uwaga: funkcja ad_group_ad_asset_view zwraca tylko informacje o komponentach związanych z reklamami aplikacji.

Dane o skuteczności komponentów na poziomie reklamy są agregowane w ad_group_ad_asset_view. Ten widok gromadzi dane komponentów w przypadku poszczególnych reklam. W związku z tym zapytanie dotyczące tego widoku zwraca po jednym wierszu na grupę reklam i reklamę.

Element ad_group_ad_asset_view udostępnia atrybut dotyczący wyświetleń performance_label, który dostarcza informacji o charakterystyce skuteczności danej pary komponent–reklama. Możliwe wartości pól performance_label zostały wymienione w tabeli poniżej.

performance_label	Opis
BEST	Najskuteczniejsze komponenty.
GOOD	komponenty o dobrej skuteczności.
LOW	Zasoby o najgorszej skuteczności.
LEARNING	Komponent zaczął uzyskiwać wyświetlenia, ale statystyki nie są na tyle istotne statystycznie, aby uzyskać etykietę skuteczności komponentu.
PENDING	Ten komponent nie ma jeszcze żadnych informacji o skuteczności. Może to być spowodowane tym, że nadal jest ona sprawdzana.
UNKNOWN	Reprezentuje wartość nieznana w tej wersji.
UNSPECIFIED	Nie określono.

Podana niżej zapytanie GAQL zwraca wyświetlenia, kliknięcia, koszty i konwersje dla wszystkich komponentów na koncie 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 komponentu

Asset.source jest prawidłowa tylko w przypadku komponentów mutable.

Źródło komponentów elastycznych reklam w wyszukiwarce: AdGroupAdAsset.source.