Unity接入穿山甲广告SDK

Posted 2022-01-06 该吃药了哈

Unity接入穿山甲广告SDK

下载安装穿山甲SDK下载

导入项目
在 Unity 编辑器中打开您的项目，选择Pangle->Mange SDKs->Upgrade进行版本升级即可，详见截图

从unity4100版本开始，通过Upgrade进行版本升级后，需点击Delete old files按钮，完成自动更新SDK

配置app id

android

打开Pangle.cs（在PangleAdapterScripts\\Scripts\\Android文件夹下)如下图所示

ios

将上图示例代码中测试appID更换为实际项目的appID

初始化
参考示例Example.cs中的

Pangle.InitializeSDK(callbackmethod);

根据示例加载广告，播放广告如下图所示，替换对应的广告位ID即可调用。

遇到40029问题，导致广告填充率不足10%。
注意模板渲染需要调用setExpressViewAcceptedSize方法。

SDK错误码

1. 错误码问题需要开发者先自查，如以下解释无法解决开发者疑问，则可以咨询对接同事或者通过工单进行反馈。
2. 注意：40013、40016、40018、40019、40021、20001错误码问题,若需要穿山甲同事辅助排查,则需要提供抓包数据,抓包地址：:https://(ip地址或域名)/api/ad/union/sdk/get_ads/ ,提供抓包的请求和返回信息进行问题的定位

