Chartboost Videos

Boost your game with engaging, high-quality video ads! The Chartboost SDK offers rich media support, custom advertiser experiences, and refreshed end cards to make your videos feel less like ads and more like crafted recommendations. Give your players the best in-game experience to enhance your ad performance and drive higher eCPM.

Chartboost offers two types of video ads:

Rewarded video lets players earn in-game items or virtual currency in exchange for a completed video view.

Interstitial video earns you revenue or helps you acquire users similarly to static creatives.

Before you begin:

• Did you download and integrate the latest Chartboost SDK?
• Did you start a campaign in your dashboard? When setting up your campaign, select a Placement Type from the dropdown. What is this?

Got more questions? Read the Chartboost Video FAQs ▶

Now let’s turn on Chartboost video! Choose your platform:

Rewarded video integration for iOS

To create a rewarded ad you use the initializer initWithLocation:delegate: providing a Chartboost location, and an optional delegate.

CHBRewarded *rewarded = [[CHBRewarded alloc] initWithLocation:CBLocationMainMenu delegate:self];

Rewarded ads need to be cached before they can be shown. To cache a rewarded ad just call the cache method.

[rewarded cache];

To show a rewarded ad just call the show method.

[rewarded showFromViewController:self];

Learn more about delegate methods ▶

Customize your rewarded video’s behavior ▶

▲ Back to top

Interstitial integration for iOS

To create a interstitial ad you use the initializer initWithLocation:delegate: providing a Chartboost location, and an optional delegate.

CHBInterstitial *interstitial = [[CHBInterstitial alloc] initWithLocation:CBLocationMainMenu delegate:self];

Interstitial video ads need to be cached before they can be shown. To cache a interstitial video ad just call the cache method.

[interstitial cache];

To show a interstitial video ad just call the show method.

[interstitial showFromViewController:self];

▲ Back to top

Rewarded video integration for Android

To show a rewarded video add this call:

/** Show rewarded video ad at location Main Menu. 
See /libs/chartboost.jar/com.chartboost.sdk for available location options. **/

Chartboost.showRewardedVideo(CBLocation.LOCATION_MAIN_MENU);

/** Cache rewarded video ad at location Main Menu. 
See /libs/chartboost.jar/com.chartboost.sdk for available location options. **/

Chartboost.cacheRewardedVideo(CBLocation.LOCATION_MAIN_MENU);

...

if (Chartboost.hasRewardedVideo(CBLocation.LOCATION_MAIN_MENU) {
    Chartboost.showRewardedVideo(CBLocation.LOCATION_MAIN_MENU);
}
else {
    // We don't have a cached video right now, but try to get one for next time
    Chartboost.cacheRewardedVideo(CBLocation.LOCATION_MAIN_MENU);
}

To see when a reward is ready to be delivered, use the following delegate method:

public void didCompleteRewardedVideo(String location, int reward)

Learn more about delegate methods ▶

Customize your rewarded video’s behavior ▶

▲ Back to top

Interstitial video integration for Android

The call to show a video interstitial is the same as the call to show a static interstitial, so both campaign types use this request:

/** Show interstitial video ad at location Main Menu. See /libs/chartboost.jar/com.chartboost.sdk 
for available location options. **/

Chartboost.showInterstitial(CBLocation.LOCATION_MAIN_MENU);

Customize your rewarded video’s behavior ▶

▲ Back to top

Rewarded video integration for Unity

To show a rewarded video add this call:

Chartboost.showRewardedVideo(CBLocation.MainMenu);

/** Cache rewarded video ad at location Main Menu. 
See /assets/chartboost/scripts/chartboost.cs for available location options. **/

Chartboost.cacheRewardedVideo(CBLocation.MainMenu);

...

if (Chartboost.hasRewardedVideo(CBLocation.MainMenu) { 
    Chartboost.showRewardedVideo(CBLocation.MainMenu);
}
else {
    // We don't have a cached video right now, but try to get one for next time
    Chartboost.cacheRewardedVideo(CBLocation.MainMenu);
}

To see when a reward is ready to be delivered, use the following delegate method:

void didCompleteRewardedVideo(CBLocation location, int reward)

Learn more about delegate methods ▶

Customize your rewarded video’s behavior ▶

▲ Back to top

Interstitial video integration for Unity

The call to show a video interstitial is the same as the call to show a static interstitial, so both campaign types use this request:

Chartboost.showInterstitial(CBLocation.MainMenu);

Customize your rewarded video’s behavior ▶

▲ Back to top

Custom rewarded video behavior

You can reward players in different ways, depending on the campaign type. Here is an example in which a networking publishing campaign video ad offers a better reward than a cross-promotion campaign video ad:

• Set up two custom locations (e.g. NetworkVideo and CrossPromo) in your code. This lets you use the dashboard to prevent your network publishing campaign from showing ads at the CrossPromo location, and prevent your cross-promotion campaign from showing ads at the NetworkVideo location.
• To disable a campaign’s ads at a given location, select Never Show next to the location under your publishing campaign’s Advanced Settings > Logic > Custom priority settings. Learn more about logic & priorities ▶

• Check if a video is available at either location, show the appropriate prompt before playing the video, and give the appropriate reward afterward:

...
// Attempt to preload a video at BOTH named locations 
CHBRewarded *networkRewardedAd = [[CHBRewarded alloc] initWithLocation:@"NetworkVideo" delegate:self]; 
CHBRewarded *crossPromoRewardedAd = [[CHBRewarded alloc] initWithLocation:@"CrossPromo" delegate:self]; 
...

// Check which video is available first, or if no video is available
if (networkRewardedAd.isCached) {
        // We prefer to use the monetizing video if available
        // Call custom game UI prompt to offer to show a video for the NetworkVideo reward
        // If the user accepts you will call [networkRewardedAd showWithViewController:self];
}
else if (crossPromoRewardedAd.isCached) {
        // Call custom Game UI prompt to offer to show a video for the CrossPromo reward
        // If the user accepts you will call [crossPromoRewardedAd showWithViewController:self];
}
else {
	// No video available
}

• You can build your own UI to notify users of the reward they’ll receive if they play the video. When you’re ready to start playing the rewarded video, call showFromViewController: on the desired ad.
• After the player watches the video, check the location where your game’s rewarded video delegate method is called:

 - (void)didEarnReward:(CHBRewardEvent *)event {
	// The event.reward value is what is set on the app's dashboard, which we are overriding
	if ([event.ad.location isEqual:@"NetworkVideo"]) {
		// give your user the NetworkVideo reward
	} else {
		// give your user the CrossPromo reward
	}
 }

Learn more about delegate methods ▶

▲ Back to top

You might also like…

• Chartboost Video FAQs
• View-Through Attribution
• Mediation

Last Updated on September 3, 2020