No results found

Try a different or more specific query
Developer Console

Mobile Ads API Frequently Asked Questions

General & Overview

Q: What is the Amazon Mobile Ad Network?
The Amazon Mobile Ad Network connects advertisers with mobile apps and game players. The Amazon Mobile Ads API serves display ads from Amazon and brand advertisers in your apps. By delivering relevant messages to your users at the right time, we are able to offer great eCPM.
Q: What apps are supported?
The Amazon Mobile Ad Network supports Android, iOS, and FireOS apps currently published on a recognized app store (e.g., Google Play Store, Apple App Store, Amazon Appstore, Samsung Galaxy Store).
Q: Are apps that use the Amazon Mobile Ads API required to be distributed through the Amazon Appstore?
No. Both Android and iOS Apps that use the Amazon Mobile Ads API are not required to be distributed through the Amazon Appstore.
Q: Which regions are supported?
The Amazon Mobile Ad Network serves ads to users in U.S., U.K., Germany, France, Spain, Italy, and Japan. 
Q: Has your SDK been updated for the California Consumer Privacy Act (CCPA)? I have placed a "Do Not Sell My Personal Information" link on my app. How do I send user choice signals to you?
There are no updates to the Amazon Mobile Ad Network SDK for the California Consumer Privacy Act (CCPA).

We realize that you will determine what the CCPA means for your Amazon Mobile Ads integration. If you are providing California residents a "Do Not Sell My Personal Information" link on your app and receive an opt out of "sale" signal via that link, you have two choices: (a) you can choose to not pass Amazon that opted-out traffic, or (b) you can pass us the user choice signal via the instructions below so that we can honor that choice.

If you provide California residents a "Do Not Sell My Personal Information" link on your app and wish to pass us user choice signals, you need to send the IAB U.S. Privacy String in the ad request to us. Refer to the IAB's technical specifications for more information about the Privacy String format and its components as well as how to implement the IAB U.S. Privacy String per those specifications.

To send us the IAB’s U.S. Privacy String in ad requests, refer to the following code examples. The Android and iOS SDKs both contain a method called setAdvancedOption, which you can use to set the Privacy String in the pj.us_privacy parameter inside the AmazonAdOptions object. The Privacy String will then be forwarded by passing the AmazonAdOptions object in the loadAd call.

Android Example:

