Chartboost

Introduction

The purpose of this article is to guide publishers who want to use the Fyber FairBid SDK to load and display ads from Chartboost via 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 Fyber Console
  6. Add the Chartboost SDK to your integration

Note

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 here.
  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 Fairbid Mediation platform, you must obtain five parameters from your Chartboost account and later insert them into the Fyber Console.

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

The parameters required depend on whether you are configuring the network at the App Level or Placement Level in the Fyber Console.

Chartboost Parameter Description Fyber Placement / App
Named Location Allows you to show different ad campaigns at different points in your game and fine-tune your campaigns' behavior from your dashboard. Placement Level
App ID The unique ID of your app in the Chartboost system. Both
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. Both
User ID The unique ID of your account user on the Chartboost dashboard. Both
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. Both

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.

Note

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 Fyber and Chartboost reporting systems (especially for new locations).

Fyber recommends to not use the default location, but instead assign a named location to each of the Fyber 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 Fyber Account.

Step 5: Insert the Chartboost Parameters into the Fyber Console

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

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

  1. On the App Management page, click Mediated Networks.

  1. Select Chartboost from the list

The Chartboost Mediation window opens:

  1. Enter the Chartboost app credentials and set the Instance name.

Instance name should be distinguishable in case you have multiple Chartboost Instances.

Note

If you are configuring the mediated network at app level, fewer credentials may be required.

  1. Click Save.
  2. To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the Fyber Dashboard . 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.