報表
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
您可以將 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
。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-27 (世界標準時間)。
[null,null,["上次更新時間:2025-08-27 (世界標準時間)。"],[[["\u003cp\u003eRetrieve a list of assets and their attributes, including type-specific properties, using GAQL queries to the GoogleAdsService.\u003c/p\u003e\n"],["\u003cp\u003eAccess asset metrics at the ad group, campaign, and customer levels through their respective resources to analyze performance.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the \u003ccode\u003ead_group_ad_asset_view\u003c/code\u003e to gain insights into ad-level performance metrics specifically for App ads assets, including a performance label.\u003c/p\u003e\n"],["\u003cp\u003eDetermine the source of mutable assets with \u003ccode\u003eAsset.source\u003c/code\u003e and the source of RSA assets with \u003ccode\u003eAdGroupAdAsset.source\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Reports\n\nYou can get a list of assets and their attributes by sending a [Google Ads Query\nLanguage (GAQL) query](/google-ads/api/docs/query/overview) to the GoogleAdsService. Assets\nare represented by the [`asset`](/google-ads/api/fields/v21/asset) entity, which exposes a number\nof asset-specific fields.\n\nAsset attributes\n----------------\n\nThe following GAQL query lists all assets in an advertiser's account along with\ntheir resource name and type. \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.type\n FROM asset\n\nYou can add type-specific attributes this query to read properties specific to\nassets such as [`ImageAsset`](/google-ads/api/reference/rpc/v21/ImageAsset) or\n[`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset).\n\nFor example, the following query lists the YouTube video IDs for all\n[`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset) objects in an account by\nfiltering the [`asset.type`](/google-ads/api/fields/v21/asset#asset.type) value. See a list of\npossible type values) for [`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset). \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.youtube_video_asset.youtube_video_id\n FROM asset\n WHERE asset.type = 'YOUTUBE_VIDEO'\n\nAsset metrics\n-------------\n\nAsset metrics are made available through a few resources:\n\n- [`ad_group_asset`](/google-ads/api/fields/v21/ad_group_asset)\n- [`campaign_asset`](/google-ads/api/fields/v21/campaign_asset)\n- [`customer_asset`](/google-ads/api/fields/v21/customer_asset)\n\nWith these resources, you can query asset metrics at each respective level.\nFor example, when you query the `ad_group_asset` resource, you can use the\n`ad_group.id` field to segment the results, thereby retrieving metrics for each\nunique combination of `ad_group` and `asset`: \n\n SELECT\n ad_group.id,\n asset.id,\n metrics.clicks,\n metrics.impressions\n FROM ad_group_asset\n WHERE segments.date DURING LAST_MONTH\n ORDER BY metrics.impressions DESC\n\nAd-level metrics\n----------------\n\n| **Key Point:** The [`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view) only returns information for assets that are related to App ads.\n\nAd-level performance metrics for assets are aggregated in the\n[`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view). This view collects\nmetrics for assets per individual ad. Thus, querying this view returns one row\nper ad group and ad.\n\nThe [`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view) exposes the\nview-specific attribute\n[`performance_label`](/google-ads/api/reference/rpc/v21/AdGroupAdAssetView#performance_label) that\ngives insight into the performance characteristics of this specific asset-ad\npairing. The following table enumerates the possible values of the\n`performance_label` fields.\n\n| `performance_label` | Description |\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `BEST` | Best performing assets. |\n| `GOOD` | Good performing assets. |\n| `LOW` | Worst performing assets. |\n| `LEARNING` | The asset has started getting impressions but the stats are not statistically significant enough to get an asset performance label. |\n| `PENDING` | This asset doesn't yet have any performance information. This may be because it is still under review. |\n| `UNKNOWN` | Represents value unknown in this version. |\n| `UNSPECIFIED` | Not specified. |\n\nThe following GAQL query returns impressions, clicks, costs, and conversions for\nall assets in an account during the last month, sorted by their\n`performance_label`: \n\n SELECT\n ad_group_ad_asset_view.ad_group_ad,\n ad_group_ad_asset_view.asset,\n ad_group_ad_asset_view.field_type,\n ad_group_ad_asset_view.performance_label,\n metrics.impressions,\n metrics.clicks,\n metrics.cost_micros,\n metrics.conversions\n FROM ad_group_ad_asset_view\n WHERE segments.date DURING LAST_MONTH\n ORDER BY ad_group_ad_asset_view.performance_label\n\nAsset Source\n------------\n\n[`Asset.source`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource) is only accurate for\n[`mutable`](/google-ads/api/docs/assets/overview#asset_types_linked_to_customers_campaigns_and_ad_groups)\nAssets.\n\nFor the source of RSA Assets use,\n[`AdGroupAdAsset.source`](/google-ads/api/fields/v21/ad_group_ad_asset_view#ad_group_ad_asset_view.source)."]]