文档目录

1. 荟聚线索身份基本概念

荟聚中使用线索ID(即customerId)用来标识唯一的线索。但是,同一用户在对接的各个渠道上会有不同的身份标识方式,为了使渠道上的身份和荟聚中的线索ID进行关联,荟聚引入了线索身份的概念。所谓线索身份,是指在某个特定渠道下,可以用来唯一标识一个用户的数据。很明显,线索ID和线索身份是一对多的关系,即一个线索可以同时拥有不同渠道下的多个身份。在进行数据采集时,可以直接传入线索身份,荟聚会自动根据身份找到对应的线索ID,并将事件记录在该线索身上。

2. 荟聚身份模型

身份只有在特定的渠道下才有意义,所以身份值和渠道一定是成对出现和使用的。荟聚中的身份模型定义如下:

参数类型说明
customerIdLong线索ID
typeString(32)身份类型
valueString(128)身份值
nameString(255)该渠道下的用户名称,例如微信下的昵称

3. 荟聚预置的身份类型

为了方便用户使用,荟聚对一些常见的渠道预置了一些身份类型,可以在荟聚“设置中心”的“身份”页面查看。具体如下表所示:

渠道名称身份类型
手机号码mobile
邮箱email
荟聚会员membershipId
微信openidwechat
微信unionidwechat-unionid
微信小程序applet-wechat
淘宝taobao-account
支付宝alipay-account
企业微信wechatcorp

4. 自定义身份类型

出了系统预置的身份类型之外,还可以根据自身需要定义自定义的身份类型,在“设置中心”下面的“身份”页面直接新建身份即可。创建好的自定义身份可以直接使用在线索API对接和数据采集中。