chartboost.*

Type Library
Revision 2017.3060
Keywords ads, advertising, Chartboost
Platforms Android, iOS

Overview

The Chartboost plugin allows developers to monetize users through Chartboost static interstitial, video interstitial, rewarded video ads, and more.

The Chartboost plugin is only available to users who have purchased the Corona Professional Bundle or the Chartboost plugin. This plugin lets you keep 100% of your ad revenue and allows you to manage your account/settings with Chartboost directly.

Due to recent Android dependency updates, this plugin requires daily build 2016.3005 or later.

Registration

Before you can use this plugin, you must register with Chartboost.

Syntax

local chartboost = require( "plugin.chartboost" )

Functions

Events

Project Settings

To use this plugin, add an entry into the plugins table of build.settings. When added, the build server will integrate the plugin during the build phase.

settings =
{
    plugins =
    {
        ["plugin.chartboost"] =
        {
            publisherId = "com.coronalabs"
        },
    },
}

In addition, please add the appropriate OS version restriction specified below to prevent your Chartboost-enabled apps from being installed on incompatible devices:

settings =
{
    iphone =
    {
        plist =
        {
            MinimumOSVersion = "7.0"
        }
    },
}
Important

If you are building for Android, you should remove any legacy inclusion of the ["plugin.google.play.services"] plugin from your build.settings.

Note

For Android, the following permissions/features are automatically added when using this plugin:

  • "android.permission.INTERNET"
  • "android.permission.ACCESS_NETWORK_STATE"
  • "android.permission.WRITE_EXTERNAL_STORAGE"

In addition, you can add the following optional (but recommended) permissions:

  • "android.permission.ACCESS_WIFI_STATE" — Allows the Chartboost SDK to check WiFi details and send the MAC address in the HTTP request. This will be used alongside the Android ID and/or GAID (where applicable) as the identifier for the user.

  • "android.permission.READ_PHONE_STATE" — Allows the Chartboost SDK to handle calls interrupting video playback during videos.

Support