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:
- Create or login to your Chartboost Account
- Create an App in Chartboost
- Create a placement for your app
- Retrieve the parameters from the Chartboost dashboard
- Insert the Chartboost parameters into the Fyber Console
- Add the Chartboost SDK to your integration
The following ad formats are currently supported by Chartboost:
- Rewarded videos
Please refer to Chartboost for updates on supported ad formats.
Step 1: Create or Login to your Chartboost Account
Step 2: Create an App in Chartboost
To create an app in the Chartboost platform, follow the steps below:
- Sign in to the Chartboost platform here.
- Click + App in the Chartboost dashboard
- Enter the details of the app, including the platform, app name, app orientation and store URL.
- 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.
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.
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:
- From the Chartboost dashboard, click App Settings >> Basic Settings
The App ID and App Signature are displayed in the right pane of the App Settings window:
Obtaining the User ID and User Signature
Follow these steps to obtain the User ID and User Signature from the Chartboost platform:
- From the Chartboost dashboard, click Tools >> API Explorer
The User ID and User Signature are displayed in the right pane of the API Explorer window:
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.
- Sign-in to your Fyber account.
- Select your app from the App Management window.
- On the App Management page, click Mediated Networks.
- Select Chartboost from the list
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.
If you are configuring the mediated network at app level, fewer credentials may be required.
- Click Save.
- 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.
For ProGuard users only, follow the instructions here.
You have now successfully integrated Chartboost into the console.