Skip to main content

2、插屏广告

一、简介#

本文档主要介绍在Unity3D中如何集成 TradPlus SDK的插屏广告:

  • 支持AAndroid 16以上的应用;
  • 支持Unity 2018.4.0f1以上的版本;
  • 建议先注册TradPlus账户,并添加应用;
  • 初始化TradPlus SDK。

二、集成步骤#

部分代码示范

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

三、API说明#

3.1 加载类API#

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

2.5 监听回调#

  • Old API
方法说明
TradPlusManager.OnInterstitialShownEvent广告被展示。
TradPlusManager.OnInterstitialClickedEvent广告被点击。
TradPlusManager.OnInterstitialDismissedEvent广告被关闭。
TradPlusManager.OnInterstitialAllLoadedEvent广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
TradPlusManager.OnInterstitialFailedEvent配置多个广告源,每个广告源加载失败后会都会回调一次。
TradPlusManager.OnInterstitialLoadedEvent配置多个广告源,每个广告源加载成功后会都会回调一次。
  • V6.4.5 new API
方法说明
TradPlusManager.OnInterstitialAdLoadedV6.4.5新增API。广告加载成功。
TradPlusManager.OnInterstitialAdFailedV6.4.5新增API。广告加载失败。
TradPlusManager.OnInterstitialAdImpression广告展示。老版本API为TradPlusManager.OnInterstitialShownEvent
TradPlusManager.OnInterstitialAdClicked广告被点击。老版本API为TradPlusManager.OnInterstitialClickedEvent
TradPlusManager.OnInterstitialAdClosed广告被关闭。老版本API为TradPlusManager.OnInterstitialDismissedEvent
TradPlusManager.OnInterstitialAdAllLoaded(可选)广告位的状态。请求广告后,一次load()操作完毕后才会回調一次,可以用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。老版本API为TradPlusManager.OnInterstitialAllLoadedEvent
TradPlusManager.OneInterstitialLayerLoadFailed(可选)配置多个广告源,每个广告源加载失败后会都会回调一次。。老版本API为TradPlusManager.OnInterstitialFailedEvent
TradPlusManager.OneInterstitialLayerLoaded(可选)配置多个广告源,每个广告源加载成功后会都会回调一次。。老版本API为TradPlusManager.OnInterstitialLoadedEvent
TradPlusManager.OnInterstitialLoadAdStart(可选)V6.4.5新增API。请求广告后,广告开始加载。
TradPlusManager.OnInterstitialBiddingStart(可选)V6.4.5新增API。Bidding开始加载。
TradPlusManager.OnInterstitialBiddingEnd(可选)V6.4.5新增API。Bidding加载完成。

四、注意事项#

(1)广告位的添加#

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

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

  • 不使用自动加载模式:
    • 需在监听OnInterstitialAllLoadedEvent isLoadedSucces为false,重新加载广告。接入V645,可以在OnInterstitialAdAllLoaded为false或者 OnInterstitialAdFailed 时候重新加载广告。
    • 还需在OnInterstitialShownEventIsInterstialReady()为false时,重新加载。接入V645,可以在OnInterstitialAdImpression后重新加载广告。