• 由 未知用户 (liuzaoyong)创建, 最终由 未知用户 (lvlifeng)修改于 2月 03, 2023

在使用该文档前请联系兔展 生态合作中心负责人 

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

使用方法：

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


previewer字段说明

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

  1. 当参数值为mp，表示mini-program环境
  2. 当参数值为app，表示App环境

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


注意：为防止作品本身发生默认的公众号授权，除字段 mp_userinfo & app_id 外任何时候

都必须要传递 stopAuth=1&previewer=mp 或者 stopAuth=1&previewer=app 来阻止默认的公众号授权以及标明此作品访问环境为mini-program环境或者APP环境


userInfo字段说明

字段

类型

描述

userInfo

object

身份信息

identitys

object[]

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

identityType

string

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

identityValue

string

身份类型对应的id取值

appid

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

platform

string

平台标识，gzh（微信公众号）、contentminiapp（微信小程序）、EXTERNAL（自建应用）

isWeChatEcosystemboolean

是否微信生态，true是 false否

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


数据结构：

注：全平台通用身份只需要传 identityValue、identityType

{
    "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":"user_id",   // 身份类型标识，全局唯一用户ID标识建议用 user_id 。自定义身份字段名需要优先在 兔展 用户-身份字段管理中新增配置后才能正常使用
                "identityValue":"user_id-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"应用id",
                "isWeChatEcosystem":false
            },
            {
                "identityType":"phone",
                "identityValue":"188xxxxxxxx"
            }
        ]
    }
}



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

customFields为用户信息扩展字段，以对象数组的形式支持传入多条数据，其中fieldValue为字符串数组类型，可传入多条数据，

fieldId为“工作台”→“用户”→“字段管理”中的”字段id“的配置,

fieldKey为“工作台”->"用户“->“字段管理”中的“字段英文名”.

{
    "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":"user_id", // 身份类型标识，全局唯一用户ID标识建议用 user_id 。自定义身份字段名需要优先在 兔展 用户-身份字段管理中新增配置后才能正常使用
                "identityValue":"user_id-xxxx-xxxxx-xxxxx-xxxxx",
                "mpid":"应用id",
                "isWeChatEcosystem":false
            },
            {
                "identityType":"phone",
                "identityValue":"188xxxxxxxx"
            }
        ],
        "nickname": "xxxx",
        "headimgurl": "xxxx",
        "sex": "0",
        "customFields": [
      {
        "fieldValue": ["",""],
		"fieldId": xxx,(已弃用，20230203)
		"fieldKey": ""
      },
    ]
    }
}


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







  • 无标签

评论

  1. 未知用户 (shangpan) 发表：

    10月 11, 2022

    在使用该文档前请联系兔展 生态合作中心负责人