广告单元

开始之前

在将广告单元集成到您的应用之前，您必须：

• 在 OpenMediation 用户界面中创建一个帐户，创建一个应用并创建一个广告展示位置。您可以按照 指南进行操作。
• 通过将OpenMediation Cocos插件集成到您的项目中，按照我们的步骤进行 Cocos插件集成。

现在，当您将OpenMediation SDK部署到Android或iOS平台时，它就会包含在您的应用程序中。现在您可以实施广告单元了。OpenMediation Cocos插件提供多种种不同的广告格式。您可以选择最适合您的用户体验需求的一种。

 

激励视频广告

具有较强交互能力的奖励视频广告已成为移动广告行业的主流形式。手机游戏开发商越来越依赖内置广告而不是IAP来获利。

Rewarded Video广告单元提供引人入胜的广告体验，以有价值的虚拟内容奖励您的用户，以换取完整的视图。这个由用户启动的广告单元非常适合游戏应用，并可以改善您的应用体验。本部分介绍如何初始化，加载和显示奖励视频广告。

 

步骤 1. 接收奖励视频广告事件

OpenMediation SDK会触发多个事件，以通知您Rewarded Video Ad活动。在每种广告事件回调方法中，您都会获得相应的广告展示位置的状态。

插件将通知监听者以下所有可能的事件：

OpenMediation.Ads.setListener({

    onRewardedVideoAvailabilityChanged: function (available) {
        // Invoked when the ad availability status is changed
    },

    onRewardedVideoShow: function (scene) {
        // Invoked when the RewardedVideo ad view has opened
    },

    onRewardedVideoShowFailed: function (scene) {
        // Invoked when the call to show a rewarded video has failed
    },

    onRewardedVideoClosed: function (scene) {
        // Invoked when the RewardedVideo ad is closed
    },

    onRewardedVideoStarted: function (scene) {
        // Invoked when the RewardedVideo ad start to play
    },

    onRewardedVideoEnded: function (scene) {
        // Invoked when the RewardedVideo ad play end
    },

    onRewardedVideoReceiveRewarded: function (scene) {
        // Invoked when the video is completed and the user should be rewarded
    },

    onRewardedVideoClicked: function (scene) {
        // Invoked when the user clicked on the RewardedVideo ad
    },
});

 

步骤 2. 检查广告的可用性

奖励广告成功加载后，将通过 onRewardedVideoAvailabilityChanged 通知您可以显示广告，该通知将通知您广告资源的可用性。

onRewardedVideoAvailabilityChanged: function (available) {
    // Invoked when the ad availability status is changed
}

检查广告是否可用的另一种方法是直接调用 isRewardedVideoReady 函数。

OpenMediation.Ads.rewardedVideoIsReady();

 

步骤 3. 展示激励视频广告

强烈建议您在投放奖励视频之前，通过调用 rewardedVideoIsReady 方法来检查广告的可用性。

if (OpenMediation.Ads.rewardedVideoIsReady()) {
    OpenMediation.Ads.showRewardedVideo("SceneName");
}

 

插屏广告

Interstitial是全屏广告单元，通常在应用程序的生命周期内的自然过渡点投放。同时支持静态和视频非页内广告。

 

步骤 1. 接收InterstitialAd广告事件

OpenMediation SDK会触发多个事件来通知您非页内广告活动。在每种广告事件回调方法中，您都会获得相应的广告展示位置的状态。

插件将通知监听者以下所有可能的事件：

OpenMediation.Ads.setListener({

    onInterstitialAvailabilityChanged: function (available) {
        // Invoked when the interstitial ad availability status is changed
    },

    onInterstitialShow: function (scene) {
        // Invoked when the Interstitial ad has opened
    },

    onInterstitialShowFailed: function (scene) {
        // Invoked when the Interstitial ad has showed failed
    },

    onInterstitialClosed: function (scene) {
        // Invoked when the Interstitial ad is closed
    },

    onInterstitialClicked: function (scene) {
        // Invoked when the user clicked on the Interstitial ad
    },
});

 

步骤 2. 检查广告的可用性

插屏广告成功加载后，将通过 onInterstitialAvailabilityChanged 回调通知您何时可以显示广告，该通知将通知您广告资源的可用性。

onInterstitialAvailabilityChanged: function (available) {
    // Invoked when the interstitial ad availability status is changed
}

检查广告是否可用的另一种方法是直接调用 interstitialIsReady 方法。

OpenMediation.Ads.interstitialIsReady();

 

步骤 3. 展示插屏广告

强烈建议您在投放插屏广告之前，通过调用 interstitialIsReady 方法来检查广告的可用性

if (OpenMediation.Ads.interstitialIsReady()) {
    OpenMediation.Ads.showInterstitial("SceneName");
}

 

横幅广告

横幅广告通常显示在屏幕的顶部或底部，并在用户会话期间一直粘贴在屏幕上。 标语广告是易于使用的移动广告，是提高移动广告客户知名度的好工具，是移动应用程序中非常受欢迎的广告单元。

 

步骤 1. 接收横幅广告事件

插件将通知接收器器以下所有可能的事件：

