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
HyprMX Integration Guide - Supersonic Knowledge Center

HyprMX Integration Guide

 

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

  1. Create an Account & Application in HyprMX
  2. Activate HyprMX in Your Supersonic Network Setup Module
  3. Add the HyprMX Adapter to Your Build

Before You Start

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

Note:

  1. Due to a known issue with Google’s code the current HyprMX Android SDK will not return ads for users running Lollipop or Marshmallow (an upcoming SDK release will solve this issue).
  2. For iOS, HyprMX currently supports iOS 8+.

Step 1. Create an HyprMX Account

  1. Create an account with HyprMX. You can do so here.
  2. HyprMX provides a managed service. Once your account is created, you will need to contact HyprMX directly in order have an application setup and retrieve the required parameters to activate HyprMx in your Supersonic account.

Step 2. Activate HyprMX in Your Supersonic Network Setup Module

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

API Key This is the unique identifier of your account in the HyprMX system.
Distributor ID This is the unique Application identifier which HyprMX will deliver ads to.
Placement ID This is a unique identifier of your Placement with HyprMX.

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

Configure HyperMX’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 HyprMX from the list of available Ad Networks and input the HyprMX ‘API Key‘ , ‘Distributor ID‘ , ‘Placement ID‘.
HyprMX integration with Supersonic Mediation - 01

Step 3. Add the HyprMX Adapter to Your Build

Android

Supersonic support 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:hyprmxadapter:1.0.3@jar'
    }

    Note: In addition you will add the HyprMX SDK to your libs folder (as explained below).

 

Manual download:

  1. Download the HyprMX Adapter:
    This will add the HyprMX Adapter to your build. You can find the latest HyprMX Adapter here.
  2. Download the HyprMx SDK:
    Please download HyprMX SDK from here.
  3. Add the HyprMX Adapter and SDK to your Project:
    After you download the Adapter and SDK; drop the HyprMXAdapter jar and HyprMX SDK into the libs folder in your android Project.
  4. Update AndroidManifest.xml:
    Manifest activities:

    <activity
    android:name="com.supersonic. adapters.hyprmx. MediationHMXActivity"
    android:configChanges="orienta tion|screenSize| keyboardHidden|keyboard| smallestScreenSize|uiMode| fontScale|screenLayout|locale" />
    <service
    android:name="com.hyprmx. android.sdk.service. ApplicationInstallService"
    android:enabled="true"
    android:exported="false"
    android:stopWithTask="false" />

 

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 HyprMX within your application!


 

What’s Next?

To add additional Rewarded Video Ad networks, follow the integration guides on our Supported Ad Networks list.