Skip to main content

1、激励视频

一、简介#

本文档主要介绍在Unity3D中如何集成 TradPlus SDK的激励视频广告:

  • 支持Android 16以上的应用;
  • 支持Unity 2018.4.0f1以上的版本;
  • 针对v6.x版本的集成;
  • 建议先注册TradPlus账户,并添加应用;
  • 初始化TradPlus SDK。

二、集成步骤#

部分代码示范

// 1、初始化广告位,广告位ID在TradPlus后台创建
TradPlus.LoadRewardedVideoPluginsForAdUnits("AdUnitId");
// 2、加载广告,传true设置自动加载模式
TradPlus.RequestRewardedVideo("AdUnitId",true);
// 3、判断是否有可用广告
if (TradPlus.HasRewardedVideo("AdUnitId"))
{
// 4、展示
TradPlus.ShowRewardedVideo("AdUnitId");
}

三、API说明#

3.1 加载类API#

方法说明
TradPlus.LoadRewardedVideoPluginsForAdUnits("AdUnitId");初始化广告位。AdUnitId广告位ID在TradPlus后台创建。仅初始化时调用一次。
TradPlus.RequestRewardedVideo("AdUnitId");加载广告。
TradPlus.RequestRewardedVideo("AdUnitId",true);(推荐使用)加载广告并设置自动加载模式。该模式会在展示广告后等几个地方重新请求广告。了解更多,请看自动加载功能
TradPlus.HasRewardedVideo("AdUnitId");检查是否有可用广告。自动加载模式下,HasRewardedVideo()false会自动加载广告。
TradPlus.ShowRewardedVideo("AdUnitId");展示广告。自动加载模式下,有可用广告直接展示。没有会自动加载。
TradPlus.ShowRewardedVideo("AdUnitId","sceneId");(可选)展示广告并设置广告场景ID。使用该方法必须调用TradPlus.RewardedVideoEntryAdScenario("AdUnitId","sceneId")。自动加载模式下,有可用广告直接展示。没有会自动加载。
TradPlus.RewardedVideoEntryAdScenario("AdUnitId");(可选)进入广告位所在界面时调用。
TradPlus.RewardedVideoEntryAdScenario("AdUnitId","sceneId");(可选)进入广告位所在界面时调用,并传入sceneId广告场景ID。sceneId广告场景ID,TradPlus后台创建。了解更多,请看广告场景的调用时机和用途说明

3.2 监听回调API#

  • Old API
方法说明
TradPlusManager.OnRewardedVideoShownEvent广告被展示。
TradPlusManager.OnRewardedVideoClickedEvent广告被点击。
TradPlusManager.OnRewardedVideoDismissedEvent广告被关闭。
TradPlusManager.OnRewardedVideoReceivedRewardEvent广告奖励回调。
TradPlusManager.OnRewardedVideoAllLoadedEvent广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
TradPlusManager.OnRewardedVideoFailedEvent配置多个广告源,每个广告源加载失败后会都会回调一次。
TradPlusManager.OnRewardedVideoLoadedEvent配置多个广告源,每个广告源加载成功后会都会回调一次。
  • V6.4.5 new API
方法说明
TradPlusManager.OnRewardedVideoAdLoadedV6.4.5新增API。广告加载成功。
TradPlusManager.OnRewardedVideoAdFailedV6.4.5新增API。广告加载失败。
TradPlusManager.OnRewardedVideoAdImpression广告被展示,老版本API为 TradPlusManager.OnRewardedVideoShownEvent
TradPlusManager.OnRewardedVideoAdClicked广告被点击,老版本API为 TradPlusManager.OnRewardedVideoClickedEvent
TradPlusManager.OnRewardedVideoAdClosed广告被关闭,老版本API为TradPlusManager.OnRewardedVideoDismissedEvent
TradPlusManager.OnRewardedVideoAdReward广告奖励回调,老版本API为TradPlusManager.OnRewardedVideoReceivedRewardEvent
TradPlusManager.OnRewardedVideoAdVideoErrorV6.4.5新增API。广告播放失败。
TradPlusManager.OnRewardedVideoAdAllLoaded(可选)广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。老版本API为TradPlusManager.OnRewardedVideoAllLoadedEvent
TradPlusManager.OneRewardedVideoLayerLoadFailed(可选)配置多个广告源,每个广告源加载失败后会都会回调一次。老版本API为TradPlusManager.OnRewardedVideoFailedEvent
TradPlusManager.OneRewardedVideoLayerLoaded(可选)配置多个广告源,每个广告源加载成功后会都会回调一次。老版本API为TradPlusManager.OnRewardedVideoLoadedEvent
TradPlusManager.OnRewardedVideoLoadAdStart(可选)V6.4.5新增API。请求广告后,广告开始加载。
TradPlusManager.OnRewardedVideoBiddingStart(可选)V6.4.5新增API。Bidding开始加载。
TradPlusManager.OnRewardedVideoBiddingEnd(可选)V6.4.5新增API。Bidding加载完成。

四、注意事项#

(1)广告位的添加#

  • 1、广告位类型必须正确;
  • 2、广告位ID的复制粘贴不能有空格;
  • 3、只需要添加对应的ID,三方的广告位ID无需添加到代码中

(2)重新加载广告的时机#

  • 不使用自动加载模式:
    • 需在监听OnRewardedVideoAllLoadedEvent isLoadedSucces为false,重新加载广告。接入V645,可以在OnRewardedVideoAdAllLoaded为false或者 OnRewardedVideoAdFailed 时候重新加载广告。
    • 还需在OnRewardedVideoShownEventHasRewardedVideo()为false时,重新加载。接入V645,可以在OnRewardedVideoAdImpression后重新加载广告。