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 ad correctly open the Amazon Mobile App Distribution store (or other distribution store)?
  • For the Amazon Cloud Player 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 ad correctly open the Pinzon mobile brand page in an in-app browser?
  • For the Pinzon 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?
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)
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 function 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 function 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.



Return to the Amazon Mobile Ads API Overview

Unavailable During Maintenance