方法一：通过URL传入客户身份识别的

使用方法：

  1. 作品链接上加previewer=mp和userInfo这两个参数；
  2. 在userInfo参数中传入平台标识和身份信息；


previewer字段说明

表明访问环境，支持的参数值有：mp、app。

  1. 当参数值为mp，表示小程序环境
  2. 当参数值为app，表示App环境

用户务必留意自己活动投放的环境。


userInfo字段说明

字段

类型

描述

userInfo

object

身份信息

identitys

object[]

多组身份信息 ，最大支持3组身份信息

identityType

string

身份类型：openid=微信环境下的openid、unionid=微信环境下的unionid，fans_id=有赞商城识别id，支持自定义类型标识

identityValue

string

身份类型对应的id取值

appid

mpidstring微信公众号appid或小程序appid或自建应用id等

platform

string

平台标识，公众号/小程序（gzh）、自建应用（external）

isWeChatEcosystemboolean是否微信生态，true是 false否

说明：identitys必需且至少一组身份数据，否则建档失败。identityType的取值为“工作台”->“用户”->“用户身份管理”中的”用户身份id“配置。


数据结构：

{
    "userInfo":{
        "identitys":[
            {
                "identityType":"openid",
                "identityValue":"openid-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"wxappid",
                "platform":"gzh",
                "isWeChatEcosystem":true
            },
            {
                "identityType":"unionid",
                "identityValue":"unionid-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"wxappid",
                "platform":"gzh",
                "isWeChatEcosystem":true
            },
            {
                "identityType":"memberNo",
                "identityValue":"member-no-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"应用id",
                "isWeChatEcosystem":false
            },
            {
                "identityType":"phone",
                "identityValue":"188xxxxxxxx"
            }
        ]
    }
}



如果有其它的用户信息，也可以附加在userInfo内进行上报，例如预设的头像（headimgurl）、昵称（nickname）、性别（sex）等。

customFields为用户信息扩展字段，以对象数组的形式支持传入多条数据，其中fieldValue为字符串数组类型，可传入多条数据，fieldId为“工作台”->“用户”→“字段管理”中的”字段id“的配置

{
    "userInfo":{
        "identitys":[
            {
                "identityType":"openid",
                "identityValue":"openid-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"wxappid",
                "platform":"gzh",
                "isWeChatEcosystem":true
            },
            {
                "identityType":"unionid",
                "identityValue":"unionid-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"wxappid",
                "platform":"gzh",
                "isWeChatEcosystem":true
            },
            {
                "identityType":"memberNo",
                "identityValue":"member-no-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"应用id",
                "isWeChatEcosystem":false
            },
            {
                "identityType":"phone",
                "identityValue":"188xxxxxxxx"
            }
        ],
        "nickname": "xxxx",
        "headimgurl": "xxxx",
        "sex": "0",
        "customFields": [
      {
        "fieldValue": ["",""],
        "fieldId": ""
      },
    ]
    }
}


url地址带参示范

'https://作品链接地址?previewer=mp&userInfo='+encodeURIComponent(JSON.stringify({"identitys":[{"identityType":"openid","identityValue":"openid-xxxx-xxxxx-xxxxx-xxxxx",
"mpid":"wxappid","isWeChatEcosystem":true},{"identityType":"unionid","identityValue":"unionid-xxxx-xxxxx-xxxxx-xxxxx","mpid":"wxappid","isWeChatEcosystem":true},
{"identityType":"memberNo","identityValue":"member-no-xxxx-xxxxx-xxxxx-xxxxx","mpid":"intanceAppid","isWeChatEcosystem":false},{"identityType":"phone","identityValue":"188xxxxxxxx"}]}));


访问转换后url地址，验证上报参数



1、identitys是识别用户的标识，比如身份证号、手机号、会员卡号等；而customFields传入的是用户的属性，如职业、行业、岗位等，这些数据在校验通过后，都会落库存储。

2、若只需要在url中透传，无需持久化到兔展侧进行存储，则可以通过拼接extField参数来实现。

拼接 extField 的字段值时 需要对字段值进行一次转义操作 encodeURIComponent (JSON.stringify(第三方要传入的对象值))
示例：

// 第三方要传入的对象值
const value = {tenantId: "00010", campaignId: "999"} 
 
// 进行转义操作
const extFieldValue = encodeURIComponent(JSON.stringify(value))
// 此时 extFieldValue 转义后为 '%7B%22tenantId%22%3A%2200010%22%2C%22campaignId%22%3A%22999%22%7D'
// 赋值到兔展的H5作品链接 extField 上
// www.rabbitpre.com/m2/a1b1ZictHX?extField=%7B%22tenantId%22%3A%2200010%22%2C%22campaignId%22%3A%22999%22%7D&appid=123456789


方法二：通过斐波SDK传入客户身份识别的数据

具体查看文档：H5-SDK