Category Archives: Ads Developer Blog

The official blog for information about the AdWords, AdSense, DoubleClick and AdMob APIs and SDKs

Merchant IDs as 64-bit in Content API for Shopping

In the Content API for Shopping, Merchant IDs are now 64-bit signed integers. Applications that integrate with the Content API must be able to handle ID values in that range.

Historically, Merchant IDs in the Content API for Shopping were within the maximum value of a 32-bit signed integer, but have recently exceeded this range. In order to avoid any issues, please make sure your applications are fully compliant with IDs within a range of 64-bit signed integer values.

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

Announcing v4 of the Campaign Manager 360 API

Today we're releasing v4 of the Campaign Manager 360 API. This release adds support for the following Billing Services:
  • Advertiser Invoices
  • Billing Assignments
  • Billing Profiles
  • Billing Rates
Details of these and all other changes are covered in our release notes.

Deprecation and sunset reminder
In accordance with our deprecation schedule, this release marks the beginning of the depreciation period for v3.5, which will sunset on Feb 15, 2023. After this date, any requests made against v3.5 will begin returning errors.

See the migration guide for details. For most, you just need to upgrade to the latest version of your preferred client library. We recommend you to review the release notes to learn about important changes you might need to be aware of.

If you have questions about this or anything else Campaign Manager 360 API related, feel free to reach out to us on our support forum.

Learn More
As with every new version of the Campaign Manager 360 API, we encourage you to carefully review all changes in the release notes. For those of you looking to get going right away, updated client libraries are now available. If you're just starting out, the Get Started guide is a great reference to help you get up and running quickly.

Give it a try and let us know if you have any questions!

Announcing v11 of the Google Ads API

Today, we’re announcing the v11 release of the Google Ads API. To use some of the v11 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week.
Here are the highlights: Where can I learn more?
The following resources can help you get started: If you have any questions or need additional help, contact us via the forum.

Google Ads API v9 sunset reminder

Google Ads API v9 will sunset on July 13, 2022. On this date, v9 API requests will begin to fail. Please migrate to a newer version before July 13, 2022 to ensure your API access is unaffected.

We've prepared various resources to help you with the migration: If you have questions while you’re upgrading, please reach out to us on the forum or at [email protected].

AdWords API has Officially Sunset

As previously announced, the error rate for requests to the AdWords API will start increasing toward 100% beginning on May 31, 2022. If you are currently using the AdWords API, you need to upgrade to the Google Ads API now or your applications will experience an increased rate of errors per the schedule below:
Starting Date AdWords API Error Rate
June 1, 2022 50% errors
July 1, 2022 60% errors
July 8, 2022 70% errors
July 15, 2022 80% errors
July 22, 2022 90% errors
July 31, 2022 100% errors
Starting July 31, 2022 all requests to the AdWords API will fail.

Where do I start?
See the following resources to get started: Here are some tools to help you migrate: Where can I get support?
If you have questions while you’re upgrading, please reach out to us on the forum or at [email protected].

May 2022 update to Display & Video 360 API v1

Today we’re releasing an update to the Display & Video 360 API that includes the following features:

More detailed information about this update can be found in the Display & Video 360 API release notes. Before using these new features, make sure to update your client library to the latest version.

If you run into issues or need help with these new features or samples, please contact us using our support contact form.

Expanded Text Ads (ETA) Creation and Editing will Cease on June 30, 2022

As previously announced, starting June 30, 2022:
  • You will no longer be able to create or edit Expanded Text Ads
  • If you attempt to create an ETA you will receive the error CANNOT_CREATE_DEPRECATED_ADS
  • If you attempt to modify an ETA you will receive the error CANNOT_MODIFY_AD
  • Expanded text ads will continue to serve, and you will still see reports on their performance going forward
  • You will be able to pause and resume your expanded text ads, or remove them if needed
We encourage you to transition to Responsive Search Ads (RSA).

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

Announcing v202205 of the Google Ad Manager API

We're pleased to announce that v202205 of the Google Ad Manager API is available starting today, May 17th. This release adds support for CPM sponsorships for ProposalLineItems.

