Chartboost

The Chartboost item allows monetizing your games by embedding Chartboost ads on Android and iOS. More...

Import Statement: import VPlayPlugins 1.0
Inherits:

PluginItem

Properties

Signals

Methods

Detailed Description

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

Property Documentation

appId : string

Provide your Chartboost app-id here. If you do not have an app-id yet, please read Chartboost Account. As some features of Chartboost are platform-specific the following example code shows you how to use different app ids for Android and iOS:

 Chartboost {
   appId: Qt.platform.os === "ios" ? "<ios-appp-id>" : "<android-app-id>"
 }

appSignature : string

Provide your Chartboost app-signature here. If you do not have an app-signature yet, please read Chartboost Account. As some features of Chartboost are platform-specific the following example code shows you how to use different app ids for Android and iOS:

 Chartboost {
   appSignature: Qt.platform.os === "ios" ? "<ios-app-id>" : "<android-app-id>"
 }

shouldDisplayInterstitial : bool

Set this property to control whether interstitials should be displayed within your game or not. Settings this property to false globally disables all interstitials regardless of the given location.

The default value is true.


shouldDisplayLoadingViewForMoreApps : bool

Set this property to false to prevent a loading screen during the More Apps overlay is loaded from the server.

The default value is true.


shouldDisplayMoreApps : bool

Set this property to control whether the More Apps page should be displayed within your game or not. Settings this property to false globally disables all More Apps overlays regardless of the given location.

The default value is true.


shouldDisplayRewardedVideo : bool

Set this property to control whether a reward video should be displayed within your game or not. Settings this property to false globally disables all reward video overlays regardless of the given location.

The default value is true.


shouldPrefetchVideoContent : bool

By default Chartboost prefetches video content of reward videos for a continuous playback of a video. If you want to disable this behavior you can set this property to false.

The default value is true.


shouldRequestInterstitial : bool

Set this property to control whether interstitials should be loaded from the server or not. Settings this property to false globally disables all interstitials regardless of the given location.

As an example you can set this property to false to disable all ads as soon as your user purchased a "no ads" in-app purchase.

The default value is true.


shouldRequestInterstitialsInFirstSession : bool

It's good practice to show interstitials only after the user has played your game for the first time. This property therefore defaults to true.

You can override this behavior when setting the property to false.


shouldRequestMoreApps : bool

Set this property to control whether a More Apps page should be loaded from the server or not. Settings this property to false globally disables all More Apps overlays regardless of the given location.

As an example you can set this property to false to disable all ads as soon as your user purchased a "no ads" in-app purchase.

The default value is true.


Signal Documentation

interstitialCached(string location, Location locationType)

Emitted after an interstitial has been loaded from the server and cached locally for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also showInterstitial().


interstitialClicked(string location, Location locationType)

Emitted after an interstitial has been clicked for the given location. "Clicked" is defined as clicking within the interstitial which usually brings your app to the background and open the app store.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also interstitialDismissed and interstitialClosed.


interstitialClosed(string location, Location locationType)

Emitted after an interstitial has been closed for the given location. "Closed" is defined as clicking the close button within the interstitial.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also interstitialDismissed and interstitialClicked.


interstitialDismissed(string location, Location locationType)

Emitted after an interstitial has been dismissed for the given location. "Dismissal" is defined as any action that removed the interstitial like a click or close.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also interstitialClosed and interstitialClicked.


interstitialDisplayed(string location, Location locationType)

Emitted after an interstitial has been displayed on the screen for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also interstitialDismissed, interstitialClicked, and interstitialClosed.


interstitialFailedToLoad(string location, string error, Location locationType)

Emitted after an interstitial has attempted to load from the server but failed for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

You can use the error parameter to retrieve a text representation of the occurred error.


moreAppsCached(string location, Location locationType)

Emitted after a More Apps overlay has been loaded from the server and cached locally for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also showMoreApps().


moreAppsClicked(string location, Location locationType)

Emitted after a More Apps overlay has been clicked for the given location. "Clicked" is defined as clicking within the More Apps overlay which usually brings your app to the background and open the app store.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also moreAppsDismissed and moreAppsClosed.


moreAppsClosed(string location, Location locationType)

Emitted after a More Apps overlay has been closed for the given location. "Closed" is defined as clicking the close button within the More Apps overlay.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also moreAppsDismissed and moreAppsClicked.


moreAppsDismissed(string location, Location locationType)

Emitted after a More Apps overlay has been dismissed for the given location. "Dismissal" is defined as any action that removed the More Apps overlay like a click or close.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also moreAppsClosed and moreAppsClicked.


moreAppsDisplayed(string location, Location locationType)

Emitted after a More Apps overlay has been displayed on the screen for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also moreAppsDismissed, moreAppsClicked, and moreAppsClosed.


moreAppsFailedToLoad(string location, string error, Location locationType)

Emitted after a More Apps overlay has attempted to load from the server but failed for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter. You can use the error parameter to retrieve a text representation of the occurred error.


recordClickFailed(string uri, string error, Location locationType)

Emitted after a click got registered, but the user is not forwarded to the app store.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also interstitialClicked, moreAppsClicked, and rewardedVideoClicked.


rewardedVideoCached(string location, Location locationType)

Emitted after a reward video has been loaded from the server and cached locally for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also showRewardedVideo().


rewardedVideoClicked(string location, Location locationType)

Emitted after a reward video has been clicked for the given location. "Clicked" is defined as clicking within the reward video which usually brings your app to the background and open the app store.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also rewardedVideoDismissed and rewardedVideoClosed.


rewardedVideoClosed(string location, Location locationType)

Emitted after a reward video has been closed for the given location. "Closed" is defined as clicking the close button within the interstitial.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also rewardedVideoDismissed and rewardedVideoClicked.


rewardedVideoCompleted(string location, int reward, Location locationType)

Emitted after a reward video has been viewed completely and user is eligible for reward for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also rewardedVideoDisplayed and rewardedVideoClicked.


rewardedVideoDismissed(string location, Location locationType)

Emitted after a reward video has been dismissed for the given location. "Dismissal" is defined as any action that removed the interstitial like a click or close.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also rewardedVideoClosed and rewardedVideoClicked.


rewardedVideoDisplayed(string location, Location locationType)

Emitted after a reward video has been displayed on the screen for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also rewardedVideoDismissed, rewardedVideoClicked, and rewardedVideoClosed.


rewardedVideoDisplaying(string location, Location locationType)

Emitted immediately before a video has been displayed on the screen for the given location. You can use the signal to do things like muting sound effects or sounds.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter.

See also rewardedVideoDisplayed.


rewardedVideoFailedToLoad(string location, string error, Location locationType)

Emitted after a reward video has attempted to load from the server but failed for the given location.

For checking the ad location you can either use the locationType parameter and compare it with the available locations types or check the location as string representation with the location parameter. You can use the error parameter to retrieve a text representation of the occurred error.


Method Documentation

void cacheInterstitial(string location)


void cacheInterstitial(enumeration location)


void cacheMoreApps(string location)


void cacheMoreApps(enumeration location)


void cacheRewardedVideo(string location)


void cacheRewardedVideo(enumeration location)


void hasInterstitial(string location)


void hasInterstitial(enumeration location)


void hasMoreApps(string location)


void hasMoreApps(enumeration location)


void hasRewardedVideo(string location)


void hasRewardedVideo(enumeration location)


void showInterstitial(string location)


void showInterstitial(enumeration location)


void showMoreApps(string location)


void showMoreApps(enumeration location)


void showRewardedVideo(string location)


void showRewardedVideo(enumeration location)


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