Amazon Ads

Amazon Ads (Amazon Advertising API)

This connector reads Sponsored Products campaigns and requests performance reports through the Amazon Ads API. It works for sellers, vendors and agencies.

Setup. You need access to the Amazon Ads API: an approved API application and a Login with Amazon (LWA) security profile linked to it (Amazon Ads, Partner Network or advertising.amazon.com/API, apply for API access). In the LWA console (developer.amazon.com, Login with Amazon) open the security profile, Web Settings, and add the redirect URI shown on the connector page as an Allowed Return URL. Copy its client ID and client secret here, choose the three region values, save, then click Authorize with Provider and sign in with the Amazon account that has access to the advertising accounts. The scope is advertising::campaign_management.

Regions. The API, sign-in page and token endpoint are regional. North America (US, CA, MX, BR): https://advertising-api.amazon.com, https://www.amazon.com/ap/oa, https://api.amazon.com/auth/o2/token. Europe (UK, DE, FR, IT, ES, NL, SE, PL, TR, AE, SA, EG, IN): https://advertising-api-eu.amazon.com, https://eu.account.amazon.com/ap/oa, https://api.amazon.co.uk/auth/o2/token. Far East (JP, AU, SG): https://advertising-api-fe.amazon.com, https://apac.account.amazon.com/ap/oa, https://api.amazon.co.jp/auth/o2/token. A connector sees only the profiles of its region; install it once per region if you advertise in several.

Profiles. Start with amazon_ads_list_profiles. A profile is one advertiser in one marketplace; its profileId goes into every other tool as profile_id (sent as the Amazon-Advertising-API-Scope header). The client ID is sent automatically as Amazon-Advertising-API-ClientId. An empty list means the account has no advertising account in this region or never created a campaign.

Listing. The Sponsored Products list tools use POST because Amazon takes the filters in the body, but they only read. state_filter defaults to ENABLED and PAUSED; add ARCHIVED to see old items. Narrow with filters, e.g. {"campaignIdFilter": {"include": ["123"]}}. Answers carry nextToken; pass it as next_token until it is missing. Ids are long numbers: treat them as strings.

Reports. Performance figures (impressions, clicks, cost, sales, ACOS, ROAS) come only from reports. amazon_ads_create_report starts a job, amazon_ads_get_report returns its status; reports usually finish within minutes but can take up to an hour at busy times, so poll about once a minute. Most report types look back 95 days, a DAILY report covers at most 31 days, and duplicate requests return HTTP 425 with the id of the existing report. When COMPLETED, the answer holds a pre-signed url to a gzip-compressed JSON file, valid for about an hour. The connector cannot unpack that file: hand the link to the user or to a tool that can download and decompress it. Column names: attribution windows are part of the name (purchases7d, sales14d), cost is in the profile's currency.

Limits. Amazon throttles per account and endpoint and answers 429 with Retry-After; wait and retry. Access tokens last one hour and are renewed automatically from the refresh token.

Not included. Creating or changing campaigns, bids and budgets. Sponsored Brands and Sponsored Display campaign lists are not covered yet, but their performance is available through reports (sbCampaigns, sdCampaigns).