報表

您可以將 Google Ads 查詢語言 (GAQL) 查詢傳送至 GoogleAdsService，取得素材資源和屬性清單。資產由 asset 實體代表，該實體會公開多個資產專屬欄位。

資產屬性

以下 GAQL 查詢會列出廣告主帳戶中的所有素材資源，以及其資源名稱和類型。

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

您可以為這項查詢新增類型專屬屬性，以便讀取素材資源專屬的屬性，例如 ImageAsset 或 YoutubeVideoAsset。

舉例來說，下列查詢會篩選 asset.type 值，列出帳戶中所有 YoutubeVideoAsset 物件的 YouTube 影片 ID。如需 YoutubeVideoAsset 的可能類型值清單，請參閱相關說明。

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

素材資源指標

資產指標可透過以下資源取得：

您可以使用這些資源，在各個層級查詢素材資源指標。舉例來說，當您查詢 ad_group_asset 資源時，可以使用 ad_group.id 欄位區隔結果，藉此針對每個 ad_group 和 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

廣告層級指標

素材資源的廣告層級成效指標會匯總至 ad_group_ad_asset_view。這個檢視畫面會收集個別廣告的素材資源指標。因此，查詢這個檢視畫面會為每個廣告群組和廣告傳回一列資料。

ad_group_ad_asset_view 會公開特定檢視畫面的屬性 performance_label，讓您深入瞭解這組特定素材資源廣告的效能特徵。下表列出 performance_label 欄位的可能值。

performance_label說明
BEST成效最佳的素材資源。
GOOD成效良好的素材資源。
LOW成效最差的素材資源。
LEARNING素材資源開始獲得曝光，但統計資料不具統計顯著性，無法獲得素材資源成效標籤。
PENDING這個廣告資源尚未具有任何成效資料，可能是因為仍在審查中。
UNKNOWN代表這個版本中未知的值。
UNSPECIFIED不指定。

下列 GAQL 查詢會傳回帳戶中上個月所有素材資源的曝光次數、點擊次數、費用和轉換次數，並依 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

素材資源來源

Asset.source 僅適用於 mutable 資產。

如要瞭解回應式搜尋廣告素材資源的來源，請參閱 AdGroupAdAsset.source。

上一頁
Business Message 素材資源
下一頁
素材資源