错误码	说明	排查方向	
20001	没有合适的广告返回而导致的请求没有填充,偶现属于正常情况	可以尝试更换设备进行验证。若不能解决,请先检查一下广告尺寸是否填写正确,是否有使用模拟器测试广告,单个设备是否一天请求了大量广告但没有展示或者展示率极低等。以上均不满足可以联系穿山甲对接同学或者提交工单（包含代码位和出现概率以及请求时间）,相关同学查明后会做出回复。必现场景可以通过抓包确认更具体原因:抓包地址:https://(ip地址或域名)/api/ad/union/sdk/get_ads/ 返回结果:"request_id": "xxxx", "status_code": 20001, "reason": 112 若reason=112,则需要开发者提升展示率和cpm。若reason=106,则说明没有填充是因为设置了target导致的填充不足。其他原因请通过工单反馈或者微信群进行反馈。2500以上版本只过滤get_ads即可,DNS预解析会导致请求ip	
40004	广告位不能为空	检查设置的代码位位ID是否为空	
40005	广告位尺寸不能为空	检查设置的请求尺寸	
40006	广告位ID不合法	代码位ID长度不对,或者传了空字符串。新创建代码位需要等2~3分钟才可生效	
40007	广告数量错误	检查设置的广告请求条数	
40008	图片尺寸错误	检查传入的请求广告尺寸	
40009	媒体ID不合法	检查设置的应用ID	
40013	非开屏广告请求方法使用了开屏代码位ID	检查请求广告使用的代码位ID是否正确,开屏代码位ID为8开头的九位数字	
40016	代码位ID与应用ID不匹配或者应用ID缺失	开发者重点检查下发或者设置的应用ID或者代码位ID,保证应用ID与代码位ID匹配,且传入的正确。保证在广告请求之前SDK初始化完成,且应用ID设置正确	
40018	平台上录入的包名与项目里的包名不一致	发出广告请求的包名和在平台上创建应用时填写的包名不匹配,需要检查发出广告的应用的包名	
40019	广告请求方法与代码位类型不匹配	例如平台上创建开屏代码位,但是代码中调用的接口是Banner或者其他非开屏的广告类型。可参考穿山甲的集成文档或Demo进行方法确认	
40020	开放注册新上线广告位超出日请求量限制	平稳放量,会逐渐放开限制	
40021	apk签名SHA1值与媒体平台录入的SHA1不一致	发出广告请求应用的SHA1值和在平台上创建应用时填写的SHA1值不匹配。SHA1获取方法:https://partner.oceanengine.com/doc?id=5dd385aa61886b0012ed8a98	
40022	广告请求方法与代码位渲染方式不一致	Banner和插屏广告,穿山甲平台目前仅支持模板渲染和自渲染两种方式,非原生Banner、插屏广告请求方法已经废弃。开发者创建了自渲染或者模板渲染的代码位,而使用了非原生Banner、插屏的广告请求方法,会出现此错误。需要开发者调整广告请求方法	
40024	SDK版本过低不返回广告	请升级到平台最新版本SDK	
40025	渲染异常	1.Android:SDK版本使用不正确,媒体使用了非该应用所属账号下的SDK版本导致,请到该代码位所属账号下工具-文档下载展示的SDK版本去进行接入
2.iOS:媒体使用2100之前的版本可能渲染异常,请更新到最新版本接入即可解决该问题
3.检查测试机的时区
4.390x以上版本默认只支持armeabi-v7a,arm64-v8a架构，非支持的架构，会触发报40025
5.参考集成文档，检查一下混淆规则	
40026	海外ip请求中国服务器导致	请确认发出广告请求设备ip的所属国家,非全球化开发者只能在国内请求广告	
40029	模板渲染类型广告的请求方法或请求参数不正确	三种情况: 1. SDK版本低:使用的SDK版本过低,还不支持个性化模板渲染功能。解决办法:升级到平台最新版本SDK。 2. 服务端代码位配置未生效：新建代码位需要等2~3分钟再去请求广告。 3. 接口使用错误；创建的代码位类型是模板渲染,但是请求方法是非模板渲染的方法或者模板广告的请求方法中缺少setExpressViewAcceptedSize参数。解决办法:使用模板渲染的方法和正确的参数去请求模板渲染类型的广告。参考文档:https://partner.oceanengine.com/doc?id=5ecc8a5bec6540000eabbad2	
40034	sdk_bidding_type 校验失败	代码位非服务端竞价,请检查代码位竞价类型	
40042	新插屏广告使用SDK版本过低	升级SDK版本到3550及以上版本	
50001	服务器错误	出现频率过大请反馈给穿山甲对接人员	
60007	激励视频验证服务器异常或处理失败	激励视频使用服务端验证方式可能会出现此问题。一般由服务异常或者超时问题导致,建议多尝试几次	
-1	数据解析失败	客户端代码问题的合集,可先排查以下情况: 1:在子线程调用了show。 2:注册点击事件时viewgroup传空。 3:媒体在onFeedLoaded回调里的业务逻辑发生了异常,导致SDK走到了onError回调中。 排查以上问题依然没有结论可以联系技术支持同学或者提交工单（包含代码位和出现概率以及请求时间）	
-2	网络错误	检查网络连接或者查看是否设置了代理	
-3	解析数据没有ad	需要重新请求广告	
-4	返回数据缺少必要字段	需要重新请求广告	
-5	BannerAd加载图片失败	需要重新请求广告	
-6	插屏广告图片加载失败	需要重新请求广告	
-7	开屏广告图片加载失败	需要重新请求广告	
-8	频繁请求	客户端控制广告请求的频率	
-10	缓存解析失败	需要重新请求广告	
-11	缓存过期	需要重新请求广告	
-12	缓存中没有开屏广告	需要重新请求广告	
101	渲染结果数据解析失败	建议升级到穿山甲2955及以上版本SDK	
102	未匹配到主模板	主模板没有下载到本地导致,偶发在首次请求广告时,偶现属于正常情况,出现之后请多尝试多次请求。建议升级到穿山甲2955及以上版本SDK	
103	未匹配到子模板	偶发在接入初期,没有匹配到模板导致。待SDK将模板下载成功后不会出现,出现之后请多尝试多次请求。建议升级到穿山甲2955及以上版本SDK	
107	模板渲染超时未回调	网络原因或者硬件原因导致渲染失败,可以更换手机或者网络环境测试。建议升级到穿山甲2955及以上版本SDK	
108	模板广告加载超时无返回	建议升级到穿山甲2955及以上版本SDK	
109	模板加载失败	建议升级到穿山甲2955及以上版本SDK	
113	原生动态化1.0 JS 解析出错	重新发起广告请求	
117	原生动态化1.0 JS 解析超时	重新发起广告请求	
118	原生动态化1.0 渲染错误	重新发起广告请求	
123	原生动态化2.0 SDK解析出错	重新发起广告请求	
127	原生动态化2.0 SDK解析超时	重新发起广告请求	
128	原生动态化2.0 SDK渲染出错	重新发起广告请求	
601	链接建立失败	检查网络并重新发起广告请求	
602	链接建立超时	检查网络并重新发起广告请求	
603	广告返回异常	重新发起广告请求	
604	广告解析失败	重新发起广告请求	
605	广告解析失败	重新发起广告请求	
606	广告解析异常	重新发起广告请求	
607	广告读写失败	重新发起广告请求	
608	广告读写失败	重新发起广告请求	
609	广告下载失败	重新发起广告请求	
610	广告下载异常	重新发起广告请求	
611	广告请求被取消	重新发起广告请求	
612	图片加载异常	重新发起广告请求