Google Ads Developer Blog: migration

Google Ads Scripts migration office hours

2022 m. rugpjūčio 2 d., antradienis

migration guideoffice hours information pageAs a reminderforumgoogleadsscripts-support@google.com - Mike Cloonan, Google Ads Scripts Team

Performance Max upgrade has started

2022 m. liepos 22 d., penktadienis

As we announced in January and again in March, existing and future Smart Shopping campaigns (SSC) will automatically upgrade to Performance Max campaigns between July and September 2022. The self-upgrade started in April 2022. The automatic upgrade has commenced (related blog post) and should complete by September 30, 2022. This blog post adds details for our API developers. Starting July 25, 2022, accounts without active or paused SSCs (including new accounts) will no longer be able to create SSCs. Once an account with active or paused SSCs has been automatically upgraded from SSC to Performance Max, no new SSC creation will be permitted in any surface including the UI, the API, Google Ads Scripts or Google Ads Editor. The Google Ads API v11 included a new UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation recommendation type to allow developers to upgrade a given SSC to a Performance Max campaign. This can still be applied to an account that has not yet automatically upgraded. As mentioned in the January blog post, Local campaigns will also be automatically upgraded to Performance Max. An upcoming release of the Google Ads API will include a new recommendation type to allow developers to upgrade an eligible Local campaign to a Performance Max campaign. Additional information If you have any questions or need additional help, contact us via the forum.

David Wihl, Google Ads API Team

Smart Shopping campaign upgrade to Performance Max - update

2022 m. kovo 17 d., ketvirtadienis

As we announced in January, existing and future Smart Shopping campaigns (SSC) will automatically upgrade to Performance Max campaigns between July and September 2022. As mentioned in the prior blog post, users will be able to self-upgrade in the UI starting April 2022. Developers will be able to self-upgrade in the API before the end of June. We expect the vast majority of accounts managed by the API will opt to wait to self-upgrade once the tool is available in the API in June. However, campaigns may be upgraded manually by advertisers in the UI starting in April. We recommend you implement Performance Max in your application now to ensure support for any new or upgraded Performance Max campaigns. An upgraded SSC will be marked as REMOVED status (metrics will continue to be available in the legacy campaign for historical purposes). There will also be a mapping from the previous campaign ID to the new Performance Max campaign ID. Budgets, assets, and settings of the existing SSC are preserved. The prior blog post had April / May 2022 as the estimated availability date for the API's new self-upgrade recommendation type. This will be available before the end of June. There will still be a six week period between availability of the new recommendation type in the API and the start of auto-upgrades. Note that once a campaign has been upgraded, either by the UI or API, there is no means to revert the upgrade. Metrics will continue to be available in the legacy campaign for historical purposes. Additional information If you have any questions or need additional help, contact us via the forum.

David Wihl, Google Ads API Team

Google Ads API v10 RMF Update

2022 m. vasario 9 d., trečiadienis

version 10Required Minimum Functionalityupgrade of Smart Shopping and Local Campaigns to Performance MaxStandard ShoppingHotel-onlyApp Promotion-onlyproduct specific RMFSmart Campaignsminimum set of featuresPerformance Maxwill

Shopping-only, Smart Shopping-only API tools

Special purpose tools that offer campaign creation or management functionality

will notRequired Minimum FunctionalityRequirements for the AdWords APIStandard Shopping Campaignssimplified RMF requirements for Full-service toolssimplified or reduced in scope

Item Number

Functionality

Change

C.190

Create ad group

Optional: ability to create multiple ad groups

C.525

Add first (root) product partition

This is a required step for creating a shopping campaign and it is done automatically. It is not separately invoked by the merchant. A new campaign should have a root partition otherwise it would not serve.

M.10

Edit campaign settings

Only settings required at creation time would be required at change time (e.g. NetworkSettings would not be required to edit, since C.50 is no longer a requirement).

R.10

Customer

Optional if only implementing one campaign.

no longer requiredTerms & Conditions

Item Number

Functionality

C.14

Set mobile platform bid adjustment

C.15

Set tablet and desktop platform bid adjustments

C.21

Enable distance targeting

C.25

Set geo bid adjustment

C.50

Opt in/out of networks

C.90

Set bidding option: Manual CPC

C.95

Set bidding option: Enhanced CPC

C.101

Set bidding option: Maximize clicks (Portfolio)

C.140

Set delivery method

C.191

Set ad group max CPC bid

C.192

Set ad group max CPA

C.193

Set ad group target ROAS

C.320

Account-level tracking template

C.321

Campaign-level tracking template

C.325

Campaign-level custom parameters

C.326

Ad group-level custom parameters

C.328

Account-level final URL suffix

