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:
- Assets are created for the automated extension.
CustomerAssetobjects 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
CustomerAsset for the automated extensions
using the Google Ads API.
You can use API version v11 or higher to pause or remove
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
AssetSource = AUTOMATICALLY_CREATED
entities. The following automated extension types are currently supported:
- Structured snippet
More extension types could be supported in the future.
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
ad_group_asset reports in API version v11.