您可以將 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
素材資源來源
Asset.source
僅適用於 mutable
資產。
如要瞭解回應式搜尋廣告素材資源的來源,請參閱 AdGroupAdAsset.source
。