1. 获取日志
方式一: 通过手机中【文件管理】App,找到日志,拷贝出来。拷贝路径:
手机【文件管理】App > 内部存储 > Android > data > com.huawei.hwid > files > Log > HiAdKitLog.log
方式二: 手机连上电脑,通过 adb 命令把手机中的日志拉出来, “./”表示存放在当前路径。
adb pull /sdcard/Android/data/com.huawei.hwid/files/Log/HiAdKitLog.log ./
如果没有找 HiAdKitLog.log,那么需要确认一下 HMS Core 中是否允许写入日志,路径如下:
设置 > 应用 > 应用管理 > HMS Core > 权限 > 存储,设置为开启
2. 日志解读
很多时候由于种种原因无法展示广告,通过抓取的客户端日志,可以分析到一些信息,从而快速定位到问题,下面我们通过日志例子详细讲解。分析广告请求的消息体和响应信息。将关键字 HiAd 的日志过滤出来,尤其关注 request data 和 response data 的日志内容,如下所示:
request data 和 response data 的内容都是 JSON 格式,为了方便观看,可自行用工具格式化一下。
2.1 广告请求信息 request data 解读 {
"adRestrict":0, // 儿童保护,0表示不限制广告推送,1表示限制广告推送,-1表示未设置
"rtenv":0,
"appsdkversion":"13.4.39.300",
"app":{
"mediaGpsOn":0,
"name":"赛几探险记",
"pkgname":"com.igame.njmy.sjtxjrpk.huawei",
"version":"1.0.0"
},
"clientAdRequestId":"118302ea-b7e8-4157-8870-ad498c9ff676",
"device":{
"aaid":"******",
"adsLoc":0,
"agCountryCode":"CN",
"androidid":"******",
"brand":"HUAWEI",
"buildVersion":"WAS-AL00 8.0.0.358(C00)",
"clientTime":"2021-06-02 16:27:21.314+0800",
"dpi":480,
"emuiVer":"EmotionUI_8.0.0",
"freeDiskSize":41043329024,
"freeSdcardSize":41022357504,
"gpsOn":1,
"height":1920,
"hmsGpsOn":1,
"isTrackingEnabled":"******",
"language":"zh",
"localeCountry":"CN",
"maker":"HUAWEI",
"model":"WAS-AL00",
"oaid":"******",
"os":"android",
"pxratio":"3.0",
"roLocale":"ZH-HANS-CN",
"roLocaleCountry":"CN",
"routerCountry":"CN",
"script":"Hans",
"totalDiskSize":56478384128,
"totalSdcardSize":56457412608,
"type":4,
"udid":"******",
"useragent":"******",
"uuid":"******",
"vendor":"ALL",
"vendorCountry":"CN",
"verCodeOfAG":"110202302",
"verCodeOfHms":"50300312",
"verCodeOfHsf":"110002200",
"version":"8.0.0",
"width":1080
},
"multislot":[
{
"h":483, // 请求广告素材的高(像素)
"w":3240, // 请求广告素材的宽(像素)
"adtype":8, // 请求广告类型,8--Banner, 7--激励视频,3--原生,1--开屏,12--插屏
"bsrSet":1,
"height":1920, // 手机的屏幕高(像素)
"isSmart":0,
"slotid":"testw6vs28auh3", // 广告位ID
"test":0,
"width":1080 // 手机的屏幕宽(像素)
}
],
"network":{
"cellInfo":"******",
"type":2
},
"parentCtrlUser":-1,
"pdToOther":0,
"ppsStore":"******",
"reqPurpose":1,
"scrnReadStat":0,
"sdkversion":"3.4.41.303",
"version":"3.4"
}
2.2 广告请求响应信息 response data 解读
1)请求失败日志 {
"adPreloadInterval":0,
"cost":"6,4,0,4,0,0,1,4,1",
"dsp1cost":0,
"dspcost":0,
"multiad":[
{
"brsetting":"N",
"retcode30":204, // 响应码, 204表示请求成功,但没有广告返回。
"slotid":"testw6vs28auh3" // 广告位ID
}
],
"retcode":204,
"totalCacheSize":800
}
2)请求成功日志 {
"adPreloadInterval":0,
"cost":"93,83,0,49,4,0,0,49,1",
"dsp1cost":0,
"dspcost":0,
"multiad":[
{
"brsetting":"N",
"content":[
{
"clickActionList":[
3,
4,
1
],
"contentid":"34.100237265421",
"taskinfo":"TASKINFO_UNIQUE_2||mnO56RBXzu+EYW0CanS7vFlQgo+zK+R/Dzxz5q9ovCjPQqzEZunrF0QIvR1QvpUq6qVWZ3h6xsgibYNQ4NnUpAlDJBN9jjpHSMLW0ib9a4hEmm23dvplQSKAlZ/9DcXWmA1FMPSBBWG/kLX3tVLdfV4In2IiLLqu1NbL4iVZDA5r6NYxzBkFMKZ+9meU7NEWftxZ31b1VZMJgcx7pWF/kPpMA7Mi",
"creativetype":2,
"ctrlSwitchs":"100011101002100101",
"dispTime":0,
"endtime":1622622297764,
"filterList":[
3
],
"interactiontype":5,
"landPageWhiteList":"contentcenter-drcn.dbankcdn.com,lp.pinduoduo.com,h5hosting-drcn.dbankcdn.cn",
"landingTitle":0,
"logo2Pos":"ll",
"metaData":"******",
"monitor":"******",
"paramfromserver":"******", "sequence":0,
"showAppLogoFlag":1,
"skipTextPos":"tr",
"spare":0,
"starttime":1622532297764,
"taskid":"34.100237265421",
"useGaussianBlur":1,
"webConfig":"******"
}
],
"retcode30":200, // 响应码, 请求成功
"slotid":"f3tnev5vy6" // 广告位ID
}
],
"retcode":200,
"totalCacheSize":300
}
3. 日志分析
在请求数据中,可以通过 multislot 查询请求广告素材的宽高,广告类型,广告 id 来判断是否符合请求标准。
在返回数据中,可以通过 retcode30 查询返回结果。下列是常见返回错误码:
错误码取值含义1001api 版本不在广告支持范围内-1http 请求失败,非业务失败200请求成功201广告请求,先返回配置204 请求报文正确,没有广告返回 403广告请求的接口版本号错误407广告请求的 SDK 版本号缺失408广告请求的 SDK 版本号错误421广告位 ID 缺失424广告位 ID 与应用不匹配425该广告位 ID 不能请求正式广告498无效广告位,广告位与应用包名不匹配。499 其他错误 500系统内部错误602返回 已经失效的素材 id 列表700 原生广告未请求到,请查看日志 701原生广告未请求到,请查看日志702原生广告正在请求中,不能重复发起请求703快应用的广告位 id 非法704横幅广告过期705横幅广告任务下架800贴片广告未请求到,请查看日志801贴片广告正在请求中,不能重复发起请求802贴片广告的广告位 ID 列表为空804传入的参数格式非法900激励广告未请求到,请查看日志901激励广告正在请求中,不能重复发起请求902激励广告的广告位 ID 列表为空1000插屏广告未请求到,请查看日志4. 总结
上述日志中,国内快应用 Banner 广告只支持1080170广告尺寸。该示例传的是483 3240尺寸,不符合广告要求,所以 retcode30 返回204,请求成功,无返回。要修改 Banner 为 1080*170的 Banner 尺寸进行测试。所以我们拿到日志后在 request data 里主要分析 multislot 中广告素材相关的请求参数和 response data 中 retcode30 错误码来配合修改广告代码即可。