(Translated by https://www.hiragana.jp/)
Google Ads Developer Blog: September 2023

Starting on September 20, 2023, we’ve started rolling out a backend improvement on Google Ads dynamic ad targets reporting to include criteria that were removed and then added back as negative.

Starting on September 20, 2023, we’ve started rolling out a backend improvement on Google Ads dynamic ad targets reporting to include criteria that were removed and then added back as negative.

Before this change, report queries for web page criteria (that is, queries against the webpage_view resource) requesting historical data did not include criteria that were removed and then added back as negative.

This resulted in unexpected values in reports for the time frame when these criteria were accruing metrics (that is, when they were targeted and had negative = false), because the metrics they accrued in this time period were not returned in report query results.

The change only affects cases where a positive criterion was removed and added back as negative: all other criteria will return the same values they did before this change.

After this change is released, criteria metrics will take into account removed criteria and criteria that were re-added as negative.

Required actions

You don’t need to change anything in your GAQL queries; however, be aware that you may notice differences in criteria reporting after this change due to the correct values being reported.

If you have any questions or concerns, please don't hesitate to contact us via the forum.

Starting in early October 2023, any Shopping campaigns using Enhanced cost-per-click (eCPC) will behave as if they are using Manual cost-per-click (CPC) bidding.

Enhanced CPC was the first Smart Bidding strategy launched by Google over 10 years ago. It has been replaced by more advanced bidding strategies such as Target ROAS and Maximize conversion value, as well as fully automated campaigns like Performance Max.

Starting in early October 2023, any Shopping campaigns using Enhanced cost-per-click (eCPC) will behave as if they are using Manual cost-per-click (CPC) bidding.

Enhanced CPC was the first Smart Bidding strategy launched by Google over 10 years ago. It has been replaced by more advanced bidding strategies such as Target ROAS and Maximize conversion value, as well as fully automated campaigns like Performance Max.

What happens if I change nothing?

If you choose to not make changes to your campaign by October 2023, it will operate as if it's using Manual CPC bidding. All your existing campaigns using eCPC will continue serving using the manual bids that you set. If you set ManualCpc.enhanced_cpc_enabled to true in a Shopping campaign, the API ignores the setting and the campaign will only use Manual CPC bidding.

What should I change?

If you want to continue to use Manual CPC, remove any code that sets ManualCpc.enhanced_cpc_enabled to true for Shopping campaigns. We recommend these alternatives to Manual CPC:

Where can I get support?

If you have questions, please reach out to us on the forum or at googleadsapi-support@google.com.

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 ...
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:
  1. An update that modifies status, primary_for_goal, category, name, or value_settings.
  2. 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:
  • name
  • value_settings
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.

Buy on Google for Search and Shopping will no longer be available starting September 26, 2023. All Merchant and Consumer support will end for Buy on Google on Search on November 25, 2023. The only exception is that the orders.get and orders.list methods will remain available for Search and Shopping until October 30, 2024, so that merchants can download their historical order data.

Buy on Google for Search and Shopping will no longer be available starting September 26, 2023. All Merchant and Consumer support will end for Buy on Google on Search on November 25, 2023. The only exception is that the orders.get and orders.list methods will remain available for Search and Shopping until October 30, 2024, so that merchants can download their historical order data.

See below for the specific timeline of when Buy on Google methods will no longer be available for the Search and Shopping program.

June 28, 2023 onwards:

September 30, 2023:

October 31, 2023:

All the orders related resources (orders, orderinvoices, orderreports, orderreturns, ordertrackingsignals) and all their underlying methods. The only exception is that the orders.get and orders.list methods will remain available for Search and Shopping until October 30, 2024, so that merchants can download their historical order data.

If you are currently using the Buy on Google endpoints for Search and Shopping via the Content API, you will need to stop using these services for Search and Shopping before the dates listed above, as your requests will start to fail after that date.

If you have any questions or concerns, please don't hesitate to contact us via the forum.

What’s New

Starting on October 4, 2023, AssetGroupListingGroupFilters can be created asynchronously using batch processing with the Google Ads API. If you use BatchJobService to create AssetGroupListingGroupFilter entities and other Performance Max resources in a single request, errors in the listing group tree creation will not block the creation of the remaining entities. However, the operations to create a listing group tree will still be atomic. This means that if any operation related to the creation of a listing group tree returns an error, all operations related to that listing group tree will also fail, save a few caveats, which are detailed in this Jobs & listing group filters guide.

What’s New

Starting on October 4, 2023, AssetGroupListingGroupFilters can be created asynchronously using batch processing with the Google Ads API. If you use BatchJobService to create AssetGroupListingGroupFilter entities and other Performance Max resources in a single request, errors in the listing group tree creation will not block the creation of the remaining entities. However, the operations to create a listing group tree will still be atomic. This means that if any operation related to the creation of a listing group tree returns an error, all operations related to that listing group tree will also fail, save a few caveats, which are detailed in this Jobs & listing group filters guide.

This update does not change the behavior of any existing batch jobs that do not include operations that create listing group filters.

Previous Behavior

Prior to October 4, 2023, AssetGroupListingGroupFilters could only be created synchronously using the GoogleAdsService.Mutate or AssetGroupListingGroupFilterService.MutateAssetGroupListingGroupFilters method. Requests using the GoogleAdsService.Mutate method are always atomic when they contain AssetGroupListingGroupFilterOperation operations. This is because partial_failure is not supported for these operations, which means that an error in listing group tree creation would block all other operations in the request. If you tried creating AssetGroupListingGroupFilter entities prior to October 4, 2023 using batch processing, you would receive a MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE error.

Change Rationale

Batch processing is a powerful feature in the Google Ads API that allows you to dispatch a set of operations, which may be interdependent, to multiple services without synchronously waiting for the operations to complete. We have made batch processing available for AssetGroupListingGroupFilters in response to your feedback to provide another option for creating listing group trees asynchronously and without blocking other operations in the same request.

Implementation Details

In order to add an AssetGroupListingGroupFilter using a batch job:

  1. Create a MutateOperation containing an AssetGroupListingGroupFilterOperation. This is no different than creating a MutateOperation using the GoogleAdsService.Mutate service.
  2. Add the MutateOperation to the batch job as you would with any other type of operation.

The example below demonstrates the process of adding a single AssetGroupListingGroupFilter to an existing batch job. See the Creating Shopping Listing Groups guide to learn more about creating product partition trees using AssetGroupListingGroupFilter entities.

// Constructs the AssetGroupListingGroupFilter.
AssetGroupListingGroupFilter listingGroupFilter =
     AssetGroupListingGroupFilter.newBuilder()
         .setAssetGroup(assetGroupResourceName)
         .setType(ListingGroupFilterType.UNIT_INCLUDED)
         .setVertical(ListingGroupFilterVertical.SHOPPING)
         .build();

// Constructs the operation to create the AssetGroupListingGroupFilter.
MutateOperation operation = MutateOperation.newBuilder()
     .setAssetGroupListingGroupFilterOperation(
           AssetGroupListingGroupFilterOperation
      .newBuilder()
      .setCreate(listingGroupFilter))
      .build();

// Sends a request to add the operation to the batch job.
AddBatchJobOperationsResponse response =
    batchJobServiceClient.addBatchJobOperations(
        AddBatchJobOperationsRequest.newBuilder()
            .setResourceName(batchJobResourceName)
            .addMutateOperations(operation)
            .build());

The following resources contain additional information to help you with your integration:

Improving Performance Max integrations Blog Series

This article is part of a series that discusses new and upcoming features that you have been asking for. We’ll cover what’s new and how it differs from the current implementation approach.

Keep an eye out for further updates and improvements on our developer blog, continue providing feedback on Performance Max integrations with the Google Ads API, and as always, contact our team if you need support.

The Content API for Shopping will undergo planned maintenance on September 28, 2023, from 15:00 to 17:00 UTC.

During this time, you will not be able to make any changes to your account such as updates to users, business information, feeds, shipping details, or linking your Google Ads accounts.
The Content API for Shopping will undergo planned maintenance on September 28, 2023, from 15:00 to 17:00 UTC.

During this time, you will not be able to make any changes to your account such as updates to users, business information, feeds, shipping details, or linking your Google Ads accounts.

You can still upload products to your existing feeds or data sources and run ads as usual.

Note that the Google Ads API is also affected by this outage, as you will not be able to link MC accounts and Google Ads accounts together via the Google Ads API during this time period.

If you have any questions or concerns, please don't hesitate to contact us via the forum.

Today we’re announcing a new guide to help Display & Video 360 users discover available bulk tools that they can use to optimize their integrations.

The guide offers a high-level overview of each of the following tools that allow you to integrate with Display & Video 360 at scale:

Today we’re announcing a new guide to help Display & Video 360 users discover available bulk tools that they can use to optimize their integrations.

The guide offers a high-level overview of each of the following tools that allow you to integrate with Display & Video 360 at scale:

The guide also provides a recommendations page that can help you choose the right bulk tool based on your needs and circumstances and a page proposing potential platform-wide integrations using multiple bulk tools.

You can navigate to this new guide from the existing Display & Video 360 API, Bid Manager API, or Reporting Data Transfer documentation using the Discover Bulk Tools tab at the top of the page.

We are accepting early sign-ups for a Google Ads API pilot program that lets you make API calls without requiring a developer token. Your API access levels will instead be identified by your Google Cloud project IDs and Google Cloud organizations.

We are accepting early sign-ups for a Google Ads API pilot program that lets you make API calls without requiring a developer token. Your API access levels will instead be identified by your Google Cloud project IDs and Google Cloud organizations.

This pilot provides benefits such as:

  • No more need to secure developer tokens
  • Better integration with Google Cloud console API quota management tools

Refer to our developer documentation to learn more about this feature.

If you have any questions, please contact us on the forum.