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

Chartboost Integration Guide

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

  1. Create a Chartboost account
  2. Create an Application in Chartboost
    1. First Time Setup
    2. Normal Setup
  3. Create a Chartboost Publishing Campaign
    1. Creating a Publishing Campaign
    2. Publishing Campaign Targeting Options
  4. Activate Chartboost in your Supersonic Network Setup Module
  5. Add the Chartboost 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 a Chartboost Account

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

Step 2. Create an Application in Chartboost

Already set up your application(s) at Chartboost? Skip to here.

First Time Setup Process
If this is your first time setting up a Chartboost account, continue below.

  1. When you log in for the first time, select ‘Start making money!
    Chartboost integration with Supersonic Mediation - 01
  2. Define your apps:
    Chartboost will automatically try to identify your Applications in the Appstore based on the company name you provide in the sign-up process. If this process is successful, simply select the applications you want to run Rewarded Video on.
    If this process doesn’t work immediately, you have two options:

    1. Search for your Company manually:
      Chartboost integration with Supersonic Mediation - 02
    2. If your apps aren’t published on any Appstore yet, you can enter details manually:
      Chartboost integration with Supersonic Mediation - 03
      Note: You will need a unique Chartboost application per platform (iOS + Android) just like you do with your Supersonic account.
    3. After you defined the Applications, select the relevant Apps for Rewarded Video and select ‘Add Selected (x of x)‘:
      Chartboost integration with Supersonic Mediation - 04
  3. Select the ‘Rewarded Video Ads‘ Ad Unit and select ‘Create Campaign(s)‘:
    Chartboost integration with Supersonic Mediation - 05
  4. You will be re-directed to the below page where you will find a summary of your newly created apps, including the App ID and the App Signature. These parameters will later be inserted into your Supersonic Admin account under the Network Setup Module. Chartboost integration with Supersonic Mediation - 06
  5. Finally you will want to turn OFF Chartboost’s pre/post-roll video messaging. Navigate to your app on the Chartboost dashboard, select ‘Basic Settings‘ ➣ ‘Rewarded Video‘ ➣ ‘Advanced‘ and you will see  two checkboxes. Make sure they are unchecked and select ‘Save‘:
    Chartboost integration with Supersonic Mediation - 07

If you have completed the above process successfully, continue here.
 Normal Setup Process

Follow this section if you have previously set up your Chartboost account and you’re simply adding new applications to use on Supersonic’s Mediation platform.
Is this your first time setting up your application(s) on Chartboost? Go back here.

  1. Once you login select ‘Dashboard‘ ➣ ‘Publishing‘ ➣ ‘Add App‘:
    Chartboost integration with Supersonic Mediation - 08
  2. Define the details of your application:
    1. Platform – iOS or Android.
    2. App Nickname – Used to represent your app in the Chartboost Reporting UI.
    3. Orientation – Select ‘Landscape’ or ‘Portrait’.
    4. Test Mode – Select ‘Disabled’.Once finished select ‘Save’:
      Chartboost integration with Supersonic Mediation - 09
      Note: You will need a unique Chartboost application per platform (iOS + Android) just like you do with your Supersonic account.
  3. You will be re-directed to the below page where you will find a summary of your newly created Apps.
    You will specifically find both the ‘App ID‘ and the ‘App Signature‘ here. These parameters should be entered into your Supersonic Admin account under the ‘Network Setup‘ Module.
    Chartboost integration with Supersonic Mediation - 10
  4. Finally you will want to turn OFF Chartboost’s pre/post-roll video messaging. Navigate to your app, select ‘Basic Settings‘ ➣ ‘Rewarded Video‘ ➣ ‘Advanced‘ and you will see two checkboxes. Make sure they are unchecked and select ‘Save‘:
    Chartboost integration with Supersonic Mediation - 11

Step 3. Create a Chartboost Publishing Campaign

In order to serve Chartboost’s video ads in your app, you should create a publishing campaign on Chartboost as following:

  1. Within your Chartboost dashboard, Click Add a Campaign in the bottom-left corner and then click Network Publishing.
  2. In the Simple Setting section, indicate what type of ads you’ll be publishing (Ad Type drop-down), enter a campaign name, and choose the game(s) in which the campaign will run.
  3. Click Save.
    Note: Campaigns may take up to 20 minutes to go live.


Note: Publishing Campaign Targeting Options
If you’d like to define targeting options for your application, follow the instructions on Chartboost.

Step 4. Activate Chartboost in Your Supersonic Network Setup Module

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

App ID This is the unique identifier of your Application in Chartboost’s system.
App Signature This is the unique signature used to validate Ad Requests to your specific Chartboost Application.
User ID This is a unique identifier for your Chartboost account, which allows your Supersonic Mediation Platform to import performance data from your Chartboost account to use in reporting & optimization.
User Signature  This is a unique identifier for your Chartboost account to verify reporting requests made by Supersonic on your behalf.

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

  1. App ID & App Signature

    Navigate back to ‘Dashboard‘ ➣ ‘App Settings‘ ➣ ‘Basic Settings‘ and you fill the ‘App ID‘ and ‘App Signature‘ listed:
    Chartboost integration with Supersonic Mediation - 12

  2. User ID & User Signature

    Navigate back to ‘Dashboard‘ ➣ ‘Overview / Advertising‘ and select ‘API Explorer‘ from the ‘Tools‘ drop-down:

    Chartboost integration with Supersonic Mediation - 013On the following page you will find both the ‘User ID‘ & the ‘User Signature’ listed:

    Chartboost integration with Supersonic Mediation - 14

 

Configure Chartboost’s Parameters into Supersonic Account

Once you have all these parameters, log in to your Supersonic account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.

Select Chartboost from the list of available Ad Networks and input the Chartboost ‘App ID‘, ‘App Signature‘, ‘User ID’ and ‘User Signature‘ in the relevant fields.

Chartboost integration with Supersonic Mediation - 15

Step 5. Add the Chartboost Adapter to Your Build

Android

Supersonic support both Gradle dependencies and manual download mechanisms.

Gradle:

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"
}
}

Add the adapter’s Maven name to your build.gradle script of your app module.

dependencies {
compile 'com.supersonic.adapters:chartboostadapter:1.0.6@jar'
}

 Manual download:

  1. Download the Chartboost Adapter:
    This will add the Chartboost Adapter to your build. You can find the latest Chartboost Adapter here.
    Important! The Chartboost Adapter also contains the Chartboost jar. You DON’T need to additionally add the Chartboost jar directly.
  2. Add the Chartboost Adapter to your project:
    After you download the Adapter; drop the ChartboostAdapter jar into the libs folder in your Android Project.
    Chartboost integration with Supersonic Mediation - 16
  3. Update AndroidManifest.xml:
    Manifest activities:

    <activity
    android:name="com.chartboost.sdk.CBImpressionActivity"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:configChanges="keyboardHidden|orientation|screenSize"
    android:excludeFromRecents="true"
    android:hardwareAccelerated="true"/>

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


 

What’s Next?

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