How can we help you?

  1. Digital Turbine
  2. DT FairBid
  3. Mediated Networks
  4. Network Integration Guides
Follow

Chartboost

The purpose of this article is to guide publishers who want to use the DT FairBid SDK to load and display ads from Chartboost via DT Fairbid Mediation.

This is a six-step process:

  1. Create or login to your  Chartboost Account
  2. Create an App in Chartboost
  3. Create a placement for your app
  4. Retrieve the parameters from the Chartboost dashboard
  5. Insert the Chartboost parameters into the DT Console
  6. Add the Chartboost SDK to your integration

The following ad formats are currently supported by Chartboost:

  • Interstitials
  • Rewarded videos

Please refer to Chartboost for updates on supported ad formats.

Step 1: Create or Login to your Chartboost Account

Click here to sign up for your Chartboost account. Once you have created your account, click here to log-in.

Step 2: Create an App in Chartboost

To create an app in the Chartboost platform, follow the steps below:

  1. Sign in to the Chartboost platform
  2. Click + App in the Chartboost dashboard

bfd4eb8-Screen_Shot_2019-08-11_at_10.19.24.png

  1. Enter the details of the app, including the platform, app name, app orientation and store URL

795e9b3-Screen_Shot_2019-08-11_at_10.23.01.png

  1. Click Save.

Step 3: Create a Placement for your App

Click here, for details of how to create a placement for your app in Chartboost.

Step 4: Retrieve the Parameters from the Chartboost Dashboard

To enable Chartboost to work as an Ad Network on the DT Fairbid Mediation platform, you must obtain five parameters from your Chartboost account and later insert them into the DT Console.

Set out below are the details of what parameters are required, how and where to obtain them.

Chartboost Parameter Description
Named Location Allows you to show different ad campaigns at different points in your game and fine-tune your campaigns' behavior from your dashboard.
App ID The unique ID of your app in the Chartboost system.
App Signature The unique secret signature of your app in the Chartboost system. Chartboost uses it to verify that you're the owner of your app. Make sure not to share it with anyone unauthorized.
User ID The unique ID of your account user on the Chartboost dashboard.
User Signature The unique secret signature of your account user in the Chartboost Dashboard. Chartboost uses it to verify that you're allowed to access account analytics. Make sure not to share it with anyone unauthorized.

Alternatively, watch and listen to the video below to find out how to obtain the required parameters:

 

Chartboost Named Locations

Each new app has a default Location assigned to it automatically upon creation (called Default). Additional Locations can be created by calling them from the SDK (as opposed to creating them via the dashboard).

For more information, click here.

adLocation values must cross a small threshold of activity (generally around 10 different ad creatives displayed per day), otherwise their stats are aggregated under the Default location. Click here for more information.
This might explain discrepancies in data between the DT and Chartboost reporting systems (especially for new locations).

DT recommends to not use the default location, but instead assign a named location to each of the DT placements.

Obtaining the Named Location

To find the Named Locations, on the Chartboost platform click App Settings >> Basic Settings >> Advanced Settings

The different Named Locations created via SDK calls are highlighted in the screenshot below.

1c76b24-Screen_Shot_2019-08-26_at_14.03.06.png

The Named Locations are displayed.

Obtaining the App ID and App Signature

Follow these steps to obtain the App ID and App Signature from the Chartboost platform:

  1. From the Chartboost dashboard, click App Settings >> Basic Settings

c993650-Screen_Shot_2019-08-11_at_12.05.09.png

The App ID and App Signature are displayed in the right pane of the App Settings window:

4caf1aa-Screen_Shot_2019-08-11_at_12.09.06.png

 

Obtaining the User ID and User Signature

Follow these steps to obtain the User ID and User Signature from the Chartboost platform:

  1. From the Chartboost dashboard, click Tools >> API Explorer

cbd4e19-Screen_Shot_2019-08-11_at_12.12.25.png

The User ID and User Signature are displayed in the right pane of the API Explorer window:

8f9a9b4-Screen_Shot_2019-08-11_at_12.14.05.png

Now that you have obtained the required parameters, you can complete the configuration of Chartboost in your DT Account.

Step 5: Insert the Chartboost Parameters into the DT Console

To enter the parameters obtained from Chartboost and insert them into the DT Console, follow these steps.

  1. Sign-in to your DT account
  2. Select your app from the App Management window

  3. On the App Management page, click Mediated Networks

  4. Select Chartboost from the list

  5. The Chartboost Mediation window opens. Enter the Chartboost app credentials and set the Instance name. Instance name should be distinguishable in case you have multiple Chartboost Instances
    Screen_Shot_2023-02-19_at_16.40.12.png

  6. Click Save.

  7. To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the DT Console. For a detailed guide click here. 

Step 6: Adding the Chartboost SDK to your Integration

To add the Chartboost SDK go to the Supported Networks page and follow the guide while selecting the Configuration for Chartboost.

ProGuard

For ProGuard users only, follow the instructions here.

You have now successfully integrated Chartboost into the console.

Back to Top ⇧