What's changing
Starting October 9, 2023 , the Google Ads API will allow the following types of mutate operations for a ConversionAction imported from a Google Analytics 4 (GA4) property:
An update
that modifies status
, primary_for_goal
, category
, name
, or value_settings
.
A remove
that removes the conversion action.
Why this is important
For many Google Ads users, the conversions they import from Google Analytics are a critical component of bidding and reporting. Until now, you could use the Google Analytics Admin API to create a link between your Google Analytics and Ads accounts, but you could not use the Google Ads API to complete the following remaining steps in the linking process:
With this change, the Google Ads API supports both of these steps and provides a complete API-based solution for linking your Google Analytics 4 property to your Google Ads account.
In addition to the attributes needed for proper configuration of conversion goals , you can now modify the following attributes of an imported GA4 ConversionAction
:
Requests that attempt to modify any other attributes of an imported GA4 ConversionAction
will continue to fail, as will requests that attempt to remove
or update
a ConversionAction
imported from a Universal Analytics (UA) property.
What you should do
Modify any code in your integration that depends on the Google Ads API rejecting a ConversionActionOperation
with a MUTATE_NOT_ALLOWED
error if it attempts to update
or remove
an imported GA4 conversion. For example, if your integration relies on this behavior to detect if a conversion action is an imported GA4 conversion, modify it to instead check if the type
of the ConversionAction
is either GOOGLE_ANALYTICS_4_CUSTOM
or GOOGLE_ANALYTICS_4_PURCHASE
.
In addition, if you currently complete the process of linking Google Analytics to Google Ads accounts using the UI, consider whether switching to an API-based solution is appropriate for your use case.
How to get help
If you have any questions or need help, check out the Google Ads API support page for options.
- Josh Radcliff, Google Analytics and Google Ads API Team