Amazon Ads Connector for JAVA
In this article you will learn how to integrate Amazon Ads data in JAVA
(live / bi-directional connection to Amazon Ads).
Amazon Ads Connector can be used to get Amazon advertisements using Amazon Advertisements API, download various advertisement-related reports..
Using Amazon Ads Connector you will be able to connect, read, and write data from within JAVA. Follow the steps below to see how we would accomplish that.
Download
Documentation
The driver mentioned above is part of ODBC PowerPack which is a collection of high-performance Drivers for various API data source (i.e. REST API, JSON, XML, CSV, Amazon S3 and many more). Using familiar SQL query language you can make live connections and read/write data from API sources or JSON / XML / CSV Files inside SQL Server (T-SQL) or your favorite Reporting (i.e. Power BI, Tableau, Qlik, SSRS, MicroStrategy, Excel, MS Access), ETL Tools (i.e. Informatica, Talend, Pentaho, SSIS). You can also call our drivers from programming languages such as JAVA, C#, Python, PowerShell etc.
If you are new to ODBC and ZappySys ODBC PowerPack then check the following links to get started.
|
Connect to Amazon Ads in other apps
|
Create Data Source in ZappySys Data Gateway based on API Driver
-
Download and install ZappySys ODBC PowerPack.
-
Search for gateway in start menu and Open ZappySys Data Gateway:
-
Go to Users Tab to add our first Gateway user. Click Add; we will give it a name tdsuser and enter password you like to give. Check Admin option and click OK to save. We will use these details later when we create linked server:
-
Now we are ready to add a data source. Click Add, give data source a name (Copy this name somewhere, we will need it later) and then select Native - ZappySys API Driver. Finally, click OK. And it will create the Data Set for it and open the ZS driver UI.
AmazonAdsDSN
-
When the Configuration window appears give your data source a name if you haven't done that already,
then select "Amazon Ads" from the list of Popular Connectors. If "Amazon Ads" is not present
in the list, then click "Search Online" and download it. Then set the path to the location where you
downloaded it. Finally, click Continue >> to proceed with configuring the DSN:
AmazonAdsDSN
Amazon Ads
-
Now it's time to configure the Connection Manager. Select Authentication Type,
e.g. Token Authentication. Then select API Base URL (in most cases, the default one is the right one).
More info is available in the Authentication section.
OAuth App must be created in Atlassian Developer Console. It is found at https://developer.atlassian.com/console/myapps/
[API reference]
Steps how to get and use Amazon Ads credentials : OAuth Authentication [OAuth]
Firstly, login into Amazon Developer portal:
- Visit https://developer.amazon.com.
- Then click Sign in.
- If you don't have an account, press the button Create your Amazon Developer account.
- Once logged in, click on your profile icon on the right-top of the window.
- A menu appears, and then click 'Settings'.
- Then click Security Profiles.
- Proceed with creating a new Security Profile.
- Once you named it, click 'Save'.
- After that, click 'Web Settings' subtab.
- A window refreshes, click 'Show Secret' button and write down Client ID and Client Secret, you will need them later.
- Then press 'Edit' and add Allowed Return URLs. It can be your domain or you can use https://zappysys.com/oauth. Note it, you will need it in configuration.
- Close web browser.
- Now it's time to configure Amazon Ads API data source.
- Fill in all blank Required Parameters:
- ClientId
- ClientSecret
- ReturnUrl
- Click Generate Token to generate tokens.
- Now you can select the 'Profile' to work with.
- That's it!
Fill in all required parameters and set optional parameters if needed:
AmazonAdsDSN
Amazon Ads
OAuth Authentication [OAuth]
https://advertising-api.amazon.com/v2
-
Once the data source has been configured, you can preview data. Select the Preview tab and use settings similar to the following to preview data:
-
Click OK to finish creating the data source.
Read data in Java from the DSN
-
Java code to get the data:
"jdbc:sqlserver://localhost:5000;databasename=AmazonAdsDSN;user=tdsuser;password=test"
-
When you run the code it will make the API call and read the data:
-
Here is Java program's code in text format:
//Step-1: Install ZappySys ODBC PowerPack and Configure Data Gateway
//Step-2:Assuming the Microsoft SQL Server JDBC Driver is in below folder
//C:\Program Files\Microsoft Jdbc Driver 6.0 for SQL Server\sqljdbc_6.0\enu\auth\x64
package padaone;
import java.sql.*;
public class zappy {
public static void main(String[] args) {
// Create a variable for the connection string.
String connectionUrl = "jdbc:sqlserver://localhost:5000;databasename=AmazonAdsDSN;user=test;password=test";
// Declare the JDBC objects.
Connection con = null;
Statement stmt = null;
ResultSet rs = null;
try {
// Establish the connection.
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
con = DriverManager.getConnection(connectionUrl);
// Create and execute an SQL statement that returns some data.
String SQL = "SELECT Country , SUM(UnitPrice * Quantity) Total "
+ "FROM value "
+ "GROUP BY Country "
+ "WITH (SRC='https://services.odata.org/V3/Northwind/Northwind.svc/Invoices?$format=json')";
stmt = con.createStatement();
rs = stmt.executeQuery(SQL);
// Iterate through the data in the result set and display it.
while (rs.next()) {
System.out.println(rs.getString(1) + " " + rs.getString(2));
}
}
// Handle any errors that may have occurred.
catch (Exception e) {
e.printStackTrace();
}
finally {
if (rs != null) try { rs.close(); } catch (Exception e) {}
if (stmt != null) try { stmt.close(); } catch (Exception e) {}
if (con != null) try { con.close(); } catch (Exception e) {}
}
}
}
Advanced topics
Create Custom Stored Procedure in ZappySys Driver
You can create procedures to encapsulate custom logic and then only pass handful parameters rather than long SQL to execute your API call.
Steps to create Custom Stored Procedure in ZappySys Driver. You can insert Placeholders anywhere inside Procedure Body. Read more about placeholders here
-
Go to Custom Objects Tab and Click on Add button and Select Add Procedure:
-
Enter the desired Procedure name and click on OK:
-
Select the created Stored Procedure and write the your desired stored procedure and Save it and it will create the custom stored procedure in the ZappySys Driver:
Here is an example stored procedure for ZappySys Driver. You can insert Placeholders anywhere inside Procedure Body. Read more about placeholders here
CREATE PROCEDURE [usp_get_orders]
@fromdate = '<<yyyy-MM-dd,FUN_TODAY>>'
AS
SELECT * FROM Orders where OrderDate >= '<@fromdate>';
-
That's it now go to Preview Tab and Execute your Stored Procedure using Exec Command. In this example it will extract the orders from the date 1996-01-01:
Exec usp_get_orders '1996-01-01';
-
Let's generate the SQL Server Query Code to make the API call using stored procedure. Go to Code Generator Tab, select language as SQL Server and click on Generate button the generate the code.
As we already created the linked server for this Data Source, in that you just need to copy the Select Query and need to use the linked server name which we have apply on the place of [MY_API_SERVICE] placeholder.
SELECT * FROM OPENQUERY([MY_API_SERVICE], 'EXEC usp_get_orders @fromdate=''1996-07-30''')
-
Now go to SQL served and execute that query and it will make the API call using stored procedure and provide you the response.
Create Custom Virtual Table in ZappySys Driver
ZappySys API Drivers support flexible Query language so you can override Default Properties you configured on Data Source such as URL, Body. This way you don't have to create multiple Data Sources if you like to read data from multiple EndPoints. However not every application support supplying custom SQL to driver so you can only select Table from list returned from driver.
If you're dealing with Microsoft Access and need to import data from an SQL query, it's important to note that Access doesn't allow direct import of SQL queries. Instead, you can create custom objects (Virtual Tables) to handle the import process.
Many applications like MS Access, Informatica Designer wont give you option to specify custom SQL when you import Objects. In such case Virtual Table is very useful. You can create many Virtual Tables on the same Data Source (e.g. If you have 50 URLs with slight variations you can create virtual tables with just URL as Parameter setting.
-
Go to Custom Objects Tab and Click on Add button and Select Add Table:
-
Enter the desired Table name and click on OK:
-
And it will open the New Query Window Click on Cancel to close that window and go to Custom Objects Tab.
-
Select the created table, Select Text Type AS SQL and write the your desired SQL Query and Save it and it will create the custom table in the ZappySys Driver:
Here is an example SQL query for ZappySys Driver. You can insert Placeholders also. Read more about placeholders here
SELECT
"ShipCountry",
"OrderID",
"CustomerID",
"EmployeeID",
"OrderDate",
"RequiredDate",
"ShippedDate",
"ShipVia",
"Freight",
"ShipName",
"ShipAddress",
"ShipCity",
"ShipRegion",
"ShipPostalCode"
FROM "Orders"
Where "ShipCountry"='USA'
-
That's it now go to Preview Tab and Execute your custom virtual table query. In this example it will extract the orders for the USA Shipping Country only:
SELECT * FROM "vt__usa_orders_only"
-
Let's generate the SQL Server Query Code to make the API call using stored procedure. Go to Code Generator Tab, select language as SQL Server and click on Generate button the generate the code.
As we already created the linked server for this Data Source, in that you just need to copy the Select Query and need to use the linked server name which we have apply on the place of [MY_API_SERVICE] placeholder.
SELECT * FROM OPENQUERY([MY_API_SERVICE], 'EXEC [usp_get_orders] ''1996-01-01''')
-
Now go to SQL served and execute that query and it will make the API call using stored procedure and provide you the response.
Actions supported by Amazon Ads Connector
Amazon Ads Connector support following actions for REST API integration. If some actions are not listed below then you can easily edit Connector file and enhance out of the box functionality.
Downloads an Amazon Ads report. [
Read more...]
Parameter |
Description |
Record Type |
Option |
Value |
campaigns |
campaigns |
adGroups |
adGroups |
keywords |
keywords |
productAds |
productAds |
asins |
asins |
|
State Filter |
Option |
Value |
enabled |
enabled |
paused |
paused |
archived |
archived |
|
Campaign Type |
Option |
Value |
sponsoredProducts |
sponsoredProducts |
headlineSearch |
headlineSearch |
|
Segment |
Option |
Value |
query |
query |
placement |
placement |
|
Report Date (yyyyMMdd) |
The date for which to retrieve the report in YYYYMMDD format. Supported functions now|today|yesterday|weekstart|weekend|monthstart|monthend|yearstart|yearend and supported intervals for add/subtract are ms|s|sec|min|h|hour|y|year|d|day|m|month|y|year. Example monthstart-3d (subtract 3days from month start)
Option |
Value |
today |
today |
yesterday |
yesterday |
monthstart |
monthstart |
monthend |
monthend |
yearstart |
yearstart |
yearend |
yearend |
weekstart |
weekstart |
weekend |
weekend |
yearstart-1y |
yearstart-1y |
yearend-1y |
yearend-1y |
monthstart-1d |
monthstart-1d |
monthend+1d |
monthend+1d |
2022-01-31 |
2022-01-31 |
|
Metrics |
Option |
Value |
adGroupId |
adGroupId |
adGroupName |
adGroupName |
attributedConversions14d |
attributedConversions14d |
attributedConversions14dSameSKU |
attributedConversions14dSameSKU |
attributedConversions1d |
attributedConversions1d |
attributedConversions1dSameSKU |
attributedConversions1dSameSKU |
attributedConversions30d |
attributedConversions30d |
attributedConversions30dSameSKU |
attributedConversions30dSameSKU |
attributedConversions7d |
attributedConversions7d |
attributedConversions7dSameSKU |
attributedConversions7dSameSKU |
attributedKindleEditionNormalizedPagesRead14d |
attributedKindleEditionNormalizedPagesRead14d |
attributedKindleEditionNormalizedPagesRoyalties14d |
attributedKindleEditionNormalizedPagesRoyalties14d |
attributedSales14d |
attributedSales14d |
attributedSales14dSameSKU |
attributedSales14dSameSKU |
attributedSales1d |
attributedSales1d |
attributedSales1dSameSKU |
attributedSales1dSameSKU |
attributedSales30d |
attributedSales30d |
attributedSales30dSameSKU |
attributedSales30dSameSKU |
attributedSales7d |
attributedSales7d |
attributedSales7dSameSKU |
attributedSales7dSameSKU |
attributedUnitsOrdered14d |
attributedUnitsOrdered14d |
attributedUnitsOrdered14dSameSKU |
attributedUnitsOrdered14dSameSKU |
attributedUnitsOrdered1d |
attributedUnitsOrdered1d |
attributedUnitsOrdered1dSameSKU |
attributedUnitsOrdered1dSameSKU |
attributedUnitsOrdered30d |
attributedUnitsOrdered30d |
attributedUnitsOrdered30dSameSKU |
attributedUnitsOrdered30dSameSKU |
attributedUnitsOrdered7d |
attributedUnitsOrdered7d |
attributedUnitsOrdered7dSameSKU |
attributedUnitsOrdered7dSameSKU |
campaignBudget |
campaignBudget |
campaignBudgetType |
campaignBudgetType |
campaignId |
campaignId |
campaignName |
campaignName |
campaignStatus |
campaignStatus |
clicks |
clicks |
cost |
cost |
currency |
currency |
impressions |
impressions |
keywordBid |
keywordBid |
keywordId |
keywordId |
keywordStatus |
keywordStatus |
keywordText |
keywordText |
matchType |
matchType |
query |
query |
|
Generates and downloads an Amazon Ads report. [
Read more...]
Parameter |
Description |
Report Name |
|
Report Type |
Option |
Value |
Campaigns |
spCampaigns |
Targeting |
spTargeting |
Search Term |
spSearchTerm |
Advertised Product |
spAdvertisedProduct |
Purchased Product |
spPurchasedProduct |
|
Time Unit |
Option |
Value |
Summary |
SUMMARY |
Daily |
DAILY |
|
Group By |
Option |
Value |
Campaign |
campaign |
Ad Group |
adGroup |
Campaign Placement |
campaignPlacement |
|
Group By |
Option |
Value |
Targeting |
targeting |
|
Group By |
Option |
Value |
Search Term |
searchTerm |
|
Group By |
Option |
Value |
Advertiser |
advertiser |
|
Group By |
Option |
Value |
ASIN |
asin |
Purchased ASIN |
purchasedAsin |
|
Report Start Date (yyyy-MM-dd) Maximum date range: 31 days |
The start date for the data to retrieve in YYYY-MM-DD format. Supported functions now|today|yesterday|weekstart|weekend|monthstart|monthend|yearstart|yearend and supported intervals for add/subtract are ms|s|sec|min|h|hour|y|year|d|day|m|month|y|year. Example monthstart-3d (subtract 3 days from month start)
Option |
Value |
today |
today |
yesterday |
yesterday |
monthstart |
monthstart |
monthend |
monthend |
yearstart |
yearstart |
yearend |
yearend |
weekstart |
weekstart |
weekend |
weekend |
yearstart-1y |
yearstart-1y |
yearend-1y |
yearend-1y |
monthstart-1d |
monthstart-1d |
monthend+1d |
monthend+1d |
2022-01-31 |
2022-01-31 |
|
Report End Date (yyyy-MM-dd) Maximum date range: 31 days |
The end date for the data to retrieve in YYYY-MM-DD format. Supported functions now|today|yesterday|weekstart|weekend|monthstart|monthend|yearstart|yearend and supported intervals for add/subtract are ms|s|sec|min|h|hour|y|year|d|day|m|month|y|year. Example monthstart-3d (subtract 3 days from month start)
Option |
Value |
today |
today |
yesterday |
yesterday |
monthstart |
monthstart |
monthend |
monthend |
yearstart |
yearstart |
yearend |
yearend |
weekstart |
weekstart |
weekend |
weekend |
yearstart-1y |
yearstart-1y |
yearend-1y |
yearend-1y |
monthstart-1d |
monthstart-1d |
monthend+1d |
monthend+1d |
2022-01-31 |
2022-01-31 |
|
Report Start Date (yyyy-MM-dd) Maximum date range: 731 days |
The start date for the data to retrieve in YYYY-MM-DD format. Supported functions now|today|yesterday|weekstart|weekend|monthstart|monthend|yearstart|yearend and supported intervals for add/subtract are ms|s|sec|min|h|hour|y|year|d|day|m|month|y|year. Example monthstart-3d (subtract 3 days from month start)
Option |
Value |
today |
today |
yesterday |
yesterday |
monthstart |
monthstart |
monthend |
monthend |
yearstart |
yearstart |
yearend |
yearend |
weekstart |
weekstart |
weekend |
weekend |
yearstart-1y |
yearstart-1y |
yearend-1y |
yearend-1y |
monthstart-1d |
monthstart-1d |
monthend+1d |
monthend+1d |
2022-01-31 |
2022-01-31 |
|
Report End Date (yyyy-MM-dd) Maximum date range: 731 days |
The end date for the data to retrieve in YYYY-MM-DD format. Supported functions now|today|yesterday|weekstart|weekend|monthstart|monthend|yearstart|yearend and supported intervals for add/subtract are ms|s|sec|min|h|hour|y|year|d|day|m|month|y|year. Example monthstart-3d (subtract 3 days from month start)
Option |
Value |
today |
today |
yesterday |
yesterday |
monthstart |
monthstart |
monthend |
monthend |
yearstart |
yearstart |
yearend |
yearend |
weekstart |
weekstart |
weekend |
weekend |
yearstart-1y |
yearstart-1y |
yearend-1y |
yearend-1y |
monthstart-1d |
monthstart-1d |
monthend+1d |
monthend+1d |
2022-01-31 |
2022-01-31 |
|
Metrics |
Option |
Value |
impressions |
impressions |
clicks |
clicks |
cost |
cost |
purchases1d |
purchases1d |
purchases7d |
purchases7d |
purchases14d |
purchases14d |
purchases30d |
purchases30d |
purchasesSameSku1d |
purchasesSameSku1d |
purchasesSameSku7d |
purchasesSameSku7d |
purchasesSameSku14d |
purchasesSameSku14d |
purchasesSameSku30d |
purchasesSameSku30d |
unitsSoldClicks1d |
unitsSoldClicks1d |
unitsSoldClicks7d |
unitsSoldClicks7d |
unitsSoldClicks14d |
unitsSoldClicks14d |
unitsSoldClicks30d |
unitsSoldClicks30d |
sales1d |
sales1d |
sales7d |
sales7d |
sales14d |
sales14d |
sales30d |
sales30d |
attributedSalesSameSku1d |
attributedSalesSameSku1d |
attributedSalesSameSku7d |
attributedSalesSameSku7d |
attributedSalesSameSku14d |
attributedSalesSameSku14d |
attributedSalesSameSku30d |
attributedSalesSameSku30d |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRoyalties14d |
kindleEditionNormalizedPagesRoyalties14d |
date |
date |
startDate |
startDate |
endDate |
endDate |
campaignBiddingStrategy |
campaignBiddingStrategy |
costPerClick |
costPerClick |
clickThroughRate |
clickThroughRate |
spend |
spend |
campaignName |
campaignName |
campaignId |
campaignId |
campaignStatus |
campaignStatus |
campaignBudgetAmount |
campaignBudgetAmount |
campaignBudgetType |
campaignBudgetType |
campaignRuleBasedBudgetAmount |
campaignRuleBasedBudgetAmount |
campaignApplicableBudgetRuleId |
campaignApplicableBudgetRuleId |
campaignApplicableBudgetRuleName |
campaignApplicableBudgetRuleName |
campaignBudgetCurrencyCode |
campaignBudgetCurrencyCode |
topOfSearchImpressionShare |
topOfSearchImpressionShare |
|
Metrics |
Option |
Value |
impressions |
impressions |
clicks |
clicks |
cost |
cost |
purchases1d |
purchases1d |
purchases7d |
purchases7d |
purchases14d |
purchases14d |
purchases30d |
purchases30d |
purchasesSameSku1d |
purchasesSameSku1d |
purchasesSameSku7d |
purchasesSameSku7d |
purchasesSameSku14d |
purchasesSameSku14d |
purchasesSameSku30d |
purchasesSameSku30d |
unitsSoldClicks1d |
unitsSoldClicks1d |
unitsSoldClicks7d |
unitsSoldClicks7d |
unitsSoldClicks14d |
unitsSoldClicks14d |
unitsSoldClicks30d |
unitsSoldClicks30d |
sales1d |
sales1d |
sales7d |
sales7d |
sales14d |
sales14d |
sales30d |
sales30d |
attributedSalesSameSku1d |
attributedSalesSameSku1d |
attributedSalesSameSku7d |
attributedSalesSameSku7d |
attributedSalesSameSku14d |
attributedSalesSameSku14d |
attributedSalesSameSku30d |
attributedSalesSameSku30d |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRoyalties14d |
kindleEditionNormalizedPagesRoyalties14d |
date |
date |
startDate |
startDate |
endDate |
endDate |
campaignBiddingStrategy |
campaignBiddingStrategy |
costPerClick |
costPerClick |
clickThroughRate |
clickThroughRate |
spend |
spend |
adGroupName |
adGroupName |
adGroupId |
adGroupId |
adStatus |
adStatus |
|
Metrics |
Option |
Value |
impressions |
impressions |
clicks |
clicks |
cost |
cost |
purchases1d |
purchases1d |
purchases7d |
purchases7d |
purchases14d |
purchases14d |
purchases30d |
purchases30d |
purchasesSameSku1d |
purchasesSameSku1d |
purchasesSameSku7d |
purchasesSameSku7d |
purchasesSameSku14d |
purchasesSameSku14d |
purchasesSameSku30d |
purchasesSameSku30d |
unitsSoldClicks1d |
unitsSoldClicks1d |
unitsSoldClicks7d |
unitsSoldClicks7d |
unitsSoldClicks14d |
unitsSoldClicks14d |
unitsSoldClicks30d |
unitsSoldClicks30d |
sales1d |
sales1d |
sales7d |
sales7d |
sales14d |
sales14d |
sales30d |
sales30d |
attributedSalesSameSku1d |
attributedSalesSameSku1d |
attributedSalesSameSku7d |
attributedSalesSameSku7d |
attributedSalesSameSku14d |
attributedSalesSameSku14d |
attributedSalesSameSku30d |
attributedSalesSameSku30d |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRoyalties14d |
kindleEditionNormalizedPagesRoyalties14d |
date |
date |
startDate |
startDate |
endDate |
endDate |
campaignBiddingStrategy |
campaignBiddingStrategy |
costPerClick |
costPerClick |
clickThroughRate |
clickThroughRate |
spend |
spend |
placementClassification |
placementClassification |
|
Metrics |
Option |
Value |
impressions |
impressions |
clicks |
clicks |
costPerClick |
costPerClick |
clickThroughRate |
clickThroughRate |
cost |
cost |
purchases1d |
purchases1d |
purchases7d |
purchases7d |
purchases14d |
purchases14d |
purchases30d |
purchases30d |
purchasesSameSku1d |
purchasesSameSku1d |
purchasesSameSku7d |
purchasesSameSku7d |
purchasesSameSku14d |
purchasesSameSku14d |
purchasesSameSku30d |
purchasesSameSku30d |
unitsSoldClicks1d |
unitsSoldClicks1d |
unitsSoldClicks7d |
unitsSoldClicks7d |
unitsSoldClicks14d |
unitsSoldClicks14d |
unitsSoldClicks30d |
unitsSoldClicks30d |
sales1d |
sales1d |
sales7d |
sales7d |
sales14d |
sales14d |
sales30d |
sales30d |
attributedSalesSameSku1d |
attributedSalesSameSku1d |
attributedSalesSameSku7d |
attributedSalesSameSku7d |
attributedSalesSameSku14d |
attributedSalesSameSku14d |
attributedSalesSameSku30d |
attributedSalesSameSku30d |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRoyalties14d |
kindleEditionNormalizedPagesRoyalties14d |
salesOtherSku7d |
salesOtherSku7d |
unitsSoldOtherSku7d |
unitsSoldOtherSku7d |
acosClicks7d |
acosClicks7d |
acosClicks14d |
acosClicks14d |
roasClicks7d |
roasClicks7d |
roasClicks14d |
roasClicks14d |
keywordId |
keywordId |
keyword |
keyword |
campaignBudgetCurrencyCode |
campaignBudgetCurrencyCode |
date |
date |
startDate |
startDate |
endDate |
endDate |
portfolioId |
portfolioId |
campaignName |
campaignName |
campaignId |
campaignId |
campaignBudgetType |
campaignBudgetType |
campaignBudgetAmount |
campaignBudgetAmount |
campaignStatus |
campaignStatus |
keywordBid |
keywordBid |
adGroupName |
adGroupName |
adGroupId |
adGroupId |
keywordType |
keywordType |
matchType |
matchType |
targeting |
targeting |
topOfSearchImpressionShare |
topOfSearchImpressionShare |
adKeywordStatus |
adKeywordStatus |
|
Metrics |
Option |
Value |
impressions |
impressions |
clicks |
clicks |
costPerClick |
costPerClick |
clickThroughRate |
clickThroughRate |
cost |
cost |
purchases1d |
purchases1d |
purchases7d |
purchases7d |
purchases14d |
purchases14d |
purchases30d |
purchases30d |
purchasesSameSku1d |
purchasesSameSku1d |
purchasesSameSku7d |
purchasesSameSku7d |
purchasesSameSku14d |
purchasesSameSku14d |
purchasesSameSku30d |
purchasesSameSku30d |
unitsSoldClicks1d |
unitsSoldClicks1d |
unitsSoldClicks7d |
unitsSoldClicks7d |
unitsSoldClicks14d |
unitsSoldClicks14d |
unitsSoldClicks30d |
unitsSoldClicks30d |
sales1d |
sales1d |
sales7d |
sales7d |
sales14d |
sales14d |
sales30d |
sales30d |
attributedSalesSameSku1d |
attributedSalesSameSku1d |
attributedSalesSameSku7d |
attributedSalesSameSku7d |
attributedSalesSameSku14d |
attributedSalesSameSku14d |
attributedSalesSameSku30d |
attributedSalesSameSku30d |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRoyalties14d |
kindleEditionNormalizedPagesRoyalties14d |
salesOtherSku7d |
salesOtherSku7d |
unitsSoldOtherSku7d |
unitsSoldOtherSku7d |
acosClicks7d |
acosClicks7d |
acosClicks14d |
acosClicks14d |
roasClicks7d |
roasClicks7d |
roasClicks14d |
roasClicks14d |
keywordId |
keywordId |
keyword |
keyword |
campaignBudgetCurrencyCode |
campaignBudgetCurrencyCode |
date |
date |
startDate |
startDate |
endDate |
endDate |
portfolioId |
portfolioId |
searchTerm |
searchTerm |
campaignName |
campaignName |
campaignId |
campaignId |
campaignBudgetType |
campaignBudgetType |
campaignBudgetAmount |
campaignBudgetAmount |
campaignStatus |
campaignStatus |
keywordBid |
keywordBid |
adGroupName |
adGroupName |
adGroupId |
adGroupId |
keywordType |
keywordType |
matchType |
matchType |
targeting |
targeting |
adKeywordStatus |
adKeywordStatus |
|
Metrics |
Option |
Value |
date |
date |
startDate |
startDate |
endDate |
endDate |
campaignName |
campaignName |
campaignId |
campaignId |
adGroupName |
adGroupName |
adGroupId |
adGroupId |
adId |
adId |
portfolioId |
portfolioId |
impressions |
impressions |
clicks |
clicks |
costPerClick |
costPerClick |
clickThroughRate |
clickThroughRate |
cost |
cost |
spend |
spend |
campaignBudgetCurrencyCode |
campaignBudgetCurrencyCode |
campaignBudgetAmount |
campaignBudgetAmount |
campaignBudgetType |
campaignBudgetType |
campaignStatus |
campaignStatus |
advertisedAsin |
advertisedAsin |
advertisedSku |
advertisedSku |
purchases1d |
purchases1d |
purchases7d |
purchases7d |
purchases14d |
purchases14d |
purchases30d |
purchases30d |
purchasesSameSku1d |
purchasesSameSku1d |
purchasesSameSku7d |
purchasesSameSku7d |
purchasesSameSku14d |
purchasesSameSku14d |
purchasesSameSku30d |
purchasesSameSku30d |
unitsSoldClicks1d |
unitsSoldClicks1d |
unitsSoldClicks7d |
unitsSoldClicks7d |
unitsSoldClicks14d |
unitsSoldClicks14d |
unitsSoldClicks30d |
unitsSoldClicks30d |
sales1d |
sales1d |
sales7d |
sales7d |
sales14d |
sales14d |
sales30d |
sales30d |
attributedSalesSameSku1d |
attributedSalesSameSku1d |
attributedSalesSameSku7d |
attributedSalesSameSku7d |
attributedSalesSameSku14d |
attributedSalesSameSku14d |
attributedSalesSameSku30d |
attributedSalesSameSku30d |
salesOtherSku7d |
salesOtherSku7d |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
unitsSoldOtherSku7d |
unitsSoldOtherSku7d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRead14d |
kindleEditionNormalizedPagesRoyalties14d |
kindleEditionNormalizedPagesRoyalties14d |
acosClicks7d |
acosClicks7d |
acosClicks14d |
acosClicks14d |
roasClicks7d |
roasClicks7d |
roasClicks14d |
roasClicks14d |
|
This is generic endpoint. Use this endpoint when some actions are not implemented by connector. Just enter partial URL (Required), Body, Method, Header etc. Most parameters are optional except URL. [
Read more...]
Parameter |
Description |
Url |
API URL goes here. You can enter full URL or Partial URL relative to Base URL. If it is full URL then domain name must be part of ServiceURL or part of TrustedDomains
|
Body |
Request Body content goes here
|
IsMultiPart |
Set this option if you want to upload file(s) (i.e. POST RAW file data) or send data using Multi-Part encoding method (i.e. Content-Type: multipart/form-data). Multi-Part request allows you to mix key/value and upload files in same request. On the other hand raw upload allows only single file upload (without any key/value)
==== Raw Upload (Content-Type: application/octet-stream) =====
To upload single file in raw mode check this option and specify full file path starting with @ sign in the Body (e.g. @c:\data\myfile.zip )
==== Form-Data / Multipart Upload (Content-Type: multipart/form-data) =====
To treat your Request data as multi part fields you must specify key/value pairs separated by new lines into RequestData field (i.e. Body). Each key value pair is entered on new-line and key/value are separated using equal sign (=). Preceding and trailing spaces are ignored also blank lines are ignored.
If field value has some any special character(s) then use escape sequence (e.g. For NewLine: \r\n, For Tab: \t, For at (@): \@). When value of any field starts with at sign (@) its automatically treated as File you want to upload. By default file content type is determined based on extension however you can supply content type manually for any field using this way [ YourFileFieldName.Content-Type=some-content-type ]. By default File Upload Field always includes Content-Type in the request (non file fields do not have content-type by default unless you supply manually). For some reason if you dont want to use Content-Type header in your request then supply blank Content-Type to exclude this header altogather [e.g. SomeFieldName.Content-Type= ]. In below example we have supplied Content-Type for file2 and SomeField1, all other fields are using default content-type.
See below Example of uploading multiple files along with additional fields. If some API requires you to pass Content-Type: multipart/form-data rather than multipart/form-data then manually set Request Header => Content-Type: multipart/mixed (it must starts with multipart/ else will be ignored).
file1=@c:\data\Myfile1.txt
file2=@c:\data\Myfile2.json
file2.Content-Type=application/json
SomeField1=aaaaaaa
SomeField1.Content-Type=text/plain
SomeField2=12345
SomeFieldWithNewLineAndTab=This is line1\r\nThis is line2\r\nThis is \ttab \ttab \ttab
SomeFieldStartingWithAtSign=\@MyTwitterHandle
|
Filter |
Enter filter to extract array from response. Example: $.rows[*] --OR-- $.customers[*].orders[*]. Check your response document and find out hierarchy you like to extract
Option |
Value |
No filter |
|
Example1 |
$.store.books[*] |
Example2 (Sections Under Books) |
$.store.books[*].sections[*] |
Example3 (Equals) |
$.store.books[?(@author=='sam')] |
Example4 (Equals - Any Section) |
$..[?(@author=='sam')] |
Example5 (Not Equals - Any Section) |
$..[?(@author!='sam')] |
Example6 (Number less than) |
$.store.books[?(@.price<10)]
Example7 (Regular Expression - Contains Pattern)=$.store.books[?(@author=~ /sam|bob/ )] |
Example8 (Regular Expression - Does Not Contain Pattern) |
$.store.books[?(@author=~ /^((?!sam|bob).)*$/ )] |
Example9 (Regular Expression - Exact Pattern Match) |
$.store.books[?(@author=~ /^sam|bob$/ )] |
Example10 (Regular Expression - Starts With) |
$.store.books[?(@author=~ /^sam/ )] |
Example11 (Regular Expression - Ends With) |
$.store.books[?(@author=~ /sam$/ )] |
Example12 (Between) |
$.store.employees[?( @.hiredate>'2015-01-01' && @.hiredate<'2015-01-04' )] |
|
Headers |
Headers for Request. To enter multiple headers use double pipe or new line after each {header-name}:{value} pair
|
Generic Request (Bulk Write)
This is a generic endpoint for bulk write purpose. Use this endpoint when some actions are not implemented by connector. Just enter partial URL (Required), Body, Method, Header etc. Most parameters are optional except URL. [
Read more...]
Parameter |
Description |
Url |
API URL goes here. You can enter full URL or Partial URL relative to Base URL. If it is full URL then domain name must be part of ServiceURL or part of TrustedDomains
|
IsMultiPart |
Set this option if you want to upload file(s) (i.e. POST RAW file data) or send data using Multi-Part encoding method (i.e. Content-Type: multipart/form-data). Multi-Part request allows you to mix key/value and upload files in same request. On the other hand raw upload allows only single file upload (without any key/value)
==== Raw Upload (Content-Type: application/octet-stream) =====
To upload single file in raw mode check this option and specify full file path starting with @ sign in the Body (e.g. @c:\data\myfile.zip )
==== Form-Data / Multipart Upload (Content-Type: multipart/form-data) =====
To treat your Request data as multi part fields you must specify key/value pairs separated by new lines into RequestData field (i.e. Body). Each key value pair is entered on new-line and key/value are separated using equal sign (=). Preceding and trailing spaces are ignored also blank lines are ignored.
If field value has some any special character(s) then use escape sequence (e.g. For NewLine: \r\n, For Tab: \t, For at (@): \@). When value of any field starts with at sign (@) its automatically treated as File you want to upload. By default file content type is determined based on extension however you can supply content type manually for any field using this way [ YourFileFieldName.Content-Type=some-content-type ]. By default File Upload Field always includes Content-Type in the request (non file fields do not have content-type by default unless you supply manually). For some reason if you dont want to use Content-Type header in your request then supply blank Content-Type to exclude this header altogather [e.g. SomeFieldName.Content-Type= ]. In below example we have supplied Content-Type for file2 and SomeField1, all other fields are using default content-type.
See below Example of uploading multiple files along with additional fields. If some API requires you to pass Content-Type: multipart/form-data rather than multipart/form-data then manually set Request Header => Content-Type: multipart/mixed (it must starts with multipart/ else will be ignored).
file1=@c:\data\Myfile1.txt
file2=@c:\data\Myfile2.json
file2.Content-Type=application/json
SomeField1=aaaaaaa
SomeField1.Content-Type=text/plain
SomeField2=12345
SomeFieldWithNewLineAndTab=This is line1\r\nThis is line2\r\nThis is \ttab \ttab \ttab
SomeFieldStartingWithAtSign=\@MyTwitterHandle
|
Filter |
Enter filter to extract array from response. Example: $.rows[*] --OR-- $.customers[*].orders[*]. Check your response document and find out hierarchy you like to extract
|
Headers |
Headers for Request. To enter multiple headers use double pipe (||) or new line after each {header-name}:{value} pair
|
Amazon Ads Connector Examples for JAVA Connection
This page offers a collection of SQL examples designed for seamless integration with the ZappySys API ODBC Driver under ODBC Data Source (36/64) or ZappySys Data Gateway, enhancing your ability to connect and interact with Prebuilt Connectors effectively.
Conclusion
In this article we discussed how to connect to Amazon Ads in JAVA and integrate data without any coding. Click here to Download Amazon Ads Connector for JAVA and try yourself see how easy it is. If you still have any question(s) then ask here or simply click on live chat icon below and ask our expert (see bottom-right corner of this page).
Download Amazon Ads Connector for JAVA
Documentation
More integrations
Other application integration scenarios for Amazon Ads
Other connectors for JAVA
Download Amazon Ads Connector for JAVA
Documentation
Common Searches:
How to connect Amazon Ads in JAVA?
How to get Amazon Ads data in JAVA?
How to read Amazon Ads data in JAVA?
How to load Amazon Ads data in JAVA?
How to import Amazon Ads data in JAVA?
How to pull Amazon Ads data in JAVA?
How to push data to Amazon Ads in JAVA?
How to write data to Amazon Ads in JAVA?
How to POST data to Amazon Ads in JAVA?
Call Amazon Ads API in JAVA
Consume Amazon Ads API in JAVA
Amazon Ads JAVA Automate
Amazon Ads JAVA Integration
Integration Amazon Ads in JAVA
Consume real-time Amazon Ads data in JAVA
Consume real-time Amazon Ads API data in JAVA
Amazon Ads ODBC Driver | ODBC Driver for Amazon Ads | ODBC Amazon Ads Driver | SSIS Amazon Ads Source | SSIS Amazon Ads Destination
Connect Amazon Ads in JAVA
Load Amazon Ads in JAVA
Load Amazon Ads data in JAVA
Read Amazon Ads data in JAVA
Amazon Ads API Call in JAVA