标准原生
集成步骤
布局导入
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调用
方法 | 参数 | 说明 |
---|---|---|
OnNativeAdLoaded | string tpAdInfo , string height | 广告加载成功。老版本API为TradPlusManager.OnAdNativeLoadedEvent 。 |
OnNativeAdLoadFailed | string adUnitId ,string errorMsg | 广告加载失败。老版本API为TradPlusManager.OnAdNativeFailedEvent 。 |
OnNativeAdClicked | string tpAdInfo | 广告被点击,老版本API为TradPlusManager.OnAdNativeClickedEvent 。 |
OnNativeAdImpression | string tpAdInfo | 广告展示,老版本API为TradPlusManager.OnAdNativeExpandedEvent 。 |
OnNativeAdClosed | string tpAdInfo | 广告被关闭。 |
OnNativeAdShowFailed | string tpAdInfo ,string errorMsg | V7.3.0新增API。广告展示失败。 |
OnNativeAdVideoPlayStart | string tpAdInfo | 视频播放开始。部分广告平台支持。 Android V8.1.0.1新增 iOS V7.8.10新增 |
OnNativeAdVideoPlayEnd | string tpAdInfo | 视频播放结束。部分广告平台支持。 Android V8.1.0.1新增 iOS V7.8.10新增 |
- 广告源维度回调监听 (可选) V6.4.5新增API
方法 | 参数 | 说明 |
---|---|---|
OnNativeAdAllLoaded | bool isSuccess,string adUnitId | 广告位的状态。loadAd() 完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。 |
OneNativeLayerLoadFailed | string tpAdInfo ,string errorMsg | 配置多个广告源,每个广告源加载失败后会都会回调一次。 |
OneNativeLayerLoaded | string tpAdInfo | 配置多个广告源,每个广告源加载成功后会都会回调一次。 |
string tpAdInfo | 请求广告后,广告开始加载。 V7.9.0 废弃。 | |
OneNativeLayerStartLoad | string tpAdInfo | 每层waterfall 向三方广告源发起请求前,触发的回调。 V7.9.0 新增回调。 |
OnNativeAdStartLoad | string adUnitId | 每次调用load方法时返回的回调。 V7.9.0 新增回调。 |
OnNativeBiddingStart | string tpAdInfo | Bidding开始加载。 |
OnNativeBiddingEnd | string tpAdInfo ,string errorMsg | Bidding加载完成。 V7.3.0新增回调参数 errorMsg。 |
- 下载监听(可选) 仅快手、穿山甲、广点通支持(Android V8.1.0.1)
方法 | 参数 | 说明 |
---|---|---|
OnNativeDownloadStart | string tpAdInfo, string networkinfo | 开始下载回调。 TPAdInfo:广告的信息对象,具体请参考上文回调信息说明 开发者可通过解析 json“networkinfo”获得: totalBytes:文件总大小(单位:字节) currBytes:当前已下载的大小(单位:字节) fileName:文件名 appName:文件对应的应用名称 |
OnNativeDownloadUpdate | string tpAdInfo, string networkinfo | 下载进度更新回调。 参数意义同上。 |
OnNativeDownloadPause | string tpAdInfo, string networkinfo | 暂停下载回调。 参数意义同上。 |
OnNativeDownloadFinish | string tpAdInfo, string networkinfo | 下载完成回调。 参数意义同上。 |
OnNativeDownloadFail | string tpAdInfo, string networkinfo | 下载失败回调。 参数意义同上。 |
OnNativeInstalled | string tpAdInfo, string networkinfo | Apk安装完成回调。 参数意义同上。 |