OpenMediation.Ads.setListener({

    onBannerLoadSuccess: function (placementId) {
        // Invoked when Banner Ad load success
    },

    onBannerLoadFailed: function (placementId, msg) {
        // Invoked when Banner Ad load failed
    },

    onBannerClicked: function (placementId) {
        // Invoked when the user clicked on the Banner Ad
    },
});

 

步骤 2. 加载横幅广告

要加载横幅广告，请调用以下方法：

// placementId string
// adSize int 0:Banner; 1:MediumRectangle; 2:Leaderboard; 3:Smart
// position int 0:Bottom; 1:Top
OpenMediation.Ads.loadBanner(placementId, 0, 0)

有关我们支持的标准 横幅位置的 详细信息，请参见下表：

您会收到 onBannerLoadSuccess，并且横幅会显示在您的应用中。

隐藏和显示横幅

为了在广告体验中提供最大的灵活性，您现在可以在应用中隐藏和展示横幅。

与Android和iOS本机实现不同，横幅广告在应用程序中首次加载时会自动显示，因此无需调用displayBanner()。

加载并提供横幅广告后，您可以选择隐藏此横幅广告，并在以后在应用中重新显示。

要隐藏横幅，请调用此函数：

OpenMediation.Ads.hideBanner(placementId);

要再次显示相同的横幅，请调用此函数：

OpenMediation.Ads.showBanner(placementId);

步骤 3.销毁横幅广告 

要销毁横幅，请调用以下方法：

OpenMediation.Ads.destroyBanner(placementId);

销毁的横幅广告无法再复用。如果您想再次使用它，则必须再次加载它。

 

交叉推广广告

步骤 1. 接收 PromotionAd 广告事件

OpenMediation SDK会触发多个事件来通知您非页内广告活动。在每种广告事件回调方法中，您都会获得相应的广告展示位置的状态。

插件将通知监听者以下所有可能的事件：

OpenMediation.Ads.setListener({

    onPromotionAdAvailabilityChanged: function (available) {
        // Invoked when PromotionAd availability changed
    },

    onPromotionAdShow: function (scene) {
        // Invoked when the PromotionAd has opened
    },

    onPromotionAdViewWillDisappear: function (scene) {
        // Invoked when the PromotionAd is closed
    },

    onPromotionAdClicked: function (scene) {
        // Invoked when the user clicked on the PromotionAd
    },
});

步骤 2. 检查广告的可用性

交叉推广广告成功加载后，将通过 onPromotionAdAvailabilityChanged 回调通知您何时可以显示广告，该通知将通知您广告资源的可用性。

onPromotionAdAvailabilityChanged: function (available) {
    // Invoked when PromotionAd availability changed
}

检查广告是否可用的另一种方法是直接调用 promotionAdIsReady 函数。

OpenMediation.Ads.promotionAdIsReady();

 

步骤 3. 展示广告

强烈建议您在投放交叉推广广告之前，通过调用 promotionAdIsReady 方法来检查广告的可用性

if (OpenMediation.Ads.promotionAdIsReady()) {
    // Scene name
    // Ad width
    // Ad height
    // The distance from the left side of the screen, the value is 0~1, default 0
    // The distance from the top side of the screen, the value is 0~1, default 0
    // Take the center as the dot and rotate the angle clockwise, default 0
    OpenMediation.Ads.showPromotionAd('scene', 132, 153, 0, 0.3, 20);
}

 

开屏广告

步骤 1. 接收 SplashAd 广告事件

OpenMediation SDK会触发多个事件来通知您非页内广告活动。在每种广告事件回调方法中，您都会获得相应的广告展示位置的状态。

插件将通知监听者以下所有可能的事件：

OpenMediation.Ads.setListener({

    onSplashLoadSuccess: function (placementId) {
        // Invoked when Splash Ad load success
    },

    onSplashLoadFailed: function (placementId, msg) {
        // Invoked when Splash Ad load failed
    },

    onSplashShow: function (placementId) {
        // Invoked when Splash Ad has opened
    },

    onSplashShowFailed: function (placementId, msg) {
        // Invoked when Splash Ad has showed failed
    },

    onSplashClicked: function (placementId) {
        // Invoked when the user clicked on the Splash Ad
    },

    onSplashClosed: function (placementId) {
        // Invoked when the Splash Ad is closed
    },
});

 

步骤 2. 加载广告

要加载开屏广告，请调用以下方法：

OpenMediation.Ads.loadSplash(placementId);

 

步骤 3. 检查广告的可用性

开屏广告成功加载后，将通过 onSplashLoadSuccess 回调通知您何时可以显示广告，该通知将通知您广告资源的可用性。

检查广告是否可用的另一种方法是直接调用 isSplashAdReady 函数。

OpenMediation.Ads.splashAdIsReady(placementId);

 

步骤 4. 展示广告

强烈建议您在投放开屏广告之前，通过调用 splashAdIsReady 方法来检查广告的可用性

if (OpenMediation.Ads.splashAdIsReady(placementId)) {
    OpenMediation.Ads.showSplash(placementId);
}

提示：

启用本地日志记录：（仅用于本地调试，在上线之前将其删除。）

OpenMediation.Ads.debug(true);