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_date
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_new_customer_lifetime_value
  • metrics.conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.new_customer_lifetime_value
  • metrics.value_per_all_conversions_by_conversion_date
  • metrics.value_per_conversions_by_conversion_date
• New segments:
  • segments.ad_network_type
  • segments.click_type
  • segments.conversion_action
  • segments.conversion_action_category
  • segments.conversion_action_name
  • segments.conversion_adjustment
  • segments.conversion_attribution_event_type
  • segments.conversion_lag_bucket
  • segments.conversion_or_adjustment_lag_bucket
  • segments.device
  • segments.external_conversion_source
  • segments.new_versus_returning_customers
  • segments.slot
• Standard fields added:
  • 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

2. campaign

Type: Fields, Filters, Metrics New fields: 15

• New metrics (Platform Comparable Conversions):
  • metrics.cost_converted_currency_per_platform_comparable_conversion
  • metrics.cost_per_platform_comparable_conversion
  • metrics.platform_comparable_conversions
  • metrics.platform_comparable_conversions_by_conversion_date
  • metrics.platform_comparable_conversions_from_interactions_rate
  • metrics.platform_comparable_conversions_from_interactions_value_per_interaction
  • metrics.platform_comparable_conversions_value
  • metrics.platform_comparable_conversions_value_by_conversion_date
  • metrics.platform_comparable_conversions_value_per_cost
  • metrics.value_per_platform_comparable_conversion
  • metrics.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).