Google Ads API 會在素材資源群組層級,提供商店的詳細成效資料。下列查詢範例有助於從 asset_group 報表取得商店指標。
Google Ads 使用者介面中的指標經常變更。這就像是提供即時新聞的網站。我們會不斷更新,提供最新版面配置、A/B 測試和新功能。API 比較像是經過稽核的財務報告。
資料經過多個步驟 (例如點擊次數去重複) 處理,因此結構一致且穩定,因此,我們無法保證您透過這些查詢從 API 取得的資料,與您在 Google Ads 使用者介面中看到的資料一致。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-05 (世界標準時間)。"],[],[],null,["# Asset Group Level Performance\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nIn addition to campaign reporting, reporting is available for [`asset_group`](/google-ads/api/fields/v21/asset_group) resources linked to your Performance Max campaigns.\n\nAsset group ad strength\n-----------------------\n\nBecause Performance Max campaigns dynamically generate ads for each asset group\nusing the assets attached to that asset group, it's not possible to view\nindividual ad performance. However, the Google Ads API exposes the\n[`asset_group.ad_strength`](/google-ads/api/fields/v21/asset_group#asset_group.ad_strength) field\nand the [`asset_coverage`](/google-ads/api/reference/rpc/v21/AssetCoverage) report field to evaluate\nhow well the associated `asset_group` entities are set up for optimal ad\nperformance. [Learn more](//support.google.com/google-ads/answer/14143250) about\nPerformance Max ad strength.\n\nThe following query demonstrates how to view the ad strength and asset coverage\nreport of all asset groups. You can further filter this query on\n[`asset_group.id`](/google-ads/api/fields/v21/asset_group#asset_group.id) or\n[`asset_group.resource_name`](/google-ads/api/fields/v21/asset_group#asset_group.resource_name)\nto view the ad strength of one or more specific asset groups. Alternatively, you\ncan add a `campaign` filter as described in the [Campaign Reporting guide](/google-ads/api/performance-max/campaign-reporting), to compare the ad strength of different asset\ngroups within a specified campaign. \n\n SELECT\n asset_group.id,\n asset_group.ad_strength,\n asset_group.asset_coverage\n FROM asset_group\n WHERE asset_group.status = 'ENABLED'\n\n### Recommendations to improve asset group strength\n\nThe Google Ads API provides a recommendation type,\n[`IMPROVE_PERFORMANCE_MAX_AD_STRENGTH`](/google-ads/api/reference/rpc/v21/Recommendation#improve_performance_max_ad_strength_recommendation), which highlights asset groups that should be improved to reach an\n\"Excellent\" strength rating. This feature is especially useful for\nthird-party advertisers that enable users to create and manage asset groups.\n\nFor more information, visit the [Optimization score and recommendations](/google-ads/api/docs/recommendations) guide.\n\nAsset group performance\n-----------------------\n\nThe [`asset_group`](/google-ads/api/fields/v21/asset_group) resource exposes a variety of metrics\nto measure individual asset group performance. This sample query demonstrates\nhow to retrieve the performance metrics for each `asset_group` in a specified\ncampaign during the last 7 days. \n\n SELECT\n asset_group.id,\n asset_group.name,\n asset_group.primary_status,\n metrics.conversions,\n metrics.conversions_value,\n metrics.cost_micros,\n metrics.clicks,\n metrics.impressions\n FROM asset_group\n WHERE campaign.id = \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eCAMPAIGN_ID\u003c/span\u003e\u003c/var\u003e\n AND segments.date DURING LAST_7_DAYS\n\nStore Metrics\n-------------\n\nThe Google Ads API provides detailed performance data for your store at the\nasset group level. The following example queries help you get store metrics from\nthe `asset_group` report.\n\nMetrics in the Google Ads UI change frequently. Think of it as a news website\nwith breaking stories. It's constantly being updated with the latest layouts,\nA/B tests, and new features. The API is more like an audited financial report.\nThe data is structured and consistent and has undergone multiple steps, like\ndeduping of clicks, before it is made available. Therefore, we cannot guarantee\nthat the data you get from the API using these queries will match what you\nsee in the Google Ads UI.\n\n### Store visits\n\nThis metric represents the total number of conversions that Google Ads has\nidentified as a user visiting your store after an ad interaction. \n\n SELECT\n asset_group.id,\n asset_group.name,\n metrics.all_conversions,\n segments.external_conversion_source\n FROM asset_group\n WHERE segments.external_conversion_source = 'STORE_VISITS'\n\n### View-through store visits\n\nThese are store visits that occur after a user sees your ad but doesn't interact\nwith it. \n\n SELECT\n asset_group.id,\n asset_group.name,\n metrics.view_through_conversions,\n segments.external_conversion_source\n FROM asset_group\n WHERE\n segments.external_conversion_source = 'STORE_VISITS'\n\n### Store visit value\n\n SELECT\n asset_group.id,\n asset_group.name,\n metrics.all_conversions_value,\n segments.external_conversion_source\n FROM asset_group\n WHERE segments.external_conversion_source = 'STORE_VISITS'\n\n### New customers\n\nThis query retrieves the number of purchase conversions from new customers. \n\n SELECT\n asset_group.id,\n asset_group.name,\n metrics.conversions,\n segments.new_versus_returning_customers,\n segments.conversion_action_category\n FROM asset_group\n WHERE\n segments.new_versus_returning_customers = 'NEW'\n AND segments.conversion_action_category = 'PURCHASE'"]]