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:
removethat removes the conversion action.
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:
- Importing each conversion from your GA4 property into your Google Ads account by modifying its
- Configuring the
categoryfields of each imported conversion to indicate how it should impact Google Ads bidding and reports.
In addition to the attributes needed for proper configuration of conversion goals, you can now modify the following attributes of an imported GA4
ConversionActionwill continue to fail, as will requests that attempt to
ConversionActionimported 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
MUTATE_NOT_ALLOWEDerror if it attempts to
removean 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
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.