Amazon Ads Connector for Azure Data Factory (SSIS) : Get beta report

Prerequisites

Before we begin, make sure the following prerequisites are met:

1. SQL Server Data Tools (SSDT) designer installed for Visual Studio.
2. SQL Server Integration Services Projects 2022+ Visual Studio extension installed.
3. SSIS PowerPack is installed.

Get beta report in SSIS

1. Open Visual Studio and click Create a new project.

2. Select Integration Services Project. Enter a name and location for your project, then click OK.

3. From the SSIS Toolbox, drag and drop a Data Flow Task onto the Control Flow surface, and double-click it:

   

4. Make sure you are in the Data Flow Task designer:

   

5. From the SSIS toolbox drag and API Source (Predefined Templates) on the data flow designer surface, and double click on it to edit it:
   

   

6. Select New Connection to create a new connection:
   

   

7. Use a preinstalled Amazon Ads Connector from Popular Connector List or press Search Online radio button to download Amazon Ads Connector. Once downloaded simply use it in the configuration:
   

   Amazon Ads

   

8. Select your authentication scenario below to expand connection configuration steps to:

   • Configure the authentication in Amazon Ads.
   • Enter those details into the API Connection Manager configuration.
   OAuth Authentication

   Amazon Ads authentication

   Amazon OAuth Security Profile has be created in Amazon Developer portal. [API reference]

   1. Firstly, login into Amazon Developer portal in https://developer.amazon.com.

   2. Then click Sign in.

   3. If you don't have an account, press Create your Amazon Developer account button to create one.

   4. Once logged in, click on your profile icon on the right-top of the window and hit Settings:

      

   5. Then click Security Profiles and proceed with creating a new Security Profile:

      

   6. After that, click Web Settings subtab, then hit Show Secret button to reveal the Client Secret (you will need it later), and click Edit to add a Redirect URL:

      

   7. Continue by setting Allowed Return URLs (you can have your own or use https://zappysys.com/oauth):

      

   8. Done! Now you can use Client ID, Client Secret, and Redirect URL when configuring OAuth Authentication parameters:

      

   API Connection Manager configuration

   Just perform these simple steps to finish authentication configuration:

   1. Set Authentication Type to OAuth Authentication [OAuth]
   2. Optional step. Modify API Base URL if needed (in most cases default will work).
   3. Fill in all the required parameters and set optional parameters if needed.
   4. Press Generate Token button to generate the tokens.
   5. Finally, hit OK button:

   Amazon Ads

   OAuth Authentication [OAuth]

   https://advertising-api.amazon.com/v2

   Required Parameters
   ClientId	Fill-in the parameter...
   ClientSecret	Fill-in the parameter...
   AuthorizationUrl	Fill-in the parameter...
   ReturnUrl	Fill-in the parameter...
   Scope	Fill-in the parameter...
   Profile (click 'Generate Token' before this)	Fill-in the parameter...
   Optional Parameters
   RetryMode	RetryWhenStatusCodeMatch
   RetryStatusCodeList	429
   RetryCountMax	5
   RetryMultiplyWaitTime	True

   

   Find full details in the Amazon Ads Connector authentication reference.

9. Select Get Beta Report endpoint from the dropdown and hit Preview Data:

   

   API Source - Amazon Ads

   Read and write Amazon Ads data effortlessly. Integrate, manage, and automate campaigns, ad groups, and performance metrics — almost no coding required.

   Amazon Ads

   Get Beta Report

   Required Parameters
   Report Name	Fill-in the parameter...
   Report Type	Fill-in the parameter...
   Report Start Date (yyyy-MM-dd) Maximum date range: 31 days	Fill-in the parameter...
   Report End Date (yyyy-MM-dd) Maximum date range: 31 days	Fill-in the parameter...
   Report Start Date (yyyy-MM-dd) Maximum date range: 731 days	Fill-in the parameter...
   Report End Date (yyyy-MM-dd) Maximum date range: 731 days	Fill-in the parameter...
   Optional Parameters
   Time Unit	SUMMARY
   Group By	campaign
   Group By	targeting
   Group By	searchTerm
   Group By	advertiser
   Group By	asin
   Metrics	clicks
   Metrics	clicks
   Metrics	clicks
   Metrics	clicks
   Metrics	clicks
   Metrics	clicks

   

10. That's it! We are done! Just in a few clicks we configured the call to Amazon Ads using Amazon Ads Connector.

    You can load the source data into your desired destination using the Upsert Destination , which supports SQL Server, PostgreSQL, and Amazon Redshift. We also offer other destinations such as CSV , Excel , Azure Table , Salesforce , and more . You can check out our SSIS PowerPack Tasks and components for more options. (*loaded in Trash Destination)

    

Deploy SSIS package to Azure Data Factory (ADF)

Once your SSIS package is complete, deploy it to the Azure-SSIS runtime within Azure Data Factory. The setup process requires you to upload the SSIS PowerPack installer to Azure Blob Storage and then customize the runtime configuration using the main.cmd file. For a complete walkthrough of these steps, see our detailed guide on the Azure Data Factory (SSIS) and Amazon Ads integration.

Amazon Ads Connector actions

Need another use case? Pick the next Amazon Ads action in Azure Data Factory (SSIS) below.

• Get Profiles
• Get Report
• Test Connection
• Make Generic REST API Request
• Make Generic REST API Request (Bulk Write)

Conclusion

You now know how to get beta report in Azure Data Factory (SSIS) without writing complex code. Amazon Ads Connector handled pagination and authentication automatically.

Ready to get started? Download the trial or ping us via chat if you need help: