本頁面由 Cloud Translation API 翻譯而成。

擷取資產屬性和指標

資產屬性

只要將 Google Ads 查詢語言 (GAQL) 查詢傳送至 GoogleAdsService，即可取得素材資源及其屬性的清單。資產會以 asset 實體表示，該實體可顯示多個資產專屬的欄位。

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

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

請注意，您可以在上述查詢中加入特定類型的屬性，以讀取特定資產的屬性，例如 ImageAsset 或 YoutubeVideoAsset。

舉例來說，以下查詢會篩選 YoutubeVideoAsset 的 asset.type 值 (請參閱可能的類型值的說明文件)，藉此列出帳戶中所有 YoutubeVideoAsset 物件的 YouTube 影片 ID。

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

使用資產

總覽