集成检查事项
1. 集成关键点
目前诸葛数据采集主要分为事件、identify(用户属性)两个维度。
事件:用户的一切行为可定义为事件,具体信息可记为属性和属性值。
identify:可自定义上传用户属性,用户触发identify为实名用户,反之为匿名用户,一般在登录\注册的地方采集。若需要为匿名用户分配id,切记不同用户identify的id不要相同。若相同,诸葛会默认为这是同一个用户。
采集时机:采集时机一般为按钮\模块点击,页面加载完成或者刷新,服务器返回判断值等。
2. 检查项
- 检查各平台中的appkey填写是否正确。
- 在添加事件属性时,需注意事件属性类型。如事件属性类型为「数值型属性」,需要在上传数据时修改数据类型为「数值型」,并且在诸葛io后台埋点管理中修改为「数值型」。详情可查阅:数字类型属性的计算。
2.1. web端
- web端每个页面都有初始化方法,且每个页面只能初始化一次,我们建议把初始化代码放在head标签中。
- 检查页面中的appkey是否填写的和诸葛后台生成的appkey一致。
- 同一域名有且只能使用一个appkey。
- 在sdk初始化前不得调用诸葛的track方法和identify方法。
- 若有各个平台数据打通的需求,请确保所有平台同一个账号的identify的属性名称一致。
- 相同操作行为的事件名称保持一致。这样在后续查看用户和用户行为的时候方便查看且各平台的用户行为可以关联。
埋点时要注意埋点的方式 :
- 页面跳转类别的事件尽量在目标页打点,事件属性可以通过url传参的方式传递过去。无法在目标页打点的情况下,使用track的回调函数,在回调函数中进行页面跳转。
- 成功或者失败类别的事件建议使用异步的方式去做埋点的触发。
2.2. 安卓端
- 在应用入口的Activity的onCreate中调用init方法且只可调用一次init方法。
- 检查诸葛所需所有权限。 发版前须检查AndroidManifest.xml文件的appkey填写是否与诸葛后台生成的appkey相同,且每个应用只能有一个appkey。
- 在初始化SDK前,不可调用track或identify方法。
- 若有各个平台数据打通的需求,请确保所有平台同一个账号的identify的属性名称一致。
- 相同操作行为的事件名称保持一致。这样在后续查看用户和用户行为的时候方便查看且各平台的用户行为可以关联。
2.3. iOS端
- 检查诸葛所需的所有依赖是否安装:UIKit、Foundation、SystemConfiguration、CoreTelephony、ibz.tbd。
- 检查设置版本渠道、开启日志等信息是否在startWithAppKey之前。
- 诸葛默认采用ARC,如果您的项目没有采用ARC需要为每个Zhuge文件标识为-fobjc-arc。
- 诸葛io首选采用IDFA作为用户追踪的ID。这需要您的应用安装AdSupport依赖包。 若应用中没有广告,采用IDFA可能会审核被拒,请在编译时加入ZHUGE_NO_ADID标志,诸葛io将会采用 IDFV作为追踪的ID。