Collecting data from Amazon Advertising

This guide explains how to collect data from Amazon Advertising. To learn how to collect data from a different data source, go back to the Available data sources in Adverity overview.

  • Amazon Advertising can collect a maximum of 1 million rows per single report. To fetch more data than this, split your fetch into smaller date ranges in the Initial Fetch step of creating a datastream.

Prerequisites

Before you start collecting data from Amazon Advertising, perform all of the following actions:

Creating a datastream to collect data from Amazon Advertising

The basics of creating a datastream to collect data from any data source are explained in our guide to Creating a datastream. This guide contains information about the specific steps to create a datastream to fetch data from Amazon Advertising.

Authorization: Allow Adverity to access Amazon Advertising

  1. If you choose Access using your credentials or Access using someone else's credentials, in Set up or edit Profiles, you or the person granting access must choose one of the following options:

    • Choose Grant access to all Profiles, including those created in the future to allow Adverity to access all existing Profiles and all Profiles created in the future.

    • Choose Select specific Profiles to which you want to grant access to determine the specific Profiles that you want Adverity to access. Adverity will not automatically have access to Profiles created in the future. You will need to grant Adverity access to any Profiles created in the future.

    If you use your credentials to grant Adverity access to Amazon Advertising, all the Profiles available to you using your credentials will be visible in the Authorizations page to all Adverity users with permission to edit this authorization.

    If someone else uses their credentials to grant Adverity access to Amazon Advertising, the same applies to the Profiles available using their credentials.

    This is important to consider if you do not want all Adverity users with permission to edit the authorization to be able to see the details of the Profiles. For more information about user permissions, see Managing user permissions.

Configuration: Choose the data you want to collect from Amazon Advertising

To choose what data to collect and customize the Amazon Advertising datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  1. In Profiles and Portfolios, select the profiles and portfolios for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  1. In Advertising channel, select the advertising channel for which to collect data from Amazon Advertising.

  1. In Report type, select the type of data to collect from Amazon Advertising. The list of available report types changes based on the selection in the Advertising channel field. For more information, see Advanced Amazon Advertising tips.

  1. In Fields, change the list of fields that you want to see in your data extract.

For information on configuring other Amazon Advertising fields, see Advanced Amazon Advertising tips.

What's next?

Advanced Amazon Advertising tips

Configuring data collection from Amazon Advertising

In the Settings tab of your Amazon Advertising datastream overview, you can configure a number of additional settings:

Creative type

Select the creative data to collect from Amazon Advertising. If you do not select any creative items, Adverity collects data for all items in the list.

This field is active if both of the following conditions are satisfied:

  • Sponsored Brands is selected in Advertising channel.

  • The selected report type is not Stores.

You can only fetch data for Multi Ad Group campaigns if the Advertising channel is Sponsored Brands and the selected Creative type is All.

Stores

Select the stores for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

This field is active only when Sponsored Brands is selected in Advertising channel and the selected report type is Stores.

Tactics

Select the tactic data to collect from Amazon Advertising. If you do not select any tactics, Adverity collects data for all items in the list.

This field is active only when Sponsored Display is selected in Advertising channel.

Segment

Select how to segment data collected from Amazon Advertising.

This field is active if either one of the following conditions is satisfied:

  • Sponsored Brands is selected in Advertising channel and the selected report type is AdGroups, Campaigns, Keywords, or Targets.

  • Sponsored Display is selected in Advertising channel and the selected report type is AdGroups, Campaigns, or Targets.

Group by

Select how you want to group the collected data.

This field is active only when Attribution is selected in Advertising channel and the selected report type is Performance.

Campaigns

Select the campaigns for which to collect data.

This field is active only when Sponsored Products is selected in Advertising channel and the selected report type is Ad group search term impressions share.

Ad groups

Select the ad groups for which to collect data.

This field is active only when Sponsored Products is selected in Advertising channel and the selected report type is Ad group search term impressions share.

Keywords

Choose how you want to specify the keywords for which to collect data:

Type in

Select this option to manually enter the keywords for which you want to collect data.

If you select this option, in Type in, type in and select the keywords for which you want to collect data.

Value table

Select this option to provide a value table containing the keywords for which you want to collect data.

If you select this option, in Value table, select the value table containing the keywords for which you want to collect data.

This field is active only when Sponsored Products is selected in Advertising channel and the selected report type is Ad group search term impressions share or Product search term impressions share.

Keyword match type

If you have provided the keywords in the Keywords field, select a matching type from the following options:

  • BROAD - returns ads for the selected keywords and their variations, including misspellings, synonyms, and related searches.

  • EXACT - returns ads exactly matching the selected keywords.

  • PHRASE - returns ads matching the exact keyword phrase, may include additional words before or after the selected phrase.

This field is active only when Sponsored Products is selected in Advertising channel and the selected report type is Ad group search term impressions share or Product search term impressions share.

Asins

Select the asins for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

This field is active only when Sponsored Products is selected in Advertising channel and the selected report type is Product search term impressions share.

Time unit

Select the time unit in which you want to collect data.

This field is active if either one of the following conditions is satisfied:

  • Sponsored Brands is selected in Advertising channel and the selected report type is Purchased product.

  • Sponsored Products is selected in Advertising channel.

Limitations and features of different report types

Several of the report types have certain limitations and features. These are as follows:

Keywords

Select this report type to return search-term data for auto-targeted campaigns created before November 14, 2018. This report type is only available for the following advertising channels:

  • Sponsored Products

  • Sponsored Brands

Targets

Select this report type to return search-terms data for auto-targeted campaigns created on and after November 14, 2018. To use this report type, you must also select Query in the Segment field. This report type is only available for the following advertising channel:

  • Sponsored Products

Collecting profile data from Amazon Advertising

If the data collected from Amazon Advertising does not contain profile data from a certain region, this could be due to several reasons. Check the following points for solutions to this issue:

  • Make sure the merchant has set up an Adverityauthorization with the correct account.

  • If the merchant uses multiple accounts, make sure they are connecting to Adverity with the correct account.

  • If the account used to set up the authorization to Amazon DSP is a managed account, the Profiles field is hidden in the datastream configuration.

  • Make sure there is only one email address associated with each region for which to collect data. This is the email address for the authorized account. For example, only use the email amazon-eu@xyz.com for data collection in the EU region and the email amazon-na@xyz.com for data collection in the NA region.

  • Make sure the merchant has created at least Sponsored Products campaign.

  • Make sure the account used in the Adverityauthorization has View and Edit permissions for Campaign Management.