Amazon Ads

Last updated on Oct 01, 2024

From Release 2.27.3 onwards, Hevo uses the Exports API for data ingestion related to core objects of Sponsored Products . Amazon Ads will deprecate the Snapshots API, which Hevo previously used, on October 15, 2024. To ensure continued support for existing functionalities, Hevo will automatically migrate your existing Pipelines to the new API.


The API update impacts data ingestion for the following objects:

Objects Changes
Ad Groups - Source object schema is changed and substituted by new object, Ad_Groups_V2.
Campaigns - Source object schema is changed and substituted by new object, Campaigns_V2.
Campaigns Negative Keywords - Source object is deprecated, and the data has been moved to the Product_Targeting_V2 object. You can filter this data type within the object using the targetType field.
Keywords - Source object is deprecated, and the data has been moved to the Product_Targeting_V2 object. You can filter this data type within the object using the targetType field.
Negative Keywords - Source object is deprecated, and the data has been moved to the Product_Targeting_V2 object. You can filter this data type within the object using the targetType field.
Negative Product Targeting - Source object is deprecated, and the data has been moved to the Product_Targeting_V2 object. You can filter this data type within the object using the targetType field.
- Child objects negative_product_targeting_expression and negative_product_targeting_resolved_expression are removed.
Product Ads - Source object schema is changed and substituted by new object, Product_Ads_V2.
Product Targeting - Source object schema is changed and substituted by new object, Product_Targeting_V2.
- Product_Targeting_V2 contains data for Negative Product Targeting, Negative Keywords, Keywords, and Campaigns Negative Keywords data types. You can filter the data within the object for these data types using the targetType field.
- Child objects product_targeting_expression and product_targeting_resolved_expression are removed.


In your existing Pipelines, the older objects you had selected for ingestion will be marked as completed, and the corresponding new objects will be added.

Amazon Ads (formerly known as AMS or Amazon Marketing Services) is an advertising platform that allows you to create product ads. It also provides various advertising performance measurement tools and analytics solutions to help you optimize your marketing strategy.

Hevo ingests data for the Sponsored Products, Sponsored Display, and Sponsored Brands ads from Amazon.

Hevo uses the Amazon Ads API to ingest the data from your Amazon Ads account and replicate it into the desired Destination database or data warehouse for scalable analysis. You must authorize Hevo to access data from your Amazon Ads account.


Source Considerations

  • Amazon Ads retains data of only the last 95 days for all the reports. This is to ensure that the data is up-to-date and relevant for advertisers. However, the Sponsored Brands Purchased Products report is an exception as it retains data for the last 731 days. This allows advertisers to see long-term performance of their ads and the impact of their campaigns on their sales.

  • The impact metrics for the CONVERSION_OPPORTUNITIES bidding theme are weekly clicks and orders received for similar products. This allows advertisers to measure the performance of their ads on a weekly basis and see how many clicks and orders their ads are generating. For other event-based themes, the impact metrics are clicks and orders received for similar products during the event days. This allows advertisers to measure the performance of their ads during a specific event.


Limitations

  • None.



Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Sep-30-2024 2.28.1 Updated section, Data Replication to change the default ingestion frequency to 12 Hrs.
Sep-16-2024 2.27.3 Updated sections, Data Model and Schema and Primary Keys to add information about changes to the Amazon Ads ERD with the Export API update.
Mar-05-2024 2.21 Updated the ingestion frequency table in the Data Replication section.
Jul-19-2023 NA New document.

Tell us what went wrong