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

To 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 czy YoutubeVideoAsset.

Na przykład to zapytanie wyświetla identyfikatory filmów z YouTube dla wszystkich YoutubeVideoAsset obiektów na koncie Google Ads, filtrując wartość asset.type. Zobacz a listę możliwych asset.type wartości.

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 gdy wysyłasz zapytanie do zasobu ad_group_asset, możesz użyć pola ad_group.id, aby segmentować wyniki, a tym samym pobierać dane 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

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

Dane o skuteczności komponentów na poziomie reklamy są agregowane w ad_group_ad_asset_view. Ten widok zbiera dane o zasobach dla pojedynczych reklam. Dlatego wysłanie zapytania do tego 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 statystyki dotyczące charakterystyki skuteczności tego konkretnego parowania 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 wystarczająco 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 Google Ads 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 zasobu

Asset.source jest dokładne tylko w przypadku komponentów, które można modyfikować.

W przypadku źródła komponentów elastycznych reklam w wyszukiwarce użyj ad_group_ad_asset_view.source.