Skip to main content

Amazon Ads Migration Guide

Upgrading to 5.0.0

The following streams have updated schemas due to a change with the Amazon Ads API:

  • SponsoredBrandsCampaigns
  • SponsoredBrandsAdGroups
  • SponsoredProductsCampaigns
  • SponsoredProductsAdGroupBidRecommendations

Schema Changes - Removed/Added Fields

Stream NameRemoved FieldsAdded Fields
SponsoredBrandsCampaignsserviceStatus, bidOptimization, bidMultiplier, adFormat, bidAdjustments, creative, landingPage, supplySourceruleBasedBudget, bidding, productLocation, costType, smartDefault, extendedData
SponsoredBrandsAdGroupsbid, keywordId, keywordText, nativeLanuageKeyword, matchTypeextendedData
SponsoredProductsCampaignscampaignType, dailyBudget, ruleBasedBudget, premiumBidAdjustment, networksdynamicBidding, budget, extendedData
SponsoredProductsAdGroupBidRecommendationssuggestedBidtheme, bidRecommendationsForTargetingExpressions

Refresh affected schemas and reset data

  1. Select Connections in the main navbar.
    1. Select the connection(s) affected by the update.
  2. Select the Replication tab.
    1. Select Refresh source schema.
    2. Select OK.
Any detected schema changes will be listed for your review.
  1. Select Save changes at the bottom of the page.
    1. Ensure the Reset affected streams option is checked.
Depending on destination type you may not be prompted to reset your data.
  1. Select Save connection.
This will reset the data in your destination and initiate a fresh sync.

For more information on resetting your data in Airbyte, see this page.

Upgrading to 4.0.0

Streams SponsoredBrandsAdGroups and SponsoredBrandsKeywords now have updated schemas.

Refresh affected schemas and reset data

  1. Select Connections in the main navbar.
    1. Select the connection(s) affected by the update.
  2. Select the Replication tab.
    1. Select Refresh source schema.
    2. Select OK.
Any detected schema changes will be listed for your review.
  1. Select Save changes at the bottom of the page.
    1. Ensure the Reset affected streams option is checked.
Depending on destination type you may not be prompted to reset your data.
  1. Select Save connection.
This will reset the data in your destination and initiate a fresh sync.

For more information on resetting your data in Airbyte, see this page.

Upgrading to 3.0.0

A major update of attribution report stream schemas. For a smooth migration, a data reset and a schema refresh are needed.