C.329

Campaign-level final URL suffix

C.700

Create ad group/campaign criterion that targets/excludes user list

C.710

Set userlist targeting bid adjustment for search network campaigns and ad groups

M.15

Edit mobile, tablet, and desktop platform bid adjustments

M.20

Edit ad group settings (all ad group-related required settings in Creation Functionality)

M.25

Edit geo bid adjustment

M.101

Edit bidding option: Maximize clicks (Standard)

M.120

Pause / enable / remove ad group

M.180

Edit product partition max CPC*

M.320

Manage all tracking templates in creation functionality

M.325

Manage all custom parameters in creation functionality

M.328

Manage all final URL suffixes in creation functionality

M.700

Edit ad group/campaign criterion that targets/excludes user list

M.710

Edit userlist targeting bid adjustment for search network campaigns and ad groups

R.30

Ad Group

R.80

Geographic View

R.150

Campaign Audience View
Ad Group Audience View

For more informationhttps://services.google.com/fb/forms/apicontact/forum

David Wihl, Google Ads API Team

Smart Shopping and Local Campaigns upgrading to Performance Max

2022 m. sausio 27 d., ketvirtadienis

Starting July 2022, existing and future Smart Shopping campaigns (SSC) will begin automatic upgrades to Performance Max campaigns. Local campaigns (LC) will begin automatic upgrades starting August 2022. If you manage and/or report on SSC and/or LC, you should implement Performance Max campaign features as early as possible in order to avoid loss of functionality. Closer to July, we will provide more details and precise timing.

We recommend you begin to build integrations now to ensure adequate preparation for migration.

New retail and local campaigns

Performance Max has been available in the Google Ads API since v9. We recommend you use Performance Max today for any new campaigns with online, offline or omnichannel sales goals.

SSC can be created without conversion tracking. While Performance Max campaigns, including retail, do not require conversion tracking, it is highly recommended.

Ways to upgrade

Here are the ways you will be able to upgrade existing campaigns to Performance Max:

[Recommended] Self-upgrade through API recommendations. In an upcoming Google Ads API release later this year, a new recommendation type will be available for per-campaign or bulk upgrades. You can use this to control the sequence of campaign upgrades or apply all recommendations at one time. There will be equivalent upgrade options available in the Google Ads UI. Self- and auto-upgraded campaigns will carry forward some learnings from the legacy campaign to help ensure continuity.
Auto-upgrade. Starting July 2022, SSC will be auto-upgraded to Performance Max on a rolling basis. Starting August 2022, LC will be auto-upgraded on a rolling basis.
Create a new Performance Max campaign through the API. This would involve creating a new Performance Max campaign with the same attributes and properties as an existing SSC or LC. Should you choose to create a new Performance Max campaign, the new campaign may not utilize the learnings of the existing SSC or LC to the same extent.

Upgrade impact on existing campaigns

An upgraded campaign, whether by self-upgrade or auto-upgrade, will:

Preserve budgets, assets, and settings of the existing SSC and LC
Mark the legacy campaign as REMOVED status (metrics will continue to be available in the legacy campaign for historical purposes)
Contain a mapping from the previous campaign ID to the new campaign ID

Upgraded campaigns will function like your previous campaigns and use existing assets to run on additional inventory that drives your conversion goals. We recommend adding additional assets to get the most value out of Performance Max.

Timeline

Date	Event
Now	Start implementing Performance Max in your application. When possible, start new campaigns with Performance Max instead of SSC or LC.
April 27, 2022	Sunset of AdWords API
April 2022	Self-upgrade period begins in the UI
April / May 2022	Self-upgrade period begins with the API's new recommendation type
July 2022	Start of SSC auto-upgrade
August 2022	Start of LC auto-upgrade
September 30, 2022	Completion of most SSC and LC auto-upgrades

Guidance for AdWords API developers

The AdWords API will sunset on April 27, 2022. Developers using SSC via the AdWords API should migrate to the Google Ads API using SSC as early as possible. The self-migration by the Google Ads API will only be available after the sunset of the AdWords API.

Additional information

For additional information, see the Google blog post about this upgrade.
If you have any questions or need additional help, contact us via the forum.

David Wihl, Google Ads API Team

Reducing RMF to help migration to the Google Ads API

2021 m. lapkričio 4 d., ketvirtadienis

Google Ads API v9Required Minimum Functionalitymigrationsunset of the AdWords API on April 27, 2022will

Full-service

Shopping-only, Smart Shopping-only, Hotel-only and App Promotion-only API tools

Special purpose tools that offer campaign creation or management functionality

Reporting-only tools

will notRequired Minimum Functionalitystill required

Item Number

Functionality

C.10

