Automated extensions

In addition to manual extensions, the Google Ads API supports automated asset-based extensions, also known as dynamic extensions. As the name implies, automated extensions are managed automatically by Google Ads, and the scope of the API is limited to pausing or removing individual extensions and retrieving stats.

Extension creation and updates

Once an account is opted in to this feature, Google Ads creates automated extensions as follows:

  1. Assets are created for the automated extension.
  2. CampaignAsset, AdGroupAsset, or CustomerAsset objects are created to associate the extension with campaign, ad group, or customer resources, respectively.

You cannot create or update automated assets using the Google Ads API, nor can you create CampaignAsset, AdGroupAsset, or CustomerAsset for the automated extensions using the Google Ads API.

You can use API version v11 or higher to pause or remove CampaignAsset, AdGroupAsset, or CustomerAsset entities that associate the automated asset extension with the corresponding resource.

Pause or remove the association

Pausing the association disables the extension from serving against the corresponding entity temporarily. Once you pause the association, Google Ads won't automatically re-enable or serve the corresponding automated extension against that resource until it is re-enabled through the UI or API. Remove the association to permanently disable the extension from being associated with the entity.

Google Ads enforces a limit on the number of automated extensions of a given type that can be associated with a given entity (for example, automated sitelinks per campaign). A paused association counts against this limit, whereas a removed association doesn't. Automated extensions don't count towards the limits for manually added extensions.

Retrieving automated extensions

API version v11 and higher lets users retrieve automated extensions. You can filter for AssetSource = AUTOMATICALLY_CREATED when retrieving Asset, CustomerAsset, CampaignAsset, or AdGroupAsset entities. The following automated extension types are currently supported:

  • Callout
  • Sitelink
  • Structured snippet

More extension types could be supported in the future.

Reports

Asset-based extension performance statistics can be requested from the asset_field_type_view report. This report includes the aggregated stats for both automated and manual extensions.

Performance stats for individual extensions can be retrieved from the campaign_asset, customer_asset, and ad_group_asset reports in API version v11.