Chartboost Plugin

Integrate with Chartboost to monetize and cross-promote your games with ads.

Monetize

Chartboost is an ad network specifically designed for games and targeted at gamers. With Chartboost interstitial ads you can generate revenue for each click or install your games deliver, depending how other developers on the advertising side bid four your ad space.

Cross-Promote

Chartboost offers the so-called More Apps pages, on which you can either cross-promote your own games or games of other developers. This allows driving traffic from existing games to new ones.

Overview

The Chartboost plugin allows monetizing your apps & games by embedding ads from the Chartboost ad network or cross-promote other games of you or other developers.

Use Cases

Advertising campaigns can be used to earn revenue by showing ads, while cross-promotions make it simple to tell existing players about a new game.

Beside classic advertising and cross-promotion Chartboost also offers Rewarded videos, which are an ad type that give the player a reward (e.g. premium currency) after watching a mobile app trailer.

Advertising

Chartboost is an ad network specifically designed for games and targeted at gamers. Therefore only ads for games (and not apps in general) are displayed. The available standard ad type in Chartboost are interstitial ads, which can be shown between game sessions or at startup.

With Chartboost interstitial ads you can generate revenue for each click or install your games deliver, depending how the developer on the advertising side bids.

To show an interstitial ad call Chartboost::showInterstitial() from within your code. For quicker load times, we recommend caching data prior to making this call with Chartboost::cacheInterstitial().

Cross-Promotion

Additionally, Chartboost offers the so-called "More Apps" page, on which you can either cross-promote your own games or games of other developers. This allows driving traffic from existing games to new ones.

Chartboost allows a lot of different types of advertising campaigns like cross-promotion or direct deals. For detailed information on Chartboost settings consult the Chartboost documentation.

To show an "More Apps" page call Chartboost::showMoreApps() from within your code. For quicker load times, we recommend caching data prior to making this call with Chartboost::cacheMoreApps().

Named Locations

Named Locations allow you to show ads at different points within your game and fine-tune campaign behavior from the Chartboost dashboard without the need of updating your apps.

You can either define your own custom location names or use one of the predefined which matches your game's location best:

  • Chartboost.DefaultLocation
  • Chartboost.StartupLocation
  • Chartboost.HomeScreenLocation
  • Chartboost.MainMenuLocation
  • Chartboost.GameScreenLocation
  • Chartboost.AchievementsLocation
  • Chartboost.QuestsLocation
  • Chartboost.PauseLocation
  • Chartboost.LevelStartLocation
  • Chartboost.LevelCompleteLocation
  • Chartboost.TurnCompleteLocation
  • Chartboost.IAPStoreLocation
  • Chartboost.GItemStoreLocation
  • Chartboost.GameOverLocation
  • Chartboost.LeaderboardLocation
  • Chartboost.SettingsLocation
  • Chartboost.QuitLocation

If you omit a location parameter the default value Chartboost.DefaultLocation is used.

Note: Although it's possible to define own location identifiers it's recommended to use one of the predefined ones.

It's also recommended to have a maximum of 5-7 named locations per game.

Example Usage

To try the Chartboost plugin or see an integration example have a look at the V-Play Plugin Demo app.

The Chartboost item can be used like any other QML item. Here is a simple example of how to integrate the plugin in your existing game to display interstitial ads, but not the More Apps page:

 import VPlayPlugins 1.0

 Chartboost {
   id: chartboost

   appId:  "<your-app-id-here>"
   appSignature:  "<your-app-signature-here>"

   // Do not use reward videos in this example
   shouldDisplayRewardedVideo: false

   // Call this function to display an interstitial ad at the default location
   function showAdIfAvailable() {
     chartboost.showInterstitial()
   }

   onInterstitialCached: {
     console.debug("InterstitialCached at location:", location)
   }

   onInterstitialFailedToLoad: {
     console.debug("InterstitialFailedToLoad at location:", location, "error:", error)
   }

 }

Please also have a look at our plugin example project on GitHub: https://github.com/V-Play/PluginDemo

Available QML Items

Chartboost

Item allows monetizing your games by embedding Chartboost ads on Android and iOS

Integration

To use the Chartboost plugin you need to add the platform-specific native libraries to your project, described here:

iOS Integration Steps

  1. Download our PluginDemo from https://github.com/v-play/PluginDemo/archive/master.zip and unzip it.
  2. Copy Chartboost.framework from the ios sub-folder to a sub-folder called ios within your project directory.
  3. Add the following lines of code to your .pro file:
     ios {
       VPLAY_PLUGINS += chartboost
     }

Android Integration Steps

  1. Open your build.gradle file and add the following lines to the dependencies block:
     dependencies {
       compile 'net.vplay.plugins:plugin-chartboost:2.+'
     }

    Note: If you did not create your project from any of our latest wizards, make sure that your project uses the Gradle Build System like described here.

Chartboost Account

You finally need to set up a Chartboost user account at https://www.chartboost.com. Then open your Chartboost dashboard (https://dashboard.chartboost.com) and add an app & a campaign for your game. If you're publishing your game for both iOS & Android you should add two apps (and campaigns), as links to other games are platform-specific.

Note: It can take up to an hour until your new campaigns are available on devices.

Used Chartboost SDK Versions

iOS 6.4.7
Android 6.5.0

Note: Other SDK versions higher than the stated ones might also be working but are not actively tested as of now.

Videos

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
FREE!
create apps
create games
cross platform
native performance
3rd party services
game network
multiplayer
level editor
easiest to learn
biggest time saving
best support