final JSONObject pjObject = new JSONObject();
try {
  pjObject.put("us_privacy", "1---"); // example privacy string value
catch (JSONException ex)
  Log.e(LOGTAG, ex.getMessage());
final AdTargetingOptions adOptions = new AdTargetingOptions();
adOptions.setAdvancedOption("pj", pjObject.toString());

iOS Example:

NSDictionary *pjObject = @{
   @"us_privacy":@"1---" // example privacy string value
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:pjObject options:0 error:&err];
NSString *pjJSONAsString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
AmazonAdOptions *options = [AmazonAdOptions options];
[options setAdvancedOption:pjJSONAsString forKey:@"pj"];
// Create New Ad
self.adView = [AmazonAdView amazonAdViewWithAdSize:adFrameSize];
[self.adView loadAd:options];
Q: Has your SDK been updated for GDPR?
IAB Europe and the IAB Tech Lab have finalized version 2.0 of the Transparency and Consent Framework (TCFv2) and plan to deprecate v1 from August 15th this year. By August 15, 2020, Amazon Advertising will join version 2.0 of the Global Vendor List (GVL).

For some apps, this might require some changes which are detailed below. If you have further questions, please notify the Amazon Developer support team through the Contact Us page.


For IAB-compliant CMPs on TCF v2.0, our iOS SDK version 3.1.0+ and Android SDK version 6.0.0+ will extract values stored in the following keys of the SharedPreferences (Android) and NSUserDefaults (iOS) objects:

  • IABTCF_gdprApplies0 if GDPR does not apply for the user or 1 if GDPR does apply for the user
  • IABTCF_TCString – encoded consent string value


For IAB-compliant CMPs on TCF v1.0, our iOS SDK version and Android SDK version 5.9.0+ will extract values stored in the following keys of the SharedPreferences (Android) and NSUserDefaults (iOS) objects:

  • IABConsent_SubjectToGDPR0 if GDPR does not apply for the user or 1 if GDPR does apply for the user
  • IABConsent_ConsentString – encoded consent string value

Note: If the consent string is present, we read it regardless of IABTCF_gdprApplies/IABConsent_SubjectToGDPR = 0 or 1.

Q: Can I still monetize EU traffic if I'm using a non-IAB registered CMP (Consent Management Platform)?
At this time, the Amazon Mobile Ad Network supports only user consent signals that meet the technical specifications of the IAB Transparency & Consent Framework.
Q: What are the guidelines for publishers?
Please refer to the Program Participation Requirements for publisher guidelines.
Q: How do I get started?
Here is a brief overview of Mobile Ads for Android and Mobile Ads for iOS.
Q: How do I generate an App ID for an Android app?
Follow these steps to generate an App ID if the app is not currently published on the Amazon Appstore.
  1. Log in to the Amazon Developer portal.
  2. Once logged in, go to Apps & Services > Mobile Ads. Click the button Register New Android App.
  3. On the New App Submission page, complete the following, and then click Save:
    • App title
    • App category and, if prompted, subcategory
    • Customer support email address
    • (Optional) Customer support phone
    • (Optional) Customer support website
  4. It will look like the you need to submit your app to the Amazon Appstore. If you do not wish to publish your app to the Amazon Appstore, you can bypass this process by navigating to the App Services tab on the left.

    Note that the App IDs in the "App Submission API Keys" section (on the General Information tab) are not your App IDs for Mobile Ads, and you will not receive ads if you integrate them.

  5. On the App Services page, scroll down to the bottom and click View Mobile Ads in the section titled "Mobile Ads."
  6. Answer the COPPA question ("Is your app directed primarily at kids under 13?") and click Submit. Note that apps directed at children under 13 are ineligible for Mobile Ads.

    If you answer Yes, you will then receive the App ID for Mobile Ads. The ID is listed under the Key column. You can access this App ID at anytime by going to this Mobile Ads page (Apps & Services > Mobile Ads).

Q: Do you have any examples that I can look at for the Mobile Ads API?
See the Mobile Ads Sample Apps page for examples.
Q: What ad sizes and ad types are supported?
View all of the approved ad sizes and ad types in Android Ad Concepts or iOS Ad Concepts.
Q: We are currently integrated with a mediation platform. How can we participate in the Amazon Mobile Ad Network?
The Amazon Mobile Ads API can co-exist with your existing mediation platform. Many developers working with mediation platforms have successfully integrated our API directly into their apps. Refer to the instructions on the Using Amazon Mobile Ads with Other SDKs Page for more information.
Q: Can I manage the ads that appear in my app?
Yes. You can specify a list of advertiser names, advertiser product categories, or URLs that aren't appropriate for your customers by using the restrictions page under the Settings menu item. Please note that blocking ads may negatively impact your revenue and fill rates.
Q: Does Amazon Mobile Ad Network serve ads from 3rd party ad networks?
Yes. We are working with select ad networks and DSPs to bring diverse and high-quality ads to the Amazon Mobile Ad Network.
Q: Can I enable/disable the ads from 3rd party ad networks in my app?
Yes. There is nothing you need to do to enable these additional ads. If you prefer to not to include ads from 3rd part networks in your apps, you can choose not to include them here.
Q: What support services are available?
Refer to the Mobile Ads forums. If you need additional help, click the Contact Us link on the Support Page.
Q: What kind of reporting is available?
You can access Amazon Mobile Ads Performance Reports for ad requests, impressions, fill rate, clicks, CTR (click-through rate), eCPM (effective CPM), and earnings. Using filters such as apps, creative size, geo, and device can provide valuable insights into how your users are interacting with you app.
Q: How is fill rate calculated?
Fill rate indicates Amazon’s ability to serve ads in your app and is calculated as ad responses divided by ad requests. Ad responses are the number of ads delivered by the Amazon Mobile Ad Network for display in your app. Impressions are ads actually displayed to app users by your app. For example, if you send 1,000 interstitial ad requests to the Amazon Mobile Ad Network and we return 900 ads responses for display, the fill rate is 90%, even if you only display 750 of those ads. Prior to September 23rd, fill rate was calculated as impressions divided by ad requests.
Q: Why am I seeing impressions when I select a non-US geolocation?
The Amazon Mobile Ad Network serves ads only to users in U.S., U.K., Germany, France, Spain, Italy and Japan. These users are registered customers (regardless of where the ad request originates) in these countries/regions or users whose ad request originates from these countries/regions based on their IP address.
Q: The Mobile Ad Network Publisher Agreement prohibits me from sending geolocation data for users in the European Union. Can I still set the Amazon Mobile Ads API's ad targeting options to enable geolocation if some of my users are based in Europe?
Yes. The Amazon Mobile Ads API is designed to disable the geolocation feature when the device is detected as being physically located in the EU.
Q: What fill rate and eCPM should I expect?
Performance can vary due to many factors such as app content, ad placements, and advertising campaigns that match your user base. Please refer to quotes from partner developers.
Q: Why does my fill rate fluctuate?
The Amazon Mobile Ad Network is comprised of many advertisers and publishers. Various advertising campaigns move through the network which can result in a fluctuation in your monetization. If you notice a change in your eCPM or fill rate, please review your app to ensure your app is accepting ads from Amazon.
Q: How can I view earnings by market?
You can go to the Mobile Ads Performance Report and select a geography under 'Region'. You will see corresponding earnings in USD.
Q: How can I view earnings from interstitial ad formats?
You can go to the Mobile Ads Performance Report and select 'Interstitial' under the 'Size' filter. You will see your interstitial earnings.
Q: Can I advertise my app for download on the Amazon Mobile Ad Network?
Yes. You can advertise your app with the Amazon Mobile Ad Network to drive downloads. To learn more about how to use the Amazon Mobile Ads API with an app download campaign, visit the App Start Conversion Tracking Guide.
Q: Can users who receive ads from the Amazon Mobile Ad Network opt-out of seeing tailored ads?
Amazon customers can always choose to opt-out of receiving interest-based ads from the Amazon Mobile Ad Network. They can do so by managing their Ad Preferences from the Your Accounts page of the Amazon mobile shopping app if it is installed on their device. Additionally, users who receive ads from the Amazon Mobile Ad Network may click on the AdChoices icon to manage their ad preferences. Customers who opt out of receiving interest-based ads will still see ads served by Amazon, but they will not be tailored. Customers who opt out may also continue to see interest-based ads served by other ad networks that are used by the same mobile app. Visit our Interest-Based Ads Page to learn more.


Q: What is app-ads.txt?
App-ads.txt is the mobile app equivalent of IAB’s ads.txt, an industry-wide initiative to help increase transparency in programmatic advertising by helping bidders and advertisers identify whether ad inventory is being sold by authorized sellers. When advertisers or demand-side platforms (DSPs) want to bid for an impression, they look to see if the ad opportunity is coming from someone authorized to sell the app's inventory. Doing this increases transparency and enables DSPs to mitigate instances of fraud. Many DSPs are now moving towards the adoption of app-ads.txt, meaning that they won’t bid on an impression if this doesn’t exist. Mobile app publishers are encouraged to create and store this file to reduce any negative earnings impact, and to maximize bid opportunities.
Q: How do I create an app-ads.txt file for my app?
According to the Interactive Advertising Bureau Tech Lab (IAB) guidelines, publishers should make sure that the "Customer support website" field is up to date in each app store. This is the website where you will host your app-ads.txt file.
  • Step 1: Open up Notepad (Windows) or TextEdit (Mac), and enter the information provided to you on the app-ads.txt Setup page. Save the file under the .txt extension, and then upload to your site. If you already have an app-ads.txt file, then you just need to add the Amazon entry.

  • Step 2: Once you have created the file, you need to add it to your website file system. This would be your developer website. If you self host your website and all the files, meaning you don’t use a CMS, then you simply add it as a file to the root domain. If you use a CMS, you will need to use a FTP (file transfer protocol) to upload the file. If you are unsure what this is, you may need to research what FTP's your CMS supports. The majority of the CMS platforms have plugins that you can install to manage the file system of your site. After you have installed the plugin you plan to use, you can upload the file. Be sure you are using the same domain/developer website you've listed on your Google Play Store app listing (for Android) or Apple App Store (for iOS).

Q: What is the Amazon Mobile Ads app-ads.txt entry?
The IAB provides the following guidelines:
  • Any website/app with only one authorized system directly controlled/operated by the website/app owner should use the following:, YourPublisherID, DIRECT.
  • Any website with only one authorized system operated by a separate company doing resale of inventory should use the following:, YourPublisherID, RESELLER.

Payment & Taxes

Q: When do I get paid?
The Amazon Mobile Ad Network issues payments on a monthly basis for qualifying events in a given month, excluding applicable withholding and deductions. You will receive payment approximately 30 days after the end of the calendar month in which the ad revenue was earned. For example, the earnings for the month of November are typically paid at the end of December. For more information about what constitutes a qualifying event, please consult the Mobile Ad Network Publisher Agreement.
Q: How do I get paid?
Developers in supported countries/regions can receive electronic payments (EFT or wire transfers) from Amazon. Depending on your bank’s location, you may be eligible for either direct deposit, EFT, or wire transfers. If your bank’s location is not eligible for electronic payments or if you do not opt to be paid by electronic payments, your payment will be made by check.

To determine if you are eligible for electronic payments, sign in to your account on the developer portal and select your bank’s location from the 'Where is your bank/financial institution?' drop-down menu. Based on this selection, if electronic payment is available, you will be prompted to choose between electronic payment or check.

Regardless of which you choose, you will typically receive a single payment for all advertising earnings in your preferred currency. If you elect to be paid in a currency other than USD, we will convert your advertising earnings to the payment currency at an exchange rate that may include fees and charges for the conversion. Please consult your financial institution to determine if there are any fees associated with receiving electronic payments.

  Payment Method    Payment Currencies    Minimum Payment Threshold
Electronic Funds Transfer ("EFT")  USD, GBP, EUR, JPY  $10 USD
 Wire Transfer ("Wire")  CAD, AUD, NZD  $100 USD
 Check  USD  $100 USD

Provided your balance due exceeds the payment threshold, and subject to applicable withholdings and deductions, we will remit payment approximately 30 days after the end of the calendar month in which the advertising earnings was generated. For example, we would remit advertising earnings generated in April at the end of May, which is approximately 30 days after the end of April.

Q: What happens to earnings that haven’t met the payment threshold?
Earnings that do not meet the payment threshold for the type of payment you will receive accrue in Amazon’s Accounts Payable records as a carryover balance. Once the carryover balance plus the current month’s earnings exceed the payment threshold, Amazon will then disburse the accrued funds.
Q: Do I have to give Amazon any tax information (for example, my Social Security number) in order to use the Amazon Mobile Ads API? What information do you need?

In order to comply with United States Internal Revenue tax regulations, Amazon requires you to complete the Service Tax Identification Interview if you plan to monetize your apps by displaying ads from the Amazon Mobile Ad Network. See Setting Up Taxes for Your App for more information. You can find more information about the tax identity interview in the Service Tax Identity Interview Guide.

Q: How do I provide this tax information?
If you have not submitted your tax information through the Amazon Apps & Games Developer Portal, sign in to the portal and enter the required information on the Settings > Tax Identity tab.

Last updated: Sep 30, 2021