Join us live on Discord on the Google Advertising and Measurement Community server and on YouTube on February 26th at 10:00 AM EST! We will discuss the new features added in v23.1 of the Google Ads API.

Asset automation settings

Page Summary

Google Ads offers automatic asset optimizations to improve ad strength, including image and video asset creation and optimization.
Each asset automation has a type and a status indicating if it's enabled or disabled.
Some asset automations are configured at the campaign level, while others are set at the ad group ad level.
Campaign-level asset automations support various campaign types and have different default settings.
Ad-level asset automations apply to single ads, support specific ad types, and have varying default statuses.

Google Ads provides several asset optimizations that can be performed automatically to improve the ad strength of your ads.

These range from automatically creating image assets with a preview of an ad's landing page, to optimizing video assets for different formats and different lengths.

Each asset automation setting has an asset_automation_type, which defines the type of asset automation it represents, and an asset_automation_status, which represents whether the automation is enabled or disabled.

Some asset automations are configured at the campaign level, while others are set at the ad group ad level.

Campaign-level asset automation settings

These configure an asset automation for an entire campaign. Not all of them are available for every campaign type: refer to the reference documentation for further details.

Asset automation type	Supported campaign types	Default
FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	Performance Max, Search	Enabled for Performance Max, disabled for Search
GENERATE_ENHANCED_YOUTUBE_VIDEOS	Performance Max	Enabled
GENERATE_IMAGE_ENHANCEMENT	Performance Max	Enabled for Performance Max, disabled for Search
GENERATE_IMAGE_EXTRACTION	Performance Max	The account-level Dynamic Image Extension control value. Note: This account-level setting can only be configured in the Google Ads web interface.
TEXT_ASSET_AUTOMATION	Performance Max, Search	Enabled for Performance Max, disabled for Search

The following snippet shows how to set asset automation settings to OPT_IN for a PMax campaign:

Java

// Configures the optional opt-in/out status for asset automation settings.
.addAllAssetAutomationSettings(ImmutableList.of(
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.GENERATE_IMAGE_EXTRACTION)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(
            AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.TEXT_ASSET_AUTOMATION)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.GENERATE_IMAGE_ENHANCEMENT)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build()))AddPerformanceMaxCampaign.java

C#

campaign.AssetAutomationSettings.AddRange(new[]{
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.GenerateImageExtraction,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.FinalUrlExpansionTextAssetAutomation,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.TextAssetAutomation,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.GenerateEnhancedYoutubeVideos,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.GenerateImageEnhancement,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
});AddPerformanceMaxCampaign.cs

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

# Configures the optional opt-in/out status for asset automation settings.
for asset_automation_type_enum in [
    client.enums.AssetAutomationTypeEnum.GENERATE_IMAGE_EXTRACTION,
    client.enums.AssetAutomationTypeEnum.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,
    client.enums.AssetAutomationTypeEnum.TEXT_ASSET_AUTOMATION,
    client.enums.AssetAutomationTypeEnum.GENERATE_ENHANCED_YOUTUBE_VIDEOS,
    client.enums.AssetAutomationTypeEnum.GENERATE_IMAGE_ENHANCEMENT,
]:
    asset_automattion_setting: Campaign.AssetAutomationSetting = (
        client.get_type("Campaign").AssetAutomationSetting()
    )
    asset_automattion_setting.asset_automation_type = (
        asset_automation_type_enum
    )
    asset_automattion_setting.asset_automation_status = (
        client.enums.AssetAutomationStatusEnum.OPTED_IN
    )
    campaign.asset_automation_settings.append(asset_automattion_setting)add_performance_max_campaign.py

Ruby

# Configures the optional opt-in/out status for asset automation settings.
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :GENERATE_IMAGE_EXTRACTION
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :TEXT_ASSET_AUTOMATION
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :GENERATE_ENHANCED_YOUTUBE_VIDEOS
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :GENERATE_IMAGE_ENHANCEMENT
  aas.asset_automation_status = :OPTED_IN
endadd_performance_max_campaign.rb

Perl

# Configures the optional opt-in/out status for asset automation settings.
# When we create the campaign object, we set campaign->{assetAutomationSettings}
# equal to $asset_automation_settings.
my $asset_automation_settings = [];
my $asset_automation_types    = [
  GENERATE_IMAGE_EXTRACTION, FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,
  TEXT_ASSET_AUTOMATION,     GENERATE_ENHANCED_YOUTUBE_VIDEOS,
  GENERATE_IMAGE_ENHANCEMENT
];
foreach my $asset_automation_type (@$asset_automation_types) {
  push @$asset_automation_settings,
    Google::Ads::GoogleAds::V23::Resources::AssetAutomationSetting->new({
      assetAutomationStatus => OPTED_IN,
      assetAutomationType   => $asset_automation_type
    });
}add_performance_max_campaign.pl

Ad-level asset automation settings

These configure an asset automation for a single ad. Not all of them are available for every ad type: refer to the reference documentation for further details.

Asset automation type	Supported ad types	Default
GENERATE_DESIGN_VERSIONS_FOR_IMAGES	DemandGenMultiAssetAd	Enabled
GENERATE_LANDING_PAGE_PREVIEW	DemandgenVideoResponsiveAd	Disabled
GENERATE_SHORTER_YOUTUBE_VIDEOS	DemandGenVideoResponsiveAd	Enabled
GENERATE_VERTICAL_YOUTUBE_VIDEOS	DemandGenVideoResponsiveAd	Enabled
GENERATE_VIDEOS_FROM_OTHER_ASSETS	DemandGenMultiAssetAds	Enabled

Text guidelines

Text guidelines allow you to refine brand messages for automatically generated text assets in Performance Max and AI Max campaigns by specifying term exclusions and messaging restrictions.

To use text guidelines, populate the text_guidelines field of the Campaign resource:

Term exclusions: Provide a list of exact words or phrases to be excluded from generated text assets. Each exclusion can be up to 30 characters, with a maximum of 25 exclusions.
Messaging restrictions: Provide freeform instructions (up to 300 characters each) to guide AI text generation. You can provide up to 40 restrictions. Only RESTRICTION_BASED_EXCLUSION is supported for the restriction type.

Automated assets

Business message assets

Asset automation settings Stay organized with collections Save and categorize content based on your preferences.