What’s changed?
Today, we're excited to announce that the brand guidelines rollout is now complete for all new Performance Max campaigns created through the Google Ads UI, with API-created accounts soon to follow . As was first announced in December, this means that new PMax campaigns initiated in the UI will have brand guidelines enabled by default, offering advertisers greater control over their brand's representation.
With brand guidelines rolling out to more Performance Max campaigns, it is crucial to understand how this impacts campaigns you interact with via the API, and for you to update your code in advance to prepare for it.
What do API Users need to update now?
Previously, brand assets such as your business name and logo were associated with Asset Groups.
Currently, for any PMax campaign with brand guidelines enabled, these brand assets are now stored at the campaign level . This means if your application queries or modifies brand assets for PMax campaigns, you must adjust your code to look for these assets in CampaignAsset
instead of AssetGroupAsset
for these campaigns. Accounting for both asset locations in your application is vital to ensure your integrations continue to function as expected. To determine if brand guidelines are enabled for a PMax Campaign, check the Campaign.brand_guidelines_enabled
field.
What do API Users need to plan for in the future?
Brand guidelines will be enabled by default when creating PMax Campaigns using the API beginning in v21 . You can optionally disable brand guidelines by setting the Campaign.brand_guidelines_enabled
field to false on-creation. The default behavior for brand guidelines on new Performance Max campaigns created via the API remain disabled for all supported versions through v20.
To manually turn on brand guidelines through the API, you have two options:
Starting in v19 , all API users can choose to manually enable brand guidelines when creating a new PMax campaign. To do so, you need to set the Campaign.brand_guidelines_enabled
field to true during campaign creation. You can refer to the “Add Performance Max Campaign ” code sample for an example of how to create a campaign with brand guidelines enabled.
To manually enable brand guidelines for an existing campaign, use CampaignService.EnablePMaxBrandGuidelines . Set auto_populate_brand_assets to true to automatically populate the campaign with top-performing brand assets. Disabling brand guidelines for a campaign after its creation is not supported.
There is an in-progress automatic migration to enable brand guidelines for existing campaigns. As previously announced , this migration has already begun on a rolling basis by CID. Only campaigns that use the same logos and business name across all asset groups will be automatically migrated. We anticipate the migration to be completed for all applicable CIDs by October 30th . In the meantime, we encourage you to use the existing migration endpoint to manually update your campaigns to brand guidelines at your own pace.
- Sarah Pollack, Google Ads API Team