It also updates the ReportService for the upcoming "Ad Exchange Historical" to "Historical" report type conversion. Ad Exchange Historical dimensions and metrics are now available for Historical reports. Because of this change, several Ad Exchange dimensions and metrics have been renamed or replaced in the API.

To migrate, please refer to the migration guide and the reference documentation for v202202 and earlier. The reference documentation has been updated to show which values are deprecated and their replacements. Here’s an example:

Enumeration Description
AD_EXCHANGE_IMPRESSIONS Ad Impressions on mapped Ad Exchange properties. When multiple text ads fill a single display slot it is only counted once, when the top text ad is recognized. In these cases, the Ad Impression is attributed to the top text ad.
Deprecated as part of the "Ad Exchange Historical" to "Historical" report type conversion. Use AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONS instead.

For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

Changes to how Smart Bidding strategies are organized for Search campaigns

We previously announced that standard (non-portfolio) TargetCpa and TargetRoas bidding strategies are being replaced by MaximizeConversions (with target_cpa) and MaximizeConversionValue (with target_roas) for Search campaigns (those with advertising_channel_type = SEARCH).

Starting in July 2022, all remaining Search campaigns that use standard TargetCpa and TargetRoas bidding strategies will be converted to MaximizeConversions and MaximizeConversionValue strategies, with the same target_cpa and target_roas settings applied, respectively. The migration of portfolio strategies is planned later in 2023.

With this change there will be no impact to bidding behavior. Using MaximizeConversions with a target_cpa setting will have the same bidding behavior as TargetCpa. Likewise, using MaximizeConversionValue with a target_roas setting will have the same bidding behavior as TargetRoas.

Example

The following sample Campaign object illustrates what a migrated Search campaign’s bidding strategy settings would look like before and after the transition.

Existing campaign using standard TargetCpa

Previously using TargetCpa Now uses MaximizeConversions
{
bidding_strategy_type: TARGET_CPA
target_cpa: {
target_cpa_micros: 1000000
}
...
}
{
bidding_strategy_type: MAXIMIZE_CONVERSIONS
maximize_conversions: {
target_cpa: 1000000
}
...
}



Existing campaign using standard TargetRoas

Previously using TargetRoas Now uses MaximizeConversionValue
{
bidding_strategy_type: TARGET_ROAS
target_roas: {
target_roas: 2.0
}
...
}
{
bidding_strategy_type: MAXIMIZE_CONVERSION_VALUE
maximize_conversion_value: {
target_roas: 2.0
}
...
}


What to do

The Google Ads API already prohibits creating or updating standard (non-portfolio) TargetCpa or TargetRoas bidding strategies for Search campaigns. In July, any code that reads or manages remaining strategies of those types should account for the settings migrating to MaximizeConversions and MaximizeConversionValue.

If you have any questions or need additional help, contact us via the forum or at [email protected].

Change in the maximum number of mutate operations per request for BatchJobService.AddBatchJobOperations

On June 30, 2022, we’ll limit the number of mutate operations that can be sent to BatchJobService.AddBatchJobOperations to 5,000 mutate operations per request. After this change rolls out, any AddBatchJobOperations requests that contain more than 5,000 mutate operations will result in a SizeLimitError.REQUEST_SIZE_LIMIT_EXCEEDED error.

Note that this will not change the total number of operations you are allowed to add to a BatchJob. It only changes the number of operations you can add to a BatchJob in a single AddBatchJobOperations request.

What do you need to do?
  • Ensure that your code doesn’t send more than 5,000 mutate operations per AddBatchJobOperations request to the Google Ads API.
  • In rare cases, you may still encounter the SizeLimitError.REQUEST_SIZE_LIMIT_EXCEEDED error due to the total size of the request payload, even when you send a request with fewer than 5,000 mutate operations. Therefore, your code should retry the request with half the number of mutate operations until it succeeds. For instance, if 5,000 mutate operations fail, try 2,500 mutate operations. If 2,500 mutate operations fail, try 1,250 mutate operations, and so on.
If you have any questions or need additional help, contact us through the forum.