Warning: is_writable(): open_basedir restriction in effect. File(/var/www/clients/client2/web93/web/wp-content/uploads/broken-link-checker/blc-log.txt) is not within the allowed path(s): (/var/www/clients/client1/web15/web:/var/www/clients/client1/web15/private:/var/www/clients/client1/web15/tmp:/var/www/supersonic-knowledge.rtl.co.il/web:/srv/www/supersonic-knowledge.rtl.co.il/web:/usr/share/php5:/usr/share/php:/tmp:/usr/share/phpmyadmin:/etc/phpmyadmin:/var/lib/phpmyadmin) in /var/www/clients/client1/web15/web/wp-content/plugins/broken-link-checker/core/init.php on line 141
NativeX Integration Guide - Supersonic Knowledge Center

NativeX Integration Guide

This guide will instruct you step-by-step on how to set NativeX live as an Ad Network on the Supersonic Mediation platform. The integration process is completed in 5 simple steps:

  1. Create an NativeX Account
  2. Create an Application in NativeX
  3. Create a Placement in NativeX
  4. Activate NativeX in Your Supersonic Network Setup Module
  5. Add the NativeX Adapter to Your Build

Before You Start

Make sure you have correctly integrated Supersonic Rewarded Video into your application. Integration is outlined here.

Step 1. Create an NativeX Account

  1. Create an account with NativeX. You can do so here.
  2. Once your account has been verified, you can log in at their partner login here.

Step 2. Create an Application in NativeX

Follow these steps to create your NativeX application:

  1. Once you log in select ‘Add App’:
    NativeX integration with Supersonic Mediation - 01
  2. Define the settings of your app:
    1. Platform – iOS or Android
    2. App URL – Input the AppStore or Google Play URL of your application. If your app is not live yet, select the ‘Not Live’ option.
    3. COPPA compliance – Mark this checkbox if your app is directed to children according to the Children’s Online Privacy Protection Act (COPPA) 16 CFR 312.
    4. Country – The country store your app is listed in.

Once all information is updated, select ‘Monetize’ to finish:
NativeX integration with Supersonic Mediation - 02

Note: You will need a unique NativeX application per platform (iOS + Android) just like you do with your Supersonic account.

Step 3. Create a Placement in NativeX

Once you have created an application you will need to create a Placement In the NativeX system. Placements are locations in your app where NativeX will deliver ads. This will be the placement you configured in your app that triggers Supersonic’s Rewarded Video.

  1. Select ‘+ Add Placement
    NativeX integration with Supersonic Mediation - 03Create the Placement settings:

    1. Category – The location where this Placement will be served in your app.
      Note: This placement will map to the multiple placements you can define in your Supersonic account, so simply pick any value here.
    2. Name – The Name of the Placement.
      Note: This placement can map to the multiple placements you can define in your Supersonic account, so simply pick a generic name. We recommend the name ‘Rewarded Video
    3. Ad Type – Select ‘Reward‘ only.
      NativeX integration with Supersonic Mediation - 04When finished hit ‘Save & Add‘.
      Once the Placement is saved, select ‘Continue‘.
      NativeX integration with Supersonic Mediation - 05
  2. Select ‘+ Add Virtual Reward
    NativeX integration with Supersonic Mediation - 06Create the Reward settings:

    1. Reward Name – We recommend using ‘Reward‘.
    2. Reward ID – We recommend using ‘Reward‘.
    3. Value Exchange – Select ‘1‘.
    4. Static Reward – Select ‘1‘.
      Note: These placement settings are controlled by your Supersonic account; the parameters you set on your Supersonic account for Reward Type/Amount will ultimately affect your end user. Do not worry about the values entered here.  

      NativeX integration with Supersonic Mediation - 07

When finished, hit ‘Save & Continue‘.

Step 4. Activate NativeX in Your Supersonic Network Setup Module

There are 3 pieces of data from the NativeX account which need to be inserted into your Supersonic Network Setup Module in order for NativeX to work correctly in connection with Supersonic

App ID This is the unique identifier of your Application in NativeX’s system.
Placement Name This is the unique identifier of your Placement which NativeX will deliver ads to.
API Key  This is a unique identifier for your NativeX account, which allows your Supersonic Mediation Platform to import performance data from your NativeX account to use in reporting & optimization.

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

  1. App ID

    Navigate back to the ‘Apps‘ tab and you will locate the ‘NativeX App ID‘.
    NativeX integration with Supersonic Mediation - 08

  2. Placement Name

    Navigate to ‘Monetization‘ ➣ Select the ‘App‘ you created ➣ then you will see the Placement listed. You will find the ‘Placement Name‘ there.
    NativeX integration with Supersonic Mediation - 09

  3. API Key

    Navigate to ‘Reports‘ ➣ You will see the API Key listed next to ‘Publisher Reporting API Key‘.
    NativeX integration with Supersonic Mediation - 10

 

Configure NativeX’s Parameters into Supersonic Account

Once you obtain the above parameters, log in to your Supersonic account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.

Select NativeX from the list of available Ad Networks and input the NativeX ‘App ID‘, ‘Placement Name‘, ‘API Key‘ in the relevant fields.
NativeX integration with Supersonic Mediation - 11

Step 5. Add the NativeX Adapter to Your Build

Android

Supersonic supports both Gradle dependencies and manual download mechanisms.

Gradle:

  1. Make sure the following Maven URL exist in your build.gradle script of your app module. (should appear only once for all the adapters)
    repositories {
    maven {
    url "https://dl.bintray.com/supersonic/android-adapters"
    }
    }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {
    compile 'com.supersonic.adapters:nativexadapter:1.0.2@jar'
    }
  3. Add GSON jar to your project if you don’t already use it. Download it from here.[]Missing link, should be internal in this doc

 

Manual download:

  1. Download the NativeX Adapter:
    This will add the NativeX Adapter to your build. You can find the latest NativeX Adapter here.
    Important! The NativeX Adapter also contains the NativeX jar. You DON’T need to additionally add the NativeX jar directly.
  2. Add GSON jar to your project:
    If you don’t already use it, download it from here.
  3. Add the NativeX Adapter to your Project:
    After you download the Adapter; drop the NativeXAdapter jar and Gson.jar into the libs folder in your android Project.
    NativeX integration with Supersonic Mediation - 12
  4. Update AndroidManifest.xml:

    Manifest activities:

    <activity
    android:name="com.nativex.monetization.activities.InterstitialActivity"
    android:configChanges="orientation|screenSize"
    android:hardwareAccelerated="true"
    android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" /><activity
    android:name="com.nativex.videoplayer.VideoActivity"
    android:configChanges="orientation|screenSize" />

 

Verify Your Ad-Network Integration

The Supersonic SDK provides an easy way to verify that your Rewarded Video Mediation integration was completed successfully. To verify your Supersonic and additional Ad Networks integration, follow this document.


Done!
You are now all set to deliver NativeX Ads within your application!


 


What’s Next?
To add additional Rewarded Video Ad networks, follow the integration guides on our Supported Ad Networks list.