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"]],["最后更新时间 (UTC):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'"]]