報表

如要取得資產及其屬性的清單,請將 Google Ads 查詢語言 (GAQL) 查詢傳送至 GoogleAdsService。資產會以 asset 實體表示,其中公開多個資產專屬欄位。

素材資源屬性

以下 GAQL 查詢會列出廣告客戶帳戶中的所有資產,以及相應的資源名稱和類型。

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

請注意,您可以將類型專用的屬性新增至上述查詢,以讀取資產特有的屬性,例如 ImageAssetYoutubeVideoAsset

舉例來說,以下查詢會篩選 YoutubeVideoAssetasset.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_groupasset 的每個不重複組合的指標:

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