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:
- AdGroupFeedService
- CampaignFeedService
- CustomerFeedService
- FeedItemTargetService
- FeedItemService
- FeedMappingService
- FeedService
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 | |
| 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.