Google Ads API upgrade: v19 to v20 changelog
This changelog outlines the key updates in the transition from Google Ads API v17 to v19. It includes a complete breakdown of new features, reports, fields, and filters for all 88 updated reports.
High impact reports
These reports have the most significant updates, including new conversion metrics and segmentation options.
1. asset_group
Type: Fields, Filters, Metrics, Segments New fields: 25
- New metrics:
metrics.all_conversions_by_conversion_datemetrics.all_conversions_value_by_conversion_datemetrics.all_new_customer_lifetime_valuemetrics.conversions_by_conversion_datemetrics.conversions_value_by_conversion_datemetrics.new_customer_lifetime_valuemetrics.value_per_all_conversions_by_conversion_datemetrics.value_per_conversions_by_conversion_date
- New segments:
segments.ad_network_typesegments.click_typesegments.conversion_actionsegments.conversion_action_categorysegments.conversion_action_namesegments.conversion_adjustmentsegments.conversion_attribution_event_typesegments.conversion_lag_bucketsegments.conversion_or_adjustment_lag_bucketsegments.devicesegments.external_conversion_sourcesegments.new_versus_returning_customerssegments.slot
- Standard fields added:
campaign.contains_eu_political_advertisingcampaign.video_campaign_settings.video_ad_format_control.format_restrictioncampaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.max_durationcampaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.min_duration
2. campaign
Type: Fields, Filters, Metrics New fields: 15
- New metrics (Platform Comparable Conversions):
metrics.cost_converted_currency_per_platform_comparable_conversionmetrics.cost_per_platform_comparable_conversionmetrics.platform_comparable_conversionsmetrics.platform_comparable_conversions_by_conversion_datemetrics.platform_comparable_conversions_from_interactions_ratemetrics.platform_comparable_conversions_from_interactions_value_per_interactionmetrics.platform_comparable_conversions_valuemetrics.platform_comparable_conversions_value_by_conversion_datemetrics.platform_comparable_conversions_value_per_costmetrics.value_per_platform_comparable_conversionmetrics.value_per_platform_comparable_conversions_by_conversion_date
- Standard fields added: Same 4 standard video fields as listed in
asset_group.
3. customer
Type: Fields, Filters, Metrics
New fields: 11
- New metrics: Same 11 Platform Comparable Conversion metrics as listed in
campaign
note
This report does not consist of standard video campaign fields.
Complete report list (A-Z)
Below is the full list of all 88 reports and their specific changes.
- Standard video fields(4):
campaign.contains_eu_political_advertising
campaign.video_campaign_settings.video_ad_format_control.format_restriction
campaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.max_duration
campaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.min_duration - [+Segments]: Indicates the fields were also added to the Segments list for that report.
| Report Name | Changes | Details | |
|---|---|---|---|
| 1 | ad_group | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 2 | ad_group_ad | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 3 | ad_group_ad_asset_combination_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 4 | ad_group_ad_asset_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 5 | ad_group_ad_label | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 6 | ad_group_asset | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 7 | ad_group_asset_set | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 8 | ad_group_audience_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 9 | ad_group_bid_modifier | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 10 | ad_group_criterion | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 11 | ad_group_criterion_customizer | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 12 | ad_group_criterion_label | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 13 | ad_group_criterion_simulation | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 14 | ad_group_customizer | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 15 | ad_group_label | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 16 | ad_group_simulation | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 17 | ad_parameter | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 18 | ad_schedule_view | 5 Fields | Adds 4 standard video fields [+Segments] + campaign_criterion.webpage_list.shared_set. |
| 19 | age_range_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 20 | asset_field_type_view | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 21 | asset_group | 25 Fields | See High Impact Reports section above. |
| 22 | asset_group_asset | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 23 | asset_group_listing_group_filter | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 24 | asset_group_product_group_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 25 | asset_group_signal | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 26 | asset_group_top_combination_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 27 | asset_set_asset | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 28 | asset_set_type_view | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 29 | call_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 30 | campaign | 15 Fields | See high impact reports section above. |
| 31 | campaign_aggregate_asset_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 32 | campaign_asset | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 33 | campaign_asset_set | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 34 | campaign_audience_view | 5 Fields | Adds 4 standard video fields [+Segments] + campaign_criterion.webpage_list.shared_set. |
| 35 | campaign_bid_modifier | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 36 | campaign_budget | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 37 | campaign_conversion_goal | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 38 | campaign_criterion | 5 Fields | Adds 4 standard video fields [+Segments] + campaign_criterion.webpage_list.shared_set. |
| 39 | campaign_customizer | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 40 | campaign_draft | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 41 | campaign_label | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 42 | campaign_search_term_insight | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 43 | campaign_shared_set | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 44 | campaign_simulation | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 45 | change_event | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 46 | change_status | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 47 | click_view | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 48 | content_criterion_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 49 | conversion_goal_campaign_config | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 50 | customer | 11 Fields | See High Impact Reports section above. |
| 51 | customer_asset | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 52 | detail_placement_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 53 | display_keyword_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 54 | distance_view | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 55 | domain_category | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 56 | dynamic_search_ads_search_term_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 57 | expanded_landing_page_view | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 58 | gender_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 59 | geographic_view | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 60 | group_placement_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 61 | hotel_group_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 62 | hotel_performance_view | 4 Fields | Adds 4 standard video fields [+Segments]. |
| 63 | hotel_reconciliation | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 64 | income_range_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 65 | keyword_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 66 | landing_page_view | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 67 | lead_form_submission_data | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 68 | location_view | 5 Fields | Adds 4 standard video fields**[+Segments]** + campaign_criterion.webpage_list.shared_set. |
| 69 | managed_placement_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 70 | paid_organic_search_term_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 71 | parental_status_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 72 | per_store_view | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 73 | performance_max_placement_view | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 74 | product_group_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 75 | recommendation | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 76 | search_term_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 77 | shared_criterion | 4 Unique | Adds: webpage.conditions, webpage.coverage_percentage, webpage.criterion_name, webpage.sample.sample_urls. |
| 78 | shared_set | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 79 | shopping_performance_view | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 80 | shopping_product | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 81 | smart_campaign_search_term_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 82 | smart_campaign_setting | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 83 | topic_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 84 | travel_activity_group_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |
| 85 | travel_activity_performance_view | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 86 | user_location_view | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 87 | video | 4 Fields | Adds 4 standard video fields**[+Segments]**. |
| 88 | webpage_view | 4 Fields | Adds 4 standard video fields(Fields and Filters). |