广告单元

开始之前

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

  • 在 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)
有关我们支持的标准 横幅尺寸的 详细信息,请参见下表:
BannerSize 描述 尺寸(WxH)
BANNER 横幅广告 320 x 50
LARGE IAB 中矩形 300 x 250
RECTANGLE IAB 页首横幅广告 728 x 90
SMART

智能横幅广告

(针对移动设备和平板电脑进行了调整)

iOS:
If(iPhone)320 x 50
If(iPad)728 x 90
Android:
If(屏幕高度≤720)320 x 50
If(屏幕高度> 720)728 x 90

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

BannerPosition 描述
TOP 视图将位于屏幕的顶部中心
BOTTOM 视图将位于屏幕的底部中心

您会收到 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);

 

这篇文章有帮助吗?
0 人中有 0 人觉得有帮助

评论

0 条评论

登录写评论。