Xinstall常见问题指南 从集成到数据分析的避坑手册

集成Xinstall后，数据统计出现偏差？短链接突然失效？分不清自然流量和推广流量？
本文汇总开发者最常踩的“十大深坑”，从技术配置到数据解读，手把手教你快速排查问题！

一、iOS篇

高频问题

1、关联域名(Associated Domains)配置错误

      原因：iOS包没有配置 Associated Domains 

      解决方案：可以根据一键拉起中苹果网站的配置和Xcode中的配置是否正确来解决。（我们提供了两个 Associated Domains，若您只配置了其中一个，我们会在上传包时对您进行提醒，建议两个都配置）

2、Bundle Identifier不能为通配证书

      原因：IPA打包时候用的是通用描述文件

      解决方案：让iOS技术人员重新用Xcode打包，正常导出即可

3、iOS无法获取自定义参数？

      解决方案：

（1）检查是否按照文档集成相关代码

（2）是否将集成好sdk 的ipa包上传到Xinstall (ios上传包是方便测试，上传第一个包后可以通过xcode安装的方式进行调试)

（3）测试时需要将已安装的App卸载，不能覆盖安装测试 （测试时可以使用Xinstall 控制中心提供测试网页测试- 在线测试）

二、Android篇

高频问题

1、应用在后台时，通过网页拉起应用无法正常获取到参数

      解决方案：检查对应activity的onNewIntent生命周期方法内是否添加了唤醒参数获取方法。如果未添加，会导致应用存在后台时，网页拉起应用后无法正常获取到唤醒参数 （Android在app未在后台的情况下，网页直接唤醒打开后，唤醒Activity被杀掉后，应用退回到后台，进入浏览器后不刷新，网页再次点击按钮尝试唤醒，部分浏览器会出现仅将app从后台切换到前台，并不会再次唤醒对应Activity，而且该情况下，切换到前台时的Activity中未能在各个生命周期中获取到唤醒的intent信息。 经过验证，该现象为浏览器的机制，和是否使用 XInstall sdk无关。 【测试：当app仅为一个Activity构成时，即MainActivity为唤醒Activity，按照上述流程不杀掉Activity的情况下切换到后台，再次唤醒，不会触发onCreat、onNewIntent生命周期，但是会触发onResume生命周期，此时可以获取到唤醒的intent信息】 存在上述现象的浏览器：华为系统浏览器、QQ浏览器、uc浏览器、欧朋浏览器、搜狗浏览器等 每次都会重新唤醒scheme标签对应的activity的浏览器：小米系统浏览器、google浏览器、三星浏览器、360浏览器等）

2、一键拉起/唤起App失败

      解决方案：

90%以上的唤起失败问题，可以通过下面方式排查快速解决

• 在集成SDK以后，原来手机上的App需要重新卸载后再次安装才能唤起成功

• 是否是模拟器，暂不支持模拟器一键拉起，请用真机测试

• SDK是否集成成功，可以先在Android-集成-上传安装包底部选择测试，用Xinstall页面进行测试，如果这个页面也不能跳转，说明安卓SDK没有对接成功。如果能跳转，而自己页面不能跳转，说明自己页面的Web SDK集成不对，需要排查下。主要是scheme配置正确

• 浏览器首次拒绝导致无法跳转。部分浏览器，如果你在首次跳转时候选择了取消，那么下次点击唤起时候，浏览器将默认不再提示跳转。可以尝试恢复出厂设置，和清楚缓存来解决这个问题。如Via,小米手机自带浏览器，夸克浏览器

• 浏览器本身不允许跳转，如百度浏览器。

• QQ/微信中限制，需要满足上架条件，微信需要上架应用宝，QQ需要上架应用包或本地应用市场，如华为手机就需要上架华为市场。见下图

三、WEB篇

高频问题

1、为什么没有获取到自己的参数

      解决方案：没有获取到参数有很多原因，WEB 端的话请确认 appkey 是否和应用的 appkkey 一致。定义的按钮ID是否和dom里的一致，然后确认是否正常调用了 wakeupOrInstall 方法。

2、一键拉起失效？

      原因：

当App 配置正常，使用Universal Link 形式去唤醒App，但却失效的情况下。大致原因有两个：

1. 本地浏览器缓存原因，导致无法唤醒。解决方案是清楚浏览器缓存。一般再次点击按钮唤起就可以了。
2. 如果浏览器缓存无法唤起的话，在其他都是正常的情况加，一般是苹果服务器的缓存原因，一般这台设备只能第二天再尝试，才能唤起。