...
获取授权信息后，当前用户信息会在兔展环境进行落库：
二、微信H5环境打开——URL传入客户档案
...
常用场景：
...
针对不想通过公众号授权的方式，希望可以直接进入活动页，并且静默完成用户档案的创建。
...
功能说明：
previewer字段说明
表明访问环境，支持的参数值有：mp、app。
- 当参数值为mp，表示小程序环境
- 当参数值为app，表示App环境
用户务必留意自己活动投放的环境。
userInfo字段说明
...
字段
...
类型
...
描述
...
userInfo
...
object
...
身份信息
...
identitys
...
object[]
...
多组身份信息 ，最大支持5组身份信息
...
identityType
...
string
...
身份类型：openid=微信环境下的openid、unionid=微信环境下的unionid，fans_id=有赞商城识别id，支持自定义类型标识
...
identityValue
...
string
...
身份类型对应的id取值
...
platform
...
string
...
平台标识，公众号/小程序（gzh）、自建应用（external）
...
说明：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地址带参示范
访问转换后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
此功能支持通过url的方式，将用户信息导入进兔展的系统
三、小程序环境打开——URL传入客户档案
我需要准备什么？
...
- 接入方小程序webview加载兔展作品时在作品链接上直接传入对应授权所需信息字段进行授权。
优点：类似微信的静默授权，用户无感知。
缺点：用户的登录状态需接入方自行管理。 - C端用户点击作品内部的授权按钮，嵌套在小程序webview的作品会跳转小程序原生授权页（自建应用内 “小程序授权” 配置的授权页路径），并携带参数：redirect_url & app_id（详见参数说明表）进入第三方自行实现的授权页，当授权结束后，小程序需重定向回先前传递的redirect_url（作品地址），并携带加密后的用户信息参数mp_userinfo & app_id （注意别忘记携带 stopAuth=1&previewer=mp 来阻止默认授权行为）
优点：可以在不登录的情况下，通过用户行为主动发起登录授权。
缺点：需要接入方开发授权页。
参数说明表：
...
参数
...
...
说明
...
redirect_url...
当前H5页面地址，包含已有的其他字段...
app_id...
自建应用id...
mp_userinfo
...
*文档地址：小程序环境授权
三、APP序环境打开——通过SDK传入客户档案
...
在【配置】-【数据集成】-【自建应用】页面下，点击“新建应用”，配置应用名称，勾选申请“编辑器-APP环境集成”的权限后，提交审核。
待运营人员在后台审核通过应用后，点击进入应用配置页，进行功能设置——
...
4、设置是否需要用户同意授权后再拉取用户信息，若设置”需要“，则在拉取用户信息之前会先弹窗获取用户同意；若设置”不需要“，则直接拉取用户信息。
编辑器设置——调起APP登录授权
...
若需要在点击这些组件时唤起APP登录授权，则可在设置“点击时”“调起APP登录授权”，然后再点击“设置自建应用”，跳转至“预览设置”弹窗。
在弹窗下的“多环境应用设置”-“APP”下，选择已经设置好的自建应用，即可完成配置，
App环境授权第三方规范
标准协议如表格所示，第三方需按此表格中的协议实现JS SDK代码包，兔展活动页面会在合适的时机来主动调用，JS SDK命名空间固定为：AppAuthorization
...