Home > APIs > Earn > Mobile Ads

Testing Your App

Testing

During development, integration, and testing of the Amazon Mobile Ads API, you should indicate all ad requests are for testing. Test requests will not show up in your metrics.

Important: Test traffic that isn't flagged as tests can result in blocked requests, fraud investigation, and potential account termination.

To enable testing, call the following before ad loads are attempted:

AdRegistration.enableTesting(true);

Debugging

When testing and debugging your app with the Amazon Mobile Ads API, you can enable writing logcat messages.

To enable logging, call the following before ad loads are attempted:

AdRegistration.enableLogging(true);
Important: Logging must be disabled for production releases.

Developer Launch Checklist

Before you submit your app to the Amazon Mobile App Distribution Program or another Android distribution program (e.g. Google Play), your app should pass the following criteria:

Ad Functionality (enableTesting is set to true)

  • Does the Amazon Cloud Player banner ad correctly open the Amazon Mobile App Distribution store (or other distribution store)?
  • For the Amazon Cloud Player banner ad, does the Ad Choices link located on the ad's banner open the Amazon Advertising Preferences page in an in-app browser?
  • Does the Pinzon banner ad correctly open the Pinzon mobile brand page in an in-app browser?
  • For the Pinzon banner ad, does the Ad Choices link located on the ad's banner open the Amazon Advertising Preferences page in an in-app browser?
  • If the app rotates, does the ad reload on a rotate event?
  • (For Android 2.0+, select ad sizes and devices only) Does the sample Amazon Kindle ad expand?
  • (For Android 2.0+, select ad sizes and devices only) Does the sample Amazon Kindle ad open the Mobile Ads in-app browser to the mobile Amazon website?
  • (For Android 2.0+, select ad sizes and devices only) Does the Amazon Kindle ad play video?
  • (For Android 2.0+, select ad sizes and devices only) For the Amazon Kindle ad, do the privacy links located on the ad's banner and the expanded ad both open the Amazon Advertising Preferences page in an in-app browser?
  • If the app loads full-screen interstitial ads, does clicking the interstitial open a website in an in-app browser?
  • If the app loads full-screen interstitial ads, does the Ad Choices link located in the corner open the Amazon Advertising Preferences page in an in-app browser?
User Experience (enableTesting is set to true)
  • Are the sample ads legible? E.g. minimal stretching/skewing
  • When an ad takes a long time to load, is the app's user experience impacted?
  • When an ad fails to load, is the app's user experience impacted?
  • Is the ad banner away from device and app controls?
  • If the ad banner contains a close button, does the button interfere with ad content? (Recommendation: Upper right hand corner)
  • Do automatic ad reloads take at least 30 seconds? (30 seconds is recommended)
  • If the app loads full-screen interstitial ads, does the app stall before the ad materializes on the screen? (If it does, make sure to pre-load the ad before it's time to show it)
  • If the app loads full-screen interstitial ads, does the ad's sudden appearance disrupt user activity?
App Configuration (enableTesting is set to false)
  • Are requests being sent without the test request flag? E.g. App is either not calling AdRegistration.enableTesting method or is passing false as the argument
  • Are requests being sent without the debug logging flag enabled? E.g. App is not calling AdRegistration.enableLogging method or is passing false as the argument
  • Are requests being sent with the correct Application Key?
Important: Apps that fail to pass these criteria may be deemed unsuitable and blocked from the Amazon Mobile Ad Network.