Asset reporting

Page Summary

The asset_group_asset resource allows you to obtain asset-level performance, including the performance_label field which ranks an asset against others of the same type.
The asset_group_top_combination_view resource can be used to query the top performing combinations of assets within asset groups, mirroring the Combinations report in the Google Ads UI.
Queries on asset_group_top_combination_view can be adapted to identify top asset combinations for specific asset groups or campaigns, potentially filtered by metrics like asset group ad strength.

You can retrieve asset performance data for Performance Max campaigns using the asset_group_asset resource.

Performance is primarily indicated by:

Status: The primary_status and primary_status_reasons fields provide a comprehensive view of whether an asset is serving and why.
Quantitative metrics: Full performance statistics (such as clicks , impressions , and conversions ) are now available at the asset level, allowing for a more granular evaluation of asset performance against specific campaign goals.

Example query: Primary status and performance metrics

The following query retrieves primary_status details along with detailed performance metrics:

  SELECT 
  
 campaign 
 . 
 id 
 , 
  
 asset_group 
 . 
 id 
 , 
  
 asset_group_asset 
 . 
 asset 
 , 
  
 asset_group_asset 
 . 
 field_type 
 , 
  
 asset_group_asset 
 . 
 primary_status 
 , 
  
 asset_group_asset 
 . 
 primary_status_details 
 , 
  
 asset_group_asset 
 . 
 primary_status_reasons 
 , 
  
 asset_group_asset 
 . 
 policy_summary 
 . 
 policy_topic_entries 
 , 
  
 asset_group_asset 
 . 
 status 
 , 
  
 metrics 
 . 
 impressions 
 , 
  
 metrics 
 . 
 clicks 
 , 
  
 metrics 
 . 
 ctr 
 , 
  
 metrics 
 . 
 conversions 
 , 
  
 metrics 
 . 
 conversions_value 
 , 
  
 metrics 
 . 
 cost_micros 
 FROM 
  
 asset_group_asset 
 WHERE 
  
 asset_group 
 . 
 id 
  
 = 
  
  ASSET_GROUP_ID 
 
  
 AND 
  
 asset_group_asset 
 . 
 status 
  
 != 
  
 'REMOVED' 
  
 AND 
  
 campaign 
 . 
 id 
  
 = 
  
  CAMPAIGN_ID

Example query: Detailed asset metrics in Performance Max

The following query retrieves conversion data, cost, and impressions for each asset, segmented by the network (channel) where the ad was served.

  SELECT 
  
 asset_group_asset 
 . 
 asset 
 , 
  
 asset_group_asset 
 . 
 asset_group 
 , 
  
 asset_group_asset 
 . 
 field_type 
 , 
  
 asset_group_asset 
 . 
 status 
 , 
  
 segments 
 . 
 ad_network_type 
 , 
  
 metrics 
 . 
 conversions 
 , 
  
 metrics 
 . 
 conversions_value 
 , 
  
 metrics 
 . 
 cost_micros 
 , 
  
 metrics 
 . 
 impressions 
 , 
  
 metrics 
 . 
 clicks 
 FROM 
  
 asset_group_asset 
 WHERE 
  
 segments 
 . 
 date 
  
 DURING 
  
 LAST_30_DAYS 
  
 AND 
  
 asset_group_asset 
 . 
 status 
  
 = 
  
 'ENABLED'

Top asset combinations

The asset_group_top_combination_view resource can be used to query the top performing combinations of assets in asset groups. This corresponds to the Combinations report in the Google AdsUI. For example, the following query produces a list of the top asset combinations in a specified asset_group . Each row in the response contains a list of asset_group_top_combination_view.asset_group_top_combinations messages of type AssetGroupAssetCombinationData . Each item in that list contains a list of the assets in the respective combination represented as an AssetUsage message.

  SELECT 
  
 campaign 
 . 
 id 
 , 
  
 asset_group 
 . 
 id 
 , 
  
 asset_group_top_combination_view 
 . 
 asset_group_top_combinations 
 FROM 
  
 asset_group_top_combination_view 
 WHERE 
  
 asset_group 
 . 
 id 
  
 = 
  
  ASSET_GROUP_ID

You can adapt this query to help with asset selection and campaign optimization. The following query retrieves the top asset combination for a single campaign, but only for asset groups with an asset_group.ad_strength of GOOD or EXCELLENT . This helps you identify the best-performing asset combinations within your top-performing asset groups.

  SELECT 
  
 campaign 
 . 
 id 
 , 
  
 asset_group_top_combination_view 
 . 
 asset_group_top_combinations 
 , 
  
 asset_group 
 . 
 ad_strength 
 , 
  
 asset_group 
 . 
 id 
 FROM 
  
 asset_group_top_combination_view 
 WHERE 
  
 asset_group 
 . 
 ad_strength 
  
 IN 
  
 ( 
 'GOOD' 
 , 
  
 'EXCELLENT' 
 ) 
  
 AND 
  
 campaign 
 . 
 id 
  
 = 
  
  CAMPAIGN_ID

Asset Group Reporting

Retail Campaign Reporting