关键词:
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错误码
- 错误码问题需要开发者先自查,如以下解释无法解决开发者疑问,则可以咨询对接同事或者通过工单进行反馈。
- 注意: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 图片加载异常 重新发起广告请求
解决穿山甲gromore广告在oppo上报广告病毒android.virus.adcheat.adcut.a(代码片段)
2022年12月13日20:49:54更新不是穿山甲sdk的问题,是游戏在Oppo上架需要接入oppo提供的广告sdk。因为oppo提供的广告sdk也包含了穿山甲的。当我本来只接入Gromore的游戏,再接入oppo的渠道sdk之后,会被oppo识别出修改了他们... 查看详情
解决穿山甲gromore广告在oppo上报广告病毒android.virus.adcheat.adcut.a(代码片段)
2022年12月13日20:49:54更新不是穿山甲sdk的问题,是游戏在Oppo上架需要接入oppo提供的广告sdk。因为oppo提供的广告sdk也包含了穿山甲的。当我本来只接入Gromore的游戏,再接入oppo的渠道sdk之后,会被oppo识别出修改了他们... 查看详情
如何在egretnative中接入穿山甲广告,为开发者营收添砖加瓦(代码片段)
...第三方原生SDK,本文将为开发者介绍如何接入广告系统。穿山甲是字节跳动提供的广告接入SDK,提供了多种广告样式,具体信息可以参见其官方文档。穿山甲平台准备进入穿山甲平台官网,完成注册登录,并按照平台要求完成应... 查看详情
lemonmob聚合广告sdk
无需上架,接入穿山甲广告和广点通广告sdk我们都知道广告是商业流量变现最重要的方式之一,所以基本所有的游戏或者app都会接入广告sdk,而我们都知道穿山甲广告sdk和广点通广告sdk是国内收益相对比较高的,但是想接入穿山... 查看详情
穿山甲广告sdk手动初始化解决方案(代码片段)
...p官方提出整改建议是,在用户同意隐私协议后在加载穿山甲的广告。研究了一下:2.大概思路是修改原本的UnionApplication.java脚本//手动加载初始化说明://将本脚本文件的内容替换到UnionApplication.java里面//然后将下面的代码... 查看详情
unity接入优量汇(广点通|腾讯广告)(代码片段)
Unity接入优量汇(广点通|腾讯广告)下载地址:https://adnet.qq.com/resource/sdk如上图所示,unity版本跟Android版本是同一天更新。(效率这么高的嘛?)但是下载之后,遇到各种问题。没有清单没有gradle。摸索了一... 查看详情
已开源flutter穿山甲广告插件的集成-flutterads(代码片段)
...ter广告插件,帮助开发者获利。本篇我们来看看Flutter穿山甲广告插件flutter_pangle_ads的集成和使用。移动端广告形式在移动端大体分为5种广告形式,分别是开屏、插屏、Banner、信息流、激励视频。随着短视频的崛起,... 查看详情
已开源flutter穿山甲广告插件的集成-flutterads(代码片段)
...ter广告插件,帮助开发者获利。本篇我们来看看Flutter穿山甲广告插件flutter_pangle_ads的集成和使用。移动端广告形式在移动端大体分为5种广告形式,分别是开屏、插屏、Banner、信息流、激励视频。随着短视频的崛起,... 查看详情
unity多平台原生sdk接入速览:qq互联(代码片段)
ZeroyiQ:Unity多平台原生SDK接入速览(一):微信开放平台ZeroyiQ:Unity多平台原生SDK接入速览(三):FacebookZeroyiQ:Unity多平台原生SDK接入速览(四):TwitterZeroyiQ:Unity多平台原生SDK接入速览(五):微博一、前言QQ互联,当前(2... 查看详情
flutter字节跳动穿山甲广告插件发布-flutterads(代码片段)
前言Flutter已成为目前最流行的跨平台框架之一,在近期的几个大版本的发布中都提到了Flutter版本Google广告插件[google_mobile_ads]。对于“出海”应用选择官方的插件非常稳定方便,对于国内的应用虽然我们的选择比较多ÿ... 查看详情
ios接入腾讯优量汇开屏广告教程(代码片段)
文章目录引言I、SDK部署1.1开屏广告Demo1.2SDK核心API1.3接入注意事项II、iOS14适配III、上架权限配置引言本文以对接开屏广告为例子https://developers.adnet.qq.com/doc/ios/union/union_splash广告类型接入方式简介适用场景版本备注开屏广告SDK原... 查看详情
flutter字节跳动穿山甲广告插件发布-flutterads(代码片段)
...(优量汇、广点通、游可赢)❌否字节跳动(穿山甲、GroMore)❌否百度(百青藤)❌否快手❌否SigmobAd❌否UnityAds❌否Mintegral❌否赋能集团✅是(由我提供技术支持)其他聚合平台❓未知需要支持Flu... 查看详情
flutter字节跳动穿山甲广告插件发布-flutterads(代码片段)
...(优量汇、广点通、游可赢)❌否字节跳动(穿山甲、GroMore)❌否百度(百青藤)❌否快手❌否SigmobAd❌否UnityAds❌否Mintegral❌否赋能集团✅是(由我提供技术支持)其他聚合平台❓未知需要支持Flu... 查看详情
unity接入多个sdk的通用接口开发与资源管理(代码片段)
接着上篇,介绍SDK资源的导入。首先介绍一下AndroidStudio工程。AS工程可以由多个Module组成,我们可以把某个Module作为我们打包的Module,其他的Module当做资源导入到主Module中。我们unity导出的Gradle工程(有一篇介绍了unity出Gradle工... 查看详情
flutter版聚合广告插件(代码片段)
Flutter版聚合广告插件flutter_universalad是一个聚合字节跳动穿山甲广告插件flutter_unionad、腾讯优量汇聚合广告flutter_tencentad插件,方便直接调用多个厂商广告,插件仓库。体验demo集成步骤1、pubspec.yamlflutter_universalad:^0.0.32、引入imp... 查看详情
unity实战篇|接入声网sdk实现音频通话——自己动手做一个语音聊天房(代码片段)
目录🐱🏍前言🎂Unity接入声网SDK实现音频通话第1️⃣步,创建声网应用第2️⃣步,获取相应的SDK第3️⃣步,将SDK接入Unity中第4️⃣步:搭建一个测试场景,编写测试代码第5️⃣步:音频通... 查看详情
unity接入firebase第三方登录(applefacebookgoogle)(代码片段)
目录一、Firebase接入1.SDK下载2.接入准备工作3.firebase初始化4.登录接入文档二、Google登录接入1.插件介绍2.初始化3.登录请求4.firebase登录验证三、FaceBook登录接入1.插件介绍2.接入设置3.初始化4.登录请求5.firebase登录验证四、Apple登录... 查看详情
unity--tradplus广告接入
usingAppAdvisory.Ads;usingcom.adjust.sdk;usingFacebook.Unity;usingFirebase.Analytics;usingSystem;usingUnityEngine;usingUnityEngine.Advertisements;usingUnityEngine.SceneManagement;publicclassAdsControl:Singleton<AdsControl> privatestringad_id_banner="123456"; //privatestringad... 查看详情