Create campaign

C.96

Set bidding option: Target CPA (Portfolio and Standard)

C.97

Set bidding option: Target ROAS (Portfolio and Standard)

C.98

Set bidding option: Maximize Conversions (Standard)

C.120

Set budget

C.260

Add keyword

C.300

Set keyword match type

M.96

Edit bidding option: Target CPA (Portfolio and Standard)

M.97

Edit bidding option: Target ROAS (Portfolio and Standard)

M.98

Edit bidding option: Maximize Conversions (Standard)

M.110

Pause / enable / remove campaign

M.130

Pause / enable / remove ad

M.140

Pause / enable / remove keyword

R.40

Ad Group Ad

R.50

Keyword View

R.70

Search Term View

R.130

Bidding Strategy

simplified or reduced in scope

Item Number

Functionality

Change

C.20

Enable geo targeting

Required. Optional to expose to the user if only one country is relevant for the user base.

C.30

Enable language targeting

Required. Optional to expose to the user if only one language is relevant for the user base.

C.65

Create website / call conversion and generate code snippet

Requires at least one type of conversion tracking.

C.75

Callout extensions

Required account level only.

C.80

Callout extensions

Required account level only.

C.190

Create ad group

Optional: ability to create multiple ad groups.

C.270

Add ad group negative keywords

Change from Ad Group level to Campaign level.

M.10

Edit campaign settings

Only settings required at creation time would be required at change time (e.g. NetworkSettings would not be required to edit, since C.50 is no longer a requirement).

R.10

Customer

Optional if only implementing one campaign.

R.20

Campaign

Remove requirements for segments.ad_network_type and segments.device.

R.100

Dynamic Search Ads Search Term View

Required only if implementing Dynamic Search Ads.

no longer requiredno longer requiredTerms & Conditions

Item Number

Functionality

C.14

Set mobile platform bid adjustment

C.15

Set tablet and desktop platform bid adjustments

C.21

Enable distance targeting

C.25

Set geo bid adjustment

C.41

Set Expanded Dynamic Search Ads

C.42

Set campaign DSA settings

C.50

Opt in/out of networks

C.70

Location extensions

C.72

App extensions

C.90

Set bidding option: Manual CPC

C.95

Set bidding option: Enhanced CPC

C.101

Set bidding option: Maximize clicks (Portfolio)

C.140

Set delivery method

C.191

Set ad group max CPC bid

C.192

Set ad group max CPA

C.193

Set ad group target ROAS

C.200

Add expanded text ad

C.290

Set keyword max CPC

C.311

Set keyword final URL

C.320

Account-level tracking template

C.321

Campaign-level tracking template

C.325

Campaign-level custom parameters

C.326

Ad group-level custom parameters

C.328

Account-level final URL suffix

C.329

Campaign-level final URL suffix

C.500

Create shopping campaign*

C.505

Set merchant identifier*

C.506

Set sales country*

C.510

Set inventory filter*

C.520

Create product ad*

C.525

Add first (root) product partition*

C.530

Local inventory ads*

C.610

Call ads

C.700

Create ad group/campaign criterion that targets/excludes user list

C.710

Set userlist targeting bid adjustment for search network campaigns and ad groups

M.15

Edit mobile, tablet, and desktop platform bid adjustments

M.20

Edit ad group settings (all ad group-related required settings in Creation Functionality)

M.25

Edit geo bid adjustment

M.35

Enable ad rotation

M.40

Edit keyword max CPC

M.100

Edit expanded text ad

M.101

Edit bidding option: Maximize clicks (Standard)

M.120

Pause / enable / remove ad group

M.150

Edit inventory filter*

M.160

Subdivide (add product partition)*

M.170

Remove product partition*

M.180

Edit product partition max CPC*

M.190

Exclude product partition (delegate)*

M.320

Manage all tracking templates in creation functionality

M.325

Manage all custom parameters in creation functionality

M.328

Manage all final URL suffixes in creation functionality

M.700

Edit ad group/campaign criterion that targets/excludes user list

M.710

Edit userlist targeting bid adjustment for search network campaigns and ad groups

R.30

Ad Group

R.80

Geographic View

R.110

Shopping Performance View*

R.120

Product Group View*

R.150

Campaign Audience View
Ad Group Audience View

still need to implement these featuresthe Google Ads API Compliance teamforum

David Wihl, Google Ads API Team

Register for the Google Ads API Migration Workshop

2021 m. rugsėjo 29 d., trečiadienis

As previously announced, the Google Ads API Migration Workshop is only one week away. Register today to reserve your spot. As a reminder, the workshop will provide you with knowledge, resources, and support to migrate from the AdWords API to the Google Ads API. We’re offering this live workshop in three regions. Follow the links below to view the full agenda in your region. Session Dates

