问题排查方法

1、无法获取到“自定义参数/渠道编号参数(App传参安装)”

(1)检查当前应用版本是否为“高级版”,如果不是需要在【基本信息】中切换至“高级版”再进行测试(初级版不支持App传参安装功能)。
(2)测试自定义参数时,建议使用上传安装包界面中右上角的【在线测试】网页(不要选择安装包右侧的【测试】网页)进行测试,方便快速排查问题。
(3)若【在线测试】网页可以正常获取到自定义参数,但是使用自行开发的网页测试无法获取到,可根据本页面第3项【Web集成排查方法】排查,同时确保自行开发的网页链接是使用的HTTPS(若使用HTTP网页会存在iOS部分系统设备存在无法参数还原的问题)。
(4)若【在线测试】网页也无法正常获取到自定义参数,则需按照App集成文档排查是否严格按照文档集成(重点检查Appkey、初始化方法)。检查App的包名(Applicationid/Bundle Identifier)是否和控制台配置的一致。测试同时也可以通过开发工具输出日志来判断。使用开发工具本地运行项目,同时过滤“OpenInstall”字段,检查SDK是否有打印错误日志(方便查看AppKey、初始化调用等相关问题)。
(5)测试流程请严格遵守,测试流程可参考【常见问题】-【测试方法】。
(6)“自定义参数”和“渠道编号参数”属于两种类型的参数,只有当App通过渠道链接下载安装打开时才会返回“渠道编号参数”(网页端提交的渠道编号参数key为channelCode,此key专用于渠道统计功能),其他key的键值对参数均属于自定义参数。
注:测试过程中最好不要使用网络代理,避免影响SDK请求,也不要使用模拟器测试。尽可能保证SDK为官网最新版本,以便于获得更稳定、优化度更好的方案。

2、网页无法正常打开App或无法获取到唤醒参数(一键拉起)

(1)测试一键拉起时,建议使用上传安装包界面中右上角的【在线测试】网页(不要选择安装包右侧的【测试】网页)进行测试,方便快速排查问题。
(2)若【在线测试】网页可以打开App且能获取到自定义参数,但是使用自行开发的网页测试无法正常打开App且无法获取到,可根据本页面第3项【Web集成排查方法】排查。
(3)若【在线测试】网页依旧无法打开App且无法获取到自定义参数,则需按照文档检查一键拉起配置(scheme、Universal Link)是否集成正确。
注:iOS需要额外检查App的Bundle Identifier和Team Id是否和控制台配置的一致。
(4)若网页能正常打开App,但是一键拉起回调方法无法正常进入。
先检查网页端是否传递了参数,若无参数传递OpenInstall一键拉起回调也不会执行。
其次检查一键拉起相关的代码。
Android
一键拉起获取参数方法须配置在scheme标签所在的Activity中,而且须在onCreat、onNewIntent生命周期中都加入。
iOS 一键拉起回调方法需配置在AppDelegate中,而且需要在AppDelegate中将系统提供的通用链接(Universal Link)回调方法、scheme回调方法加入OpenInstall需要执行的委托处理代码。
(5)iOS如果需要在微信中直接打开App,需要在【iOS下载配置】中选择【AppStore或其他】下载方式,其他下载方式不支持微信中直接打开App(Safar中不影响)。
注:部分浏览器存在对scheme或Universal Link的白名单限制或不支持,从而会导致无法正常打开App,属于正常现象。部分浏览器存在打开App时的弹窗确认选项,如果用户选择不打开或者拒绝也可能会导致后续会无法正常唤醒App(需要清除该浏览器的缓存数据后才能恢复)。

3、Web集成排查方法(H5网页集成问题)

(1)JavaScript集成和App banner集成二选一即可,不要在同一个网页中存在两种集成方式。
(2)当选择JavaScript集成时,需要严格按照文档加入所需要的代码(未注释的代码为必须加入,也可以参考【集成传参教程】中的DEMO示例文件)。
(3)当选择JavaScript集成时,初始化需要在网页进入加载时执行,唤醒/下载API(m.wakeupOrInstall();)需要绑定按钮点击事件让用户真实点击触发执行,不能伪点击触发、延时或自动触发执行,否则会导致App传参安装功能精度降低(SDK会使用到粘贴板辅助提升参数还原精度)和一键拉起功能失效。
(4)【Web集成】仅为H5下载页所使用的SDK而非App SDK,不可用于JavaScript语言所开发的App。
注:因不同品牌机型、不同版本的浏览器机制原因,部分浏览器会存在粘贴板写入的申请弹窗。如果用户未点击确认或点击拒绝也会导致粘贴板写入失败,也会在一定程度上影响参数还原的精度。

4、广告渠道/ASA渠道无法联调成功

(1)检查App是否额外加入了【广告平台对接文档】或【Apple Search Ads (ASA)】相关配置、代码,若未加入则需加入。
(2)检查【Android应用配置】、【iOS应用配置】中的【广告平台对接】是否已经开启,若未开启则需开启。
(3)检查【广告统计】-【广告渠道管理】界面中的“是否开启渠道绑定”开关是否已经关闭,若开启则需关闭后测试。
(4)检查创建的广告平台渠道是否和调试的广告平台一致,其次检查创建渠道时所需配置的参数(广告平台账号分配的key、id一类)是否一致。
(5)检查联调时配置的监测链接是否正确。
(6)检查联调时是否遵循广告平台的联调流程。
注:若测试广告平台渠道时,设备拒绝了“设备标识符”的获取或者SDK尝试获取“设备标识符”失败,OpenInstall会根据其他信息(ip、ua等)进行模糊匹配,从而会一定概率的出现匹配失败。

5、渠道统计功能测试时【渠道报表】中对应的数据没有增加

访问量:渠道链接网页未正常初始化成功。
点击量:渠道链接网页未正常触发执行对应的API(m.wakeupOrInstall();或m.install();)。
安装量:App未正确获取到对应的渠道编号参数,或未能初始化成功。
注册量:App未调用App集成文档中提供的【注册量统计】方法导致。
留存数:SDK自动上报,无需开发者额外调用,如无数据可能是App留存时长未达到对应的标准。
效果点统计:需要App通过渠道链接下载安装启动后触发对应的效果点统计方法才能计入。
注:除了访问量(曝光)、点击量属于H5网页上报,其他统计数据均属于App上报。当App在模拟器中运行时,OpenInstall App SDK会过滤掉数据上报行为,因此禁止使用模拟器测试统计功能(App传参安装功能不影响)。