用户关联
在服务端应用中,神策分析也要求为每个事件设置用户的 Distinct ID,这有助于神策分析提供更准确的留存率等数据。对于注册用户,推荐使用系统中的用户 ID 作为 Distinct ID,不建议使用用户名、Email、手机号码等可以被修改的信息。
所有的 Track 和 Profile 系列方法建议明确指定 isLoginId 参数,以便明确告知神策分析用户 ID 的类型。
用户注册/登录
当同一个用户的 Distinct ID 发生变化时(一般情况为匿名用户注册行为),可以通过 trackSignup() 将旧的 Distinct ID 和新的 Distinct ID 关联,以保证用户分析的准确性。
- 接口
- 示例
注意,对同一个用户,trackSignup() 一般情况下建议只调用一次(通常在用户 注册 时调用),用户登录前后的行为的关联建议在业务端实现。更详细的说明请参考 标识用户,并在必要时联系我们的技术支持人员。
设置用户属性
为了更准确地提供针对人群的分析服务,神策分析 SDK 可以设置用户属性,如年龄、性别等。用户可以在留存分析、分布分析等功能中,使用用户属性作为过滤条件或以用户属性作为维度进行多维分析。
记录用户属性
使用 profileSet() 设置用户属性:
- 接口
- 示例
对于不再需要的用户属性,可以通过 profileUnset() 接口将属性删除。用户属性中,属性名称与属性值的约束条件与事件属性相同,详细说明请参考 数据格式。
记录初次设定的属性
对于只在首次设置时有效的属性,我们可以使用 profileSetOnce() 记录这些属性。与 profileSet() 接口不同的是,如果被设置的用户属性已存在,则这条记录会被忽略而不会覆盖已有数据,如果属性不存在则会自动创建。因此,profileSetOnce() 比较适用于为用户设置首次激活时间、首次注册时间等属性。
- 接口
- 示例
数值类型的属性
对于数值型的用户属性,可以使用 profileIncrement() 对属性值进行累加。常用于记录用户付费次数、付费额度、积分等属性。
- 接口
- 示例
列表类型的属性
对于用户喜爱的电影、用户点评过的餐厅等属性,可以记录列表型属性。需要注意的是,列表型属性中的元素必须为 String 类型,且元素的值会自动去重。关于列表类型限制请见 数据格式 属性长度限制。
- 接口
- 示例
埋点事件采集
在 SDK 初始化完成之后,您可以通过以下接口进行数据埋点。
追踪事件
第一次接入神策分析时,建议先追踪 3~5 个关键的事件,只需要几行代码,便能体验神策分析的分析功能。例如:
- 图片社交产品,可以追踪用户浏览图片和评论事件
- 电商产品,可以追踪用户注册、浏览商品和下订单等事件
用户通过 track() 接口记录事件,对于任何事件,必须包含用户标志符(distinct_id)和事件名(event_name)两个参数。同时,用户可以在 track() 的第三个参数为事件添加自定义事件属性,在自定义属性中需要包含 $is_login_id 属性来说明 distinct_id 是否为登录 ID。以电商产品为例,可以这样追踪一次购物行为:
- 接口
- 示例