Americas: Oct 5 - Oct 7

EMEA: Oct 5 - Oct 7

APAC: Oct 12 - Oct 14

We look forward to seeing you!

- Devin Chasanoff, on behalf of the Google Ads API Team

Announcing The Google Ads API Migration Workshop

2021 m. rugsėjo 9 d., ketvirtadienis

Today, we’re announcing The Google Ads API Migration Workshop, which will be presented live in three regions, to provide you with knowledge, resources, and support to migrate from the AdWords API to the Google Ads API.
Session Dates

Get to know the team supporting your migration during this three-day virtual workshop as we:

Teach you about the new API
Walk through interactive demonstrations
Help you create a migration plan
Discuss best practices for migrating your application

Whether you’re new to the Google Ads API or want to level up your skill set, we'll have a variety of sessions to help you achieve your goals. We’ll be delivering several talks to discuss what’s new in the Google Ads API and explain key concepts. Tune into our interactive sessions as we demonstrate how to migrate components of your application and leverage the suite of developer tools supporting the Google Ads API.

Throughout the workshop, you’ll have the opportunity to interact with our team via live Q&A and breakout sessions. We’ll also host a panel featuring the Tech Leads of the Google Ads API Engineering and Developer Relations teams.

Follow the event link to register for the event and view the full agenda. We look forward to seeing you!

- Devin Chasanoff, on behalf of the Google Ads API Team

Sunsetting the creation of target spend field for Maximize Clicks strategies in Google Ads API

2019 m. birželio 3 d., pirmadienis

On July 31st, 2019 we will begin to sunset the target spend field for Maximize Clicks bidding strategies in the API. This will affect all versions of both the AdWords API and Google Ads API. The following behaviors will be blocked:

Populating the target spend field on existing standard and portfolio strategies.
Attaching portfolio strategies that have the deprecated field set to campaigns.

Later this year, our systems will start ignoring the target spend field and instead use your daily budget to manage spend. In order to prepare for this change, you should start using your budgets to specify how much you’d like to spend for Maximize Clicks bidding strategies and migrate your campaigns off this field today.

Read on to see how this will affect your API usage.

	Affected Target Spend Fields
Google Ads API	`campaign.target_spend.target_spend_micros` `bidding_strategy.target_spend.target_spend_micros`
AdWords API	`Campaign.BiddingStrategyConfiguration.TargetSpendBiddingScheme.spendTarget` `SharedBiddingStrategy.TargetSpendBiddingScheme.spendTarget`

Change Description
Any mutate operations that set a target spend field for the first time will return an error. You will be able to update a target spend field that currently contain a value, but you cannot set previously empty fields to a new value. Additionally, any operation attaching a bidding strategy to a campaign, where that bidding strategy has a value set for a target spend field, will throw an error. To manage Target Spend on any new campaigns, we recommend using a campaign budget. In each of these disallowed cases an error will be thrown.

Performing any of the disallowed actions above will generate one of the following errors:

OPERATION_NOT_PERMITTED_FOR_CONTEXT
UNSUPPORTED_FIELD_IS_SET

If you have any questions about this change or any other API feature, please contact us via the forum.

- Cory Liseno, Google Ads API Team

Introducing the Google Ads Query Builder tool

2019 m. kovo 11 d., pirmadienis

Today we are excited to announce that the Google Ads Query Builder tool is now available on the Google Ads API Developer Site.

The Google Ads API has a robust reporting system that utilizes our new Google Ads Query Language. The language’s syntax allows you to select from all the resources that are available for reporting, and also filter or sort the result set on the server before they are returned to your application.

This tool provides a friendly web interface for you to explore our API’s reporting capabilities, and generate queries that you can copy and paste right into your applications. You can visit the site and try out the tool today!

Example usage of the Google Ads Query Builder: A screenshot showing a sample usage of the Google Ads Query Builder UI, including both filtering and ordering.

A screenshot showing a sample usage of the Google Ads Query Builder UI, including both filtering and ordering.

Happy reporting!

- Cory Liseno, Google Ads API Team

Ads Developer Blog

Google Ads Scripts migration office hours

Performance Max upgrade has started

Smart Shopping campaign upgrade to Performance Max - update

Google Ads API v10 RMF Update

Smart Shopping and Local Campaigns upgrading to Performance Max

Reducing RMF to help migration to the Google Ads API

Register for the Google Ads API Migration Workshop

Announcing The Google Ads API Migration Workshop

Sunsetting the creation of target spend field for Maximize Clicks strategies in Google Ads API

Introducing the Google Ads Query Builder tool

Etiketės

Archive