跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

[IAZ002]iOS获取不到安装参数

本文档介绍了U-Link iOS端获取不到安装参数的解决办法,Android端获取不到参数请看此文档

问题现象:调取iOS端的getInstallParams新安装参数接口时没有获取到安装参数

排查方式:

1.首先确认先打开H5页面点击按钮,然后再安装的App。如果是主动去应用市场下载App,那么是不会获取到任何参数的。

2.打开H5页面,卸载重装App,App首次启动时进行抓包,看是否有https://deeplink.umeng.com/deeplink/match接口上报,此接口表明App调取了新安装参数接口

如果没有此接口原因可能是:(1)首次安装启动时没有网络权限,重新启动有网会再次请求 (2)集成失败,请重新查看接入指南文档

匹配接口

3.如果抓包到了此接口,请查看接口返回的wakeupurl和installParams是否均没有值,只要wakeupUrl有值就说明匹配成功了

返回参数

installParams:是开发者在U-Link后台裂变营销页创建活动时填写的固定【首次安装传参】参数,如果没有填写这里就会返回空,动态参数不是在这里返回的,

image.png

wakeupUrl:服务端拼接的wakeupurl,如果是Universal link拉起方式,格式大致是“(Universal link的域名)/(App跳转path)?(后台填的App页面传参kv)&(后台填的首次安装传参kv)&(JSSDK里填的自定义参数kv)&_sdk=umeng&linkid=xxx&_um_chnnl=share”等等,即URL里包含了JSSDK传递的data自定义参数。

自定义

4.如果wakeupurl和installParams均没有值,说明匹配失败了,请参考模糊匹配的技术原理排查

模糊匹配原理

H5页面会上报init事件,上报信息包括用户IP地址+appkey+设备型号+操作系统+剪切板内容(如果没有打开剪切板开关此内容不会上报),App新安装启动时会上报用户IP地址+appkey+设备型号+操作系统+剪切板内容(如果没有打开剪切板开关此内容不会上报),要求这两个动作发生在有效还原时间内(默认30分钟,开发者可以延长到24小时)

比对两个上报信息,只要模糊匹配成功了,说明这两个动作是同一个人发生的,那么此时服务端就能匹配上改裂变活动的wakeupurl等参数。开发者调取接口时就能获取到新安装参数和wakeupurl。假如二者的IP地址不同(例如一个是4G网络一个是wifi)并且剪切板内容匹配不上,那么模糊匹配就会失败,不能获取到安装参数。这种情况建议用户多试几次。