Amazon Mobile Ad Network Integration Guide

This guide instructs you step-by-step on how to set Amazon live as an ad network on the ironSource mediation platform.

Before you start
  • The Amazon Mobile Ad Network serves ads to users in the U.S., U.K., Germany, France, Spain, Italy and Japan.
  • GDPR Consent in Amazon is not part of the mediation Consent API provided by the SDK.
    In order to use GDPR with Amazon Mobile Ad Network, please follow the instructions they provide inside this page, under Has your SDK been updated for GDPR?”.

Step 1. Create an Amazon Account

  1. To access Amazon’s ad inventory through ironSource‘s mediation platform, you must create an account with Amazon. You can do so here.

Step 2. Create an Application in Amazon

Next, you must add the app in your Amazon account.

Add Your App

  1. Log into your Amazon account. On your dashboard, click the ‘Mobile Ads button under “Apps & Services” tab.
  2. Add your app manually or simply select an existing app to monetize.
    Note: Note: You will need a unique Amazon application per platform (iOS + Android), just the same as in your ironSource account.


GDPR Consent in Amazon is not part of the mediation Consent API provided by the SDK.
In order to use GDPR with Amazon Mobile Ad Network, please follow the instructions they provide inside this page, under Has your SDK been updated for GDPR?”.

Step 3. Activate Amazon in Your ironSource Network Setup Module

Serving Amazon’s ads through the ironSource mediation platform has never been this easy. Sign in to your Amazon account when setting up Amazon on the ironSource SDK Networks setup page and we’ll automatically retrieve all the necessary parameters to run Amazon’s Banners for you!


There is a data piece from your Amazon account which needs to be inserted into your ironSource network setup module in order for Amazon to work correctly in connection with ironSource:

The unique ID assigned to your app on Amazon’s Mobile Ads dashboard.

Once you obtain this information, you must configure Amazon’s Parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of Amazon’s ad inventory and reporting data on the ironSource mediation platform.


Once you have created an application in the Amazon’s Mobile Ads dashboard (as described in step 2), You will be transferred to a general application dashboard, from here please click on “Mobile Ads
amazon-2-go-to-mobile-ads-dashboardObtain your Key value from the dashboard and place it in the ironSource Network Setup Module in the “App Key” field.

Price Floor

In order to take advantage of the usage of multiple Amazon ads in the waterfall, please consider the price floor parameter inside ironSource network setup module. This value represents the floor price allowed that specific Amazon instance can serve (0.75 = 0.75$ floor price).

Step 4. Add the Amazon Adapter to Your Build

Unity Integration Manager  (Recommended)

Once you’ve completed SDK integration, you can download Amazon Adapter, using the Unity Integration Manager.

In your Unity Development platform, go to ironSource > Integration Manager

If you already have the latest version of the adapters, the action button will be changed to “Updated”, and will be disabled.

Android (Manual Resolve)

To apply your changes, make sure you use the “Resolve” process. This will download all relevant artifacts, according to your choices. For detailed information see instructions here

Android Plugin Manual Integration

  1. Download the Amazon Adapter:
    Download Amazon adapter from here.
  2. Add the AdColony files to your Unity project:
    Import the file into Assets/Plugins/Android/.
     Disclaimer: Plugin version 6.7.1To accommodate changes in Unity version 5.5, the ironSource Plugin version 6.7.1 requires Android Manifests to be added separately for the Plugin and mediation adapter. If you are updating your plugin or currently running on 6.7.1, make sure to add the manifest activities noted in the Android documentation.

iOS Plugin iOS Manual Integration

  1. Download the Amazon iOS adapter and SDK: 
    Download the adapter and SDK files from here.
  2. Add the Amazon Framework files to your Unity project:
    Import adapter and SDK Framework file into Assets/Plugins/iOS.

Step 5. Update AndroidManifest.xml

As of Amazon Android adapter version 4.3.2+ (Android SDK Version 6.17.0), Amazon adapter will be released as AAR. Only if you intend to keep your Jar integration, please add the manifest.

Manifest Permissions:

<uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Optional -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

Manifest Activities:
Add the following activities inside the <application> tag on your manifestAdditions:

<activity android:name="" android:configChanges="keyboardHidden|orientation|screenSize"/>

Verify Your Ad Network Integration

The ironSource SDK provides an easy way to verify that your mediation integration was completed successfully. To verify your ironSource and additional ad setworks’ integration, follow this document.

You are now all set to deliver Amazon ads within your application!