Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.

Migrate dynamic remarketing campaigns from Feeds to Assets

This document describes the migration and sunset process for Feed-based dynamic remarketing. Feed-based dynamic remarketing will be migrated to new Asset-based system in batches, and will fully sunset in late 2022.

The existing Feed-based paradigm is deprecated in favor of Asset-based. Asset- based dynamic remarketing reduces the complexity of creating and managing dynamic content. Action is required in order to ensure that you maintain control over your dynamic content.

The term "Feed-based dynamic remarketing" refers to any of the resources or functions associated with the following services:

While Feed-based and Asset-based dynamic remarketing will coexist for a time, we strongly recommend using Asset-based dynamic remarketing as soon as is feasible.

Migration schedule

All existing Feed-based dynamic content will automatically migrate to Asset-based in batches:

Dynamic remarketing type Auto Migration Date
April 27, 2022
  • Custom
  • Flight
  • Hotel
  • Job
  • Location
  • Real estate
  • Travel
October 5, 2022

All CREATE and MUTATE actions will be disabled for the relevant content types after each auto migration date. Unlike batch 1 of the extensions migration there is no opt-out available. You must either perform the migration manually, or the accounts will be auto-migrated on the above date.

Migration procedure

Feeds are migrated by copying their existing values into a new Asset-based container. Existing Feed-based content will be automatically copied into assets on specific dates. The asset will have a new unique ID generated, however the IDs used by tracking pixels will stay the same.

We recommend performing the migration process yourself through the Google Ads API as outlined in this guide. Although you may wait for Google to run the auto-migration on your behalf, it will be difficult to maintain both Feed-based and Asset-based data in parallel, especially considering the FeedItem IDs will not match the Asset IDs.

Identify feeds which are used for dynamic remarketing campaigns

This section outlines how to retrieve the existing feed details and transform it into the asset representation.

Key point: Use the Google Ads Query Builder to construct GQAL queries.

Retrieve existing dynamic content from Feeds

First, identify any active Feed and its associated FeedMapping for the placeholder type of interest. The following GAQL query can be executed using GoogleAdsService.searchStream().

SELECT
  feed_mapping.feed,
  feed_mapping.attribute_field_mappings,
  feed.attributes,
  feed.id
FROM
  feed_mapping
WHERE feed.status != 'REMOVED'
  AND feed_mapping.placeholder_type IN ('DYNAMIC_EDUCATION')

Once you have the FeedMapping objects to be migrated, retrieve the FeedItem objects. Feed items contain the individual dynamic creatives and can be retrieved with a GAQL query to GoogleAdsService.searchStream().

SELECT
  feed_item.id,
  feed_item.attribute_values
FROM
  feed_item
WHERE
  feed.id IN (/*INSERT IDS FROM PREVIOUS QUERY*/)

Convert your feed to assets

Once you have feed item data, you can convert the feed to an Asset through the FeedMapping. The feed_mapping.attribute_field_mappings indicates how to interpret each of the feed_item.attribute_values. You'll find that most feed mappings have an equivalent field in the asset, though some may have been slightly altered during the migration.

Check out this guide for a detailed breakdown of how to create an asset-based dynamic remarketing campaign.