IronSource

This guide is intended for publishers who want to use the Google Mobile Ads SDK to load and display ads from ironSource through mediation.

Step 1: Set up ironSource

The Google documentation contains a very detailed guide as to the process to setup your properties and IronSource account to display adverts:

Make sure you follow this guide closely.

Step 2: Configure mediation settings for your AdMob ad unit

You need to add ironSource to the mediation configuration for your ad unit:

Step 3: Import the ironSource SDK and adapter ANE

The com.distriqt.admob.IronSource ANE includes the IronSource SDK and the AdMob IronSource mediation adapter. This is everything you need to get IronSource mediation working in your application.

To add the ANE download it from the repository and add it to your application:

Add the extension id to your application descriptor:

<extensions>
<!-- OTHER EXTENSIONS -->
<extensionID>com.distriqt.admob.IronSource</extensionID>
</extensions>

More information on adding ANEs in this tutorial

Step 4: Additional code required

You should call IronSource.init(); in your code before you intend to display ads. This ensures the internal sdk is initialised correctly.

Android

Add the following to your manifest additions inside the application tag. You must replace APPLICATION_PACKAGE with your AIR application's Java package name, something like air.com.distriqt.test. Generally this is your AIR application id prefixed by air. unless you have specified no air flair in your build options.

<!-- IRONSOURCE -->
<activity
android:name="com.ironsource.sdk.controller.ControllerActivity"
android:configChanges="orientation|screenSize"
android:hardwareAccelerated="true" />
<activity
android:name="com.ironsource.sdk.controller.InterstitialActivity"
android:configChanges="orientation|screenSize"
android:hardwareAccelerated="true"
android:theme="@android:style/Theme.Translucent" />
<activity
android:name="com.ironsource.sdk.controller.OpenUrlActivity"
android:configChanges="orientation|screenSize"
android:hardwareAccelerated="true"
android:theme="@android:style/Theme.Translucent" />
<provider
android:name="com.ironsource.lifecycle.IronsourceLifecycleProvider"
android:authorities="APPLICATION_PACKAGE.IronsourceLifecycleProvider" />

iOS

Add the following to your info additions. If you already have an SKAdNetworkItems then append the dict items to the array.

<key>SKAdNetworkItems</key>
<array>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>su67r6k2v3.skadnetwork</string>
</dict>
</array>

Step 5: Test your implementation

You should run the IronSource validateIntegration() function to ensure the extension and manifest additions have been added correctly.

IronSource.instance.validateIntegration();

This will output information to the native device log.

You can then follow the Google guides to add a test device to receive test ads:

Optional Steps

EU consent and GDPR

Under the Google EU User Consent Policy, you must ensure that certain disclosures are given to, and consents obtained from, users in the European Economic Area (EEA) regarding the use of device identifiers and personal data. This policy reflects the requirements of the EU ePrivacy Directive and the General Data Protection Regulation (GDPR). When seeking consent, you must identify each ad network in your mediation chain that may collect, receive, or use personal data and provide information about each network's use. Google currently is unable to pass the user's consent choice to such networks automatically.

The code below shows you how to enable or disable personalized ads for ironSource.

IronSource.instance.setConsent( true );

If you choose to call this method, it is recommended that you do so prior to requesting ads via the Adverts extension.