Unity集成指南
概要
本文档描述了开发者如何集成Mintegral SDK产品,通过集成Mintegral sdk展示广告创造收益。 Mintegral SDK提供了6种广告形式,包括:Native(原生广告)、AppWall(广告墙)、Rewarded Video(激励性视频)、Interstitial(插屏)、Interstitial Video(插屏视频)、InterActive(试玩广告)。
获取SDK及Mintegral Unity Plugin
1、在Mintegral Android SDK集成文档中获取SDK下载链接,并根据该文档的说明添加所需要的SDK包及AndroidManifest,混淆规则等其他配置。
2、在Mintegral iOS SDK集成文档中获取SDK下载链接,并根据该文档的说明添加所需要的SDK包。 3、此处下载最新版本的Unity_Plugin,并将Unity Plugin中的文件全部导入到工程中。这里需要注意如果更新最新的plugin需要同时更新最新版本的SDK。 4、演示demo此处参考 demo仅供参考,更新较慢,demo中所依赖的双端SDK并非最新版本,请及时更新SDK
初始化MTGSDK
在程序的入口方法中调用MTGSDK的初始化方法,传入在M系统后台得到的AppID和AppKey。初始化时,MTGSDK会从服务器拉取配置信息。
Mintegral.initMTGSDK (MTGSDKAppID,MTGSDKAppKey);Mintegral GDPR版本新增接口说明
1、设置是否获取用户信息的开关,此方法也需要在SDK初始化之前调用。 1为允许,0为拒绝。
Mintegral.setConsentStatusInfoType(int GDPR_key);2、获取用户设置的开关状态。
Mintegral.getConsentStatusInfoType();CCPA 接口说明
设置是否获取用户信息的开关,调用此方法时,要保证已经调用了SDK初始化
横幅广告接入
横幅广告是在应用布局中占据一处位置的矩形图片文字广告。用户与应用互动时,这类广告会停留在屏幕上,并且可在一段时间后自动刷新。
广告位初始化
初始化MTGSDK,请参考MTGSDK的初始化部分
广告位的初始化
广告位的初始化 初始化时,需要传入对应的广告位的UnitId。
创建Banner
bannerAdPosition提供以下几种:
销毁Banner
相关的回调Event
原生广告接入
原生广告是时下非常流行的广告类型之一,广告sdk会将素材信息返回给您的app,您可以根据需要对元素进行组装和渲染,进而更贴近您的产品风格,用户体验更好
广告位初始化
初始化MTGSDK,请参考MTGSDK的初始化部分
广告位的初始化
初始化时,需要传入对应的广告位的 PlacementId 和 UnitId
注意: 1、目前Plugin暂不支持NativeVideo,所以在创建广告位时需要选择大图模式,No Video Ads的模式。 2、adCategory参数控制广告类型,如果对广告类型没有特殊要求,填MTGAD_CATEGORY_ALL(或者数字0)即可。 3、autoCacheImage参数控制是否自动缓存图片,仅针对iOS平台。
4、libMTGNativeAdBridge.a 文件增加 bitcode模式,可解决开发者采用这种方式打包问题,仅针对iOS平台。
预加载
加载
注册广告位(Android)
取消注册广告位(Android)
相关的回调Event
展示Native类型广告必须实现的代理。
激励视频接入
激励视频是Mintegral平台效果非常好的广告形式,用户可以通过观看一段广告视频而获取奖励,由于广告视频素材非常具有创意和吸引力,因此会引起很多用户的兴趣,进而下载广告产品
广告效果示意:
广告位初始化
初始化MTGSDK,请参考MTGSDK的初始化部分
初始化MTGRewarded Video
请求视频广告
请求视频广告,需传入对应广告位的PlacementID和UnitId。
展示视频广告
展示广告之前先判断广告是否已经下载成功,如果返回失败,则放弃这次视频展示机会。
RewardId激励信息里创建的奖励信息,UserId用于服务器端回调,如果是客户端回调可以不传
清除本地缓存
如有需要,可通过该方法清除本地缓存的视频文件。
相关的回调Event
配置AndroidManifest.xml
硬件加速
在application节点下修改"android:hardwareAccelerated"的属性值:
插屏图片广告接入
插屏图片广告会在屏幕上展示一条大图广告,用户可以通过关闭按钮来关闭广告。
注:MIntegral推出了全新的InterstitalVideo广告类型,相比普通Interstital广告会有更好的视觉效果和体验。
广告效果示意:
广告位初始化
初始化MTGSDK,请参考MTGSDK的初始化部分
广告位的初始化
初始化时,需要传入对应的广告位的 PlacementID 和 UnitId,还可以通过adCategory参数控制广告类型,如果对广告类型没有特殊要求,填MTGInterstitial_AD_CATEGORY_ALL(或者数字0)即可。
加载
展示
相关的回调Event
展示Interstitial类型广告必须实现的代理。
配置AndroidManifest.xml
插屏视频广告接入
插屏视频广告是插屏图片广告的升级版本,展示广告时会给用户展示一个全屏或半屏的视频,通过更有吸引力的视频提高用户的兴趣。
广告效果示意:
广告位初始化
初始化MTGSDK,请参考MTGSDK的初始化部分
广告位的初始化
初始化时,需要传入对应的广告位的 PlacementID 和 UnitId
加载
展示
自定义奖励弹窗的展示内容
最好在调用load之前调用API
IV奖励模式
在调用load之前调用API
MTGIVRewardMode如下所示:
相关的回调Event
展示Interstitial Video类型广告必须实现的代理。
配置Androidmanifest.xml文件
交互式广告接入
交互式广告是Mintegral推出的全新广告形态,通过该形式用户可以实际参与一个精心设计的交互广告(比如试玩一个游戏Demo),进而大大提升转化效果。当前广告内容以Playable为主。
广告效果示意:
广告位初始化
初始化MTGSDK,请参考MTGSDK的初始化部分
广告位的初始化
初始化时,需要传入对应的广告位的PlacementId 和 UnitId。
加载
展示
相关的回调Event
展示 InterActive类型广告必须实现的代理。
配置Androidmanifest.xml文件
常见问题
1、为什么广告第一次跳转很慢? 答:由于跳转过程中要跳好多次,所以第一次会比较慢,第二次有了点击缓存,会快很多。开发者可以在这个时间段设置Loadding对话框。
2、为什么有时候拉取不到广告? 答:请查看AppId、AppKey、UnitId、PlacementId等信息是否填写正确,之后查看后台单子没有投放、投放状态是否正确。
3、为什么offer中出现了两种语言? 答:由于根据ip等信息判断区域,所以会返回对应区域的语言。又由于英文是通用语言,所以offer中会出现英文和对应区域的语言。
4、墙中install now按钮的展示语言能否更换? 答:暂时只支持英文。
5、为什么有时候app下载不下来? 答:由于appstore网络问题或者apple账号可能不是vpn去的国家,导致app不能下载。
6、广告源下发数量有多少? 答:某个地区的广告源数量为各个广告主想要投放此地区广告的数量总和,当请求的广告数超出此数量时,下发的广告数量以此地区广告数量总数为准。
ChangeLog
版本号
ChangeLog
发布时间
4.0.0
基于Android12.1.51, iOS6.1.0, 实现多模板功能
2020.03.23
3.0.0
基于Android10.1.9,iOS5.8.4,实现banner。Android端AAR集成;
2019.12.23
2.4.4
基于Android9.12.0,IOS5.3.3,修复AndroidSDK内部参数更改匹配问题;
2019.07.19
2.4.3
基于Android9.11.0,iOS 5.3.3,针对激励视频、插屏视频新增视频播放完成回调和endcard展示成功回调;
2019.05.21
2.4.2
基于Android9.9.0 ,iOS5.0.0,新增InterActive的素材加载成功回调和试玩完成回调,libMTGNativeAdBridge.a 文件增加 bitcode 模式;
2019.03.21
2.4.1
基于Android 9.0.2 ,iOS 4.5.0,修复Android里面InterstitialVideo的侦听器方法名,增加IV和RV的onLoadSuccess方法;
2018.10.23
2.4.0
基于Android 9.0.0,iOS 4.3.0,增加InterActive广告,增加GDPR设置获取状态方法;
2018.08.23
2.3.0
替换mintegral包名. 支持InterstitialVideo
2018.07.03
2.2.0
基于Android 8.11.2 ,ios3.8.0,支持GDPR功能
2018.05.15
2.1.0
重构Mintegral UnityPlugin,支持Native类型广告
2018.02.06
2.0.0
重构Mintegral UnityPlugin(暂不支持Native类型广告)
2018.01.12
1.3.0
NativeAd 添加广告展示的回调:MTGNativeAdsUnity里的 "NativeAdImpressionWithType"
2017.11.20
1.2.6
修改了C# API,关于isReady的bug
2017.11.08
1.2.5
修改了C# API,以及Android的Bridge,支持Android RV多个广告位,基于v1.2.4修改
2017.10.30
1.2.4
修改Android的close(addReward)回调,也修改了ios的
2017.09.22
1.2.3
AndroidBridge 针对V8.3.1进行了修改,该版本只适用于v8.3.x
2017.09.16
1.2.2
修改了Mintegral_UnityAndroidBridge.jar,只适用于Android SDK 8.1.43及以上版本
2017.08.02
1.2.1
UnityPlugin-iOS未做修改,UnityPlugin-Android修改了Rewarded Video 的ShowViewInUnity方法,支持传入UserId
2017.07.13
1.2.0
去除了UnityPlugin里面的SDK,开发者获取到UnityPlugin后 需要手动加入当前稳定版本的SDK
2017.06.23
1.1.2
UnityPlugin-Android未做修改,UnityPlugin-iOS做为一系列优化
2017.02.15
1.1.1
优化了RewardWall(iOS) UnityPlugin1.1.1 支持MTGSDK-iOS 1.6.1、MTGSDK-Android 8.1.10
2017.02.15
1.1.0
提供Native,AppWall,RewardWall,OfferWall,Interstitial类型广告的Unity-Android插件
2017.01.11
1.0.0
提供Native,AppWall,RewardWall,OfferWall,Interstitial类型广告的Unity-iOS插件
2016.12.09
Last updated
Was this helpful?