Pobieranie atrybutów i danych zasobów

Atrybuty zasobu

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

Następne 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

Pamiętaj, że do powyższego zapytania możesz dodać atrybuty dotyczące konkretnego typu, aby odczytać właściwości powiązane z określonymi zasobami, np. ImageAsset lub YoutubeVideoAsset.

Na przykład w zapytaniu poniżej podano identyfikatory filmów YouTube dla wszystkich obiektów YoutubeVideoAsset na koncie, filtrując wartość asset.type (zapoznaj się z dokumentacją listy możliwych wartości typów) dla YoutubeVideoAsset.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

Wskaźniki zasobów

Dane dotyczące zasobów są dostępne w kilku zasobach:

• ad_group_asset
• campaign_asset
• customer_asset

Dzięki tym zasobom można wyszukiwać zapytania o zasoby na poszczególnych poziomach. Na przykład w przypadku zapytań dotyczących zasobu ad_group_asset można użyć pola ad_group.id, aby podzielić wyniki i dzięki temu pobrać dane dla każdej niepowtarzalnej 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żne: ad_group_ad_asset_view zwraca tylko informacje dotyczące zasobów związanych z reklamami aplikacji.

Dane o skuteczności zasobów na poziomie reklamy są zbierane w ad_group_ad_asset_view. Ten widok zawiera dane zasobów na daną reklamę. W ten sposób zapytanie o ten widok zwraca wiersz na grupę reklam i reklamę.

ad_group_ad_asset_view udostępnia atrybut dotyczący konkretnego widoku danych performance_label, który zapewnia wgląd w skuteczność konkretnej pary zasobów i reklam. Możliwe wartości pól performance_label są wymienione w tabeli poniżej.

performance_label	Opis
BEST	Najskuteczniejsze zasoby.
GOOD	Zasoby o wysokiej skuteczności.
LOW	Zasoby o najniższej skuteczności.
LEARNING	Zasób zaczął zdobywać wyświetlenia, ale statystyki nie są dostatecznie istotne statystycznie, aby uzyskać etykietę skuteczności zasobu.
PENDING	Nie ma jeszcze żadnych informacji o wydajności tego zasobu. Być może jest 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 dla wszystkich zasobó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