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#

  • Old API
方法说明
TradPlusManager.OnAdNativeExpandedEvent广告被展示。
TradPlusManager.OnAdNativeClickedEvent广告被点击。
TradPlusManager.OnAdNativeFailedEvent请求广告后,在所有广告源请求失败的情况下才会回調一次
TradPlusManager.OnAdNativeLoadedEvent请求广告后,加载成功只会回調一次
  • V6.4.5 new API
方法说明
TradPlusManager.OnNativeAdLoaded广告加载成功。老版本API为TradPlusManager.OnAdNativeLoadedEvent
TradPlusManager.OnNativeAdLoadFailed广告加载失败。老版本API为TradPlusManager.OnAdNativeFailedEvent
TradPlusManager.OnNativeAdClicked广告被点击,老版本API为TradPlusManager.OnAdNativeClickedEvent
TradPlusManager.OnNativeAdImpression广告展示,老版本API为TradPlusManager.OnAdNativeExpandedEvent
TradPlusManager.OnNativeAdClosedV6.4.5新增API。广告被关闭。
TradPlusManager.OnNativeAdAllLoadedV6.4.5新增API。广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
TradPlusManager.OneNativeLayerLoadFailedV6.4.5新增API。配置多个广告源,每个广告源加载失败后会都会回调一次。
TradPlusManager.OneNativeLayerLoadedV6.4.5新增API。配置多个广告源,每个广告源加载成功后会都会回调一次。
TradPlusManager.OnNativeBiddingStartV6.4.5新增API。Bidding开始加载。
TradPlusManager.OnNativeBiddingEndV6.4.5新增API。Bidding加载完成。