Skip to main content

3、原生广告

一、简介#

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

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

二、集成步骤#

1、布局导入#

下载SDK的压缩包,解压后TradPlusSDK_Unity的文件夹里的res等导入到Assets文件中:

  • res:原生广告所需布局文件
  • 路径:res-->layout

2、代码示范#

部分代码示范

// 1、初始化广告位,广告位ID在TradPlus后台创建
TradPlus.LoadNativePluginsForAdUnits("AdUnitId");
// 2、加载广告 并设置弹出方式
TradPlus.CreateNative("AdUnitId",TradPlus.AdPosition.BottomCenter);
//3、释放广告
TradPlus.DestroyNative("AdUnitId");

三、API说明#

3.1 加载类API#

方法说明
TradPlus.LoadNativePluginsForAdUnits("AdUnitId");初始化广告位。AdUnitId广告位ID在TradPlus后台创建。仅初始化时调用一次。
TradPlus.SetAdSize("AdUnitId", width, height);V6.8.0新增API。设置广告源宽高,单位dp,一般设置宽320,高340。必须在加载广告前调用。
TradPlus.CreateNative("AdUnitId",TradPlus.AdPosition.BottomCenter);加载广告。设置广告弹出的地方。每次请求广告都需要调用。
TradPlus.CreateNative("AdUnitId", x, y);加载广告。设置广告弹出X 、Y。每次请求广告都需要调用。
TradPlus.ShowNative("AdUnitId",false);(可选)隐藏对应的广告。
TradPlus.ShowNative("AdUnitId",true);(可选)展示对应的广告(仅调用隐藏广告之后使用)。
TradPlus.DestroyNative("AdUnitId");释放资源。
TradPlus.NativeEntryAdScenario("AdUnitId");(可选)进入广告位所在界面时调用。了解更多,请看广告场景的调用时机和用途说明

3.2 监听回调API#

  • 广告位维度回调监听 V6.4.5新增API
方法参数说明
TradPlusManager.OnNativeAdLoadedstring tpAdInfo , string height广告加载成功。老版本API为TradPlusManager.OnAdNativeLoadedEvent
TradPlusManager.OnNativeAdLoadFailedstring adUnitId ,string errorMsg广告加载失败。老版本API为TradPlusManager.OnAdNativeFailedEvent
TradPlusManager.OnNativeAdClickedstring tpAdInfo广告被点击,老版本API为TradPlusManager.OnAdNativeClickedEvent
TradPlusManager.OnNativeAdImpressionstring tpAdInfo广告展示,老版本API为TradPlusManager.OnAdNativeExpandedEvent
TradPlusManager.OnNativeAdClosedstring tpAdInfo广告被关闭。
TradPlusManager.OnNativeAdShowFailedstring tpAdInfo ,string errorMsgV7.3.0新增API。广告展示失败。
  • 广告源维度回调监听 (可选) V6.4.5新增API
方法参数说明
TradPlusManager.OnNativeAdAllLoadedbool isSuccess,string adUnitId广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
TradPlusManager.OneNativeLayerLoadFailedstring tpAdInfo ,string errorMsg配置多个广告源,每个广告源加载失败后会都会回调一次。
TradPlusManager.OneNativeLayerLoadedstring tpAdInfo配置多个广告源,每个广告源加载成功后会都会回调一次。
~~TradPlusManager.OneNativeLayerStartLoad ~~string tpAdInfo请求广告后,广告开始加载。
V7.9.0 废弃
TradPlusManager.OneNativeLayerStartLoadstring tpAdInfo每层waterfall 向三方广告源发起请求前,触发的回调。
V7.9.0 新增回调
TradPlusManager.OnNativeAdStartLoadstring adUnitId每次调用load方法时返回的回调,包含自动加载等触发时机。
V7.9.0 新增回调
TradPlusManager.OnNativeBiddingStartstring tpAdInfoBidding开始加载。
TradPlusManager.OnNativeBiddingEndstring tpAdInfo ,string errorMsgBidding加载完成。
V7.3.0新增回调参数 errorMsg
  • 监听回调中的参数说明
参数说明
TPAdInfo广告位ID、三方广告平台、ecpm等信息,具体请参考回调信息说明
errorMsg广告请求失败、广告展示失败的错误信息,具体请参考错误码、错误信息说明