Skip to main content

标准原生

集成步骤#

布局导入#

Android布局#

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

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

iOS布局#

可参照iOS demo里的布局,结合自己的需求进行调整。

代码示范#

部分代码示范

// 1、初始化广告位,广告位ID在TradPlus后台创建
TradPlus.LoadNativePluginsForAdUnits("AdUnitId");
// 2、加载广告 并设置弹出方式
//android
TradPlus.CreateNative("AdUnitId",TradPlus.AdPosition.BottomCenter);
//iOS
//可传入原生广告的x,y坐标以及尺寸。
TradPlus.ShowNative("AdUnitId", 0,0,300,200);
//3、释放资源
TradPlus.DestroyNative("AdUnitId");

API说明#

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");(可选)进入广告位所在界面时调用。了解更多,请看广告场景的调用时机和用途说明

2.监听回调API#

  • 监听回调中的参数说明
参数说明
TPAdInfo广告位ID、三方广告平台、ecpm等信息,具体请参考回调信息说明
errorMsg广告请求失败、广告展示失败的错误信息,具体请参考错误码、错误信息说明
  • 广告位维度回调监听 V6.4.5新增API
  • 开发者可通过TradPlusManager调用
方法参数说明
OnNativeAdLoadedstring tpAdInfo , string height广告加载成功。老版本API为TradPlusManager.OnAdNativeLoadedEvent
OnNativeAdLoadFailedstring adUnitId ,string errorMsg广告加载失败。老版本API为TradPlusManager.OnAdNativeFailedEvent
OnNativeAdClickedstring tpAdInfo广告被点击,老版本API为TradPlusManager.OnAdNativeClickedEvent
OnNativeAdImpressionstring tpAdInfo广告展示,老版本API为TradPlusManager.OnAdNativeExpandedEvent
OnNativeAdClosedstring tpAdInfo广告被关闭。
OnNativeAdShowFailedstring tpAdInfo ,string errorMsgV7.3.0新增API。广告展示失败。
OnNativeAdVideoPlayStartstring tpAdInfo视频播放开始。部分广告平台支持。
Android V8.1.0.1新增
iOS V7.8.10新增
OnNativeAdVideoPlayEndstring tpAdInfo视频播放结束。部分广告平台支持。
Android V8.1.0.1新增
iOS V7.8.10新增
  • 广告源维度回调监听 (可选) V6.4.5新增API
方法参数说明
OnNativeAdAllLoadedbool isSuccess,string adUnitId广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
OneNativeLayerLoadFailedstring tpAdInfo ,string errorMsg配置多个广告源,每个广告源加载失败后会都会回调一次。
OneNativeLayerLoadedstring tpAdInfo配置多个广告源,每个广告源加载成功后会都会回调一次。
OneNativeLayerStartLoadstring tpAdInfo请求广告后,广告开始加载。
V7.9.0 废弃
OneNativeLayerStartLoadstring tpAdInfo每层waterfall 向三方广告源发起请求前,触发的回调。
V7.9.0 新增回调
OnNativeAdStartLoadstring adUnitId每次调用load方法时返回的回调。
V7.9.0 新增回调
OnNativeBiddingStartstring tpAdInfoBidding开始加载。
OnNativeBiddingEndstring tpAdInfo ,string errorMsgBidding加载完成。
V7.3.0新增回调参数 errorMsg
  • 下载监听(可选) 仅快手、穿山甲、广点通支持(Android V8.1.0.1)
方法参数说明
OnNativeDownloadStartstring tpAdInfo,
string networkinfo
开始下载回调。
TPAdInfo:广告的信息对象,具体请参考上文回调信息说明
开发者可通过解析 json“networkinfo”获得:
totalBytes:文件总大小(单位:字节)
currBytes:当前已下载的大小(单位:字节)
fileName:文件名
appName:文件对应的应用名称
OnNativeDownloadUpdatestring tpAdInfo,
string networkinfo
下载进度更新回调。
参数意义同上。
OnNativeDownloadPausestring tpAdInfo,
string networkinfo
暂停下载回调。
参数意义同上。
OnNativeDownloadFinishstring tpAdInfo,
string networkinfo
下载完成回调。
参数意义同上。
OnNativeDownloadFailstring tpAdInfo,
string networkinfo
下载失败回调。
参数意义同上。
OnNativeInstalledstring tpAdInfo,
string networkinfo
Apk安装完成回调。
参数意义同上。