电商SaaS_有赞自用版
【有赞自用版】介绍
【有赞自用版】除了原有赞连接的所有功能外，还提供用户行为记录的事件记录和触发。
【有赞自用版】仅支持有赞微商城解决方案，仅支持小程序商城。（如无有赞小程序商城，需要自费购买并搭建完成，详细可以点击此处查看并购买《有赞微商城》）
使用【有赞自用版】前提说明：购买了【有赞自用版】后，如果需要获取到订单的的更多事件，客户需要向有赞付费购买【黑金版】且带有【鹊桥接口】功能的版本（具体购买可以联系有赞的客户经理，有赞的版本解释权归有赞所有，费用由客户自己承担哦~~）。
【有赞自用版】使用前提，需要联系有赞的客户经理，购买他们的商城套餐，然后启动【有赞自用版】与LinkFlow的对接！
【有赞自用版】与Linkflow对接后，在系统中展示的界面：
【有赞自用版】与Linkflow对接后支持获取的事件
| 连接 | 有赞解决方案 | 载体 | 授权方式 | 记录事件（红色的事件仅支持在时间轴、事件分析报表中查看） 注：【能力包】需要同时购买【黑金版】＋【鹊桥接口】才能申请哦！ “变更有赞会员等级”（此事件的能力包不需要购买【黑金版】+【鹊桥接口】有也可以申请） （最终解释权归有赞官方说明，以有赞方为准） | 客户旅程触发事件 |
| 【有赞自用版】（已购买【黑金版＋鹊桥接口】） | 微商城、零售 | 小程序商城 | Linkflow授权（自用版以及【黑金版】＋【鹊桥接口】的申请费用由客户自己支付） | 有赞订单交易成功、有赞订单交易关闭、有赞取消购买商品、有赞小程序启动、有赞小程序展示、有赞小程序隐藏、有赞页面离开、有赞页面浏览、有赞页面分享、有赞搜索、有赞商品卡曝光、有赞商品详情浏览、有赞订单行为、有赞购买商品、有赞会员等级变更（此事件需要申请此能力包才会显示） | 有赞订单交易成功、有赞订单交易关闭、有赞页面分享、有赞搜索、有赞商品卡曝光、有赞商品详情浏览、有赞订单行为 |
| 有赞自用版（无【黑金版＋鹊桥接口】） | 微商城、零售 | H5商城、小程序商城 | Linkflow授权（自用版的申请费用由客户自己支付） | 订单交易成功、订单交易关闭、变更有赞会员等级（此事件需要申请此能力包才会显示，此能力包无需购买【黑金版+鹊桥接口】也支持申请） | 订单交易成功、订单交易关闭 |
【有赞自用版】与Linkflow对接
对接步骤
——在微商城中创建店铺，并在店铺的【设置-员工管理】中将该手机号设置为有赞店铺的管理员。
2、需要创建一个【自用型无容器】应用。点击此处查看《如何创建自用型无容器应用》
3、申请能力包（注：【变更有赞会员等级】事件无需购买【黑金版】等也可以申请哦！其他五个事件需要在购买【黑金版】带【鹊桥接口】的才能申请，具体可以联系有赞的客户经理！）
4、查看：API接口权限与“能力包”的对应关系（此处可以同时完成交易关闭、交易成功等消息的订阅，）
5、登录Linkflow，对接【有赞自用版】
6、配置【回调地址】和【订阅消息推送】
7、点击【重新获取有赞用户】
1、店铺授权
——准备账号、店铺和管理员
客户用同一个手机号《注册有赞云》和《有赞微商城》，在微商城中创建店铺，并在店铺的【设置-员工管理】中将该手机号设置为有赞店铺的管理员。
2、在有赞云中创建应用
《注册&认证有赞云》后，需要在有赞云中创建自建应用（选择自用型【我是有赞商家】、无容器【部署在本地】，简称：自用型无容器应用，点击此处查看《如何创建自用型无容器应用》）
3、申请能力包
登录有赞云-在控制台【应用中心】>点击已经创建好的【自用型无容器应用】>【类目能力】>【类目管理】（如下图）
申请以下能力包，以下为能力包的名称，搜索框输入查找并申请：（详细可以点击【有赞云】的关于《如何申请能力包》的官方说明文档）
”订单同步”、”店铺客户信息同步”、“单店信息同步”、“店铺客户信息同步”、“会员等级打通”。
找到对应能力包，点击右侧对应的“申请”开通。即可发起申请。审核约在3工作日内完成，请耐心等待。
使用【黑金版】还需要开通“数据服务-黑金版专用”。
需要获取【有赞会员等级变更事件】，必须要申请此能力包【用户会员等级事件消息】
4、有赞云API接口权限按照能力包纬度申请，相关权限对应的“能力包”关系
建议参考说明文档：https://doc.youzanyun.com/resource/doc/4029/4029
5、登录Linkflow，对接【有赞自用版】
在Linkflow连接管理-电子商务SaaS中，点击有赞自用版连接
需要输入client_id、client_secret、店铺id
client_id、client_secret在有赞云的应用【应用概况-应用信息】中复制
店铺id在应用【应用概况-授权信息-查看店铺授权】中复制。
6、配置【回调地址】和【订阅消息推送】
点击连接详情中的【查看回调地址】弹出以下弹窗。
将【回调地址】配置到有赞云后台的【应用概况-应用信息-回调地址】中
也将【回调地址】也配置入【类目能力-消息订阅-推送网址】中
登录有赞云-在控制台【应用中心】>点击已经创建好的【自用型无容器应用】>【类目能力】>【消息订阅】，订阅以下消息推送：
操作路径
路径：【连接管理】>【有赞】>【重新获取有赞用户】
用户identify和用户信息更新
——黑金版鹊桥接口中，进客户旅程的事件，需要做该步骤。
——不进客户旅程的事件，只记录事件和关联人，不做用户信息更新。
通过yz_open_id映射annoymous_id。
通过【用户查询接口】传入yz_open_id查询买家信息：
https://doc.youzanyun.com/detail/API/0/2193
买家信息包括：昵称、头像、性别、手机号、省份、城市、微信openid、unionid等（用于ID mapping）。
名称 | 字段来源 | 备注 |
|---|---|---|
| 昵称 | data.user_list.primitive_info.nick_name | platform_type=1 |
| 头像 | data.user_list.primitive_info.avatar | platform_type=1 |
| 性别 | data.user_list.primitive_info.gender | platform_type=1 |
| 手机号 | data.user_list.mobile_info.mobile | |
| 省份 | data.user_list.primitive_info.province | platform_type=1 |
| 城市 | data.user_list.primitive_info.city | platform_type=1 |
| 微信unionid | data.user_list.wechat_info.union_id | |
| 微信openid | data.user_list.platform_info.weixin_open_id | result_type_list=1 |
可以用下图方式初始化用户信息
之后有赞会员每次做用户信息更新时（姓名、手机号、生日、性别等），LinkFlow用户信息会同步更新。
【同步订单数据】说明
【订单数据】来源：有赞
订单包含数据
——订单头：订单头主要描述订单相关信息，如：订单号、下单时间、用户ID、实际支付金额、收货人、收货地址等
——订单行：描述订单商品的描述信息，如：订单号、订单行ID、商品名称，商品ID，SKU ID，品类，数量，品牌，单价等
有赞交易消息
| 交易创建 | 交易创建消息，当一笔订单创建时通知 |
| 买家付款(即商家待发货) | 1、买家付款且主订单状态为「等待商家发货」时触发。 2、对于周期购订单，买家付款且主订单状态为「周期购待发货」注意商品优惠【order_promotion.item】不会返回周期购信息，请使用订单详情接口查询 3、对于多人拼团订单，需要拼团成功，主订单状态为「等待商家发货」时触发 4、对于电子卡券和虚拟商品订单，不触发该消息 |
| 卖家发货 | 卖家对所有商品发货完成，且主订单状态为「商家已发货」时触发 |
| 交易成功 | 买家确认收货或系统自动确认收货且主订单状态变为「交易成功」时触发 |
| 交易关闭 | 买家未付款，买家或卖家取消订单，且交易状态变为「交易关闭」时触发； 超时未付款，系统取消订单，且交易状态变为「交易关闭」时触发； 订单全额退款，且交易状态变为「交易关闭」时触； |
| 卖家同意退款（终态） | 卖家同意退款且退款单状态为SUCCESS(退款成功)时触发 |
| 买家退货成功(终态) | 卖家同意退货且退款单状态为SUCCESS(退款成功)时触发 |
| 卖家修改买家收货地址消息 | 如果商家遇到买家下单地址填错了，可以自行和买家协商（运费相关如果变化需要您和买家私下解决，达成一致），协调后商家可以通过商城订单详情去帮助买家修改地址信息 |
| 买家自助修改收货地址 | 买家修改地址时会触发 |
【同步订单数据】操作路径&注意事项
1、已对接【数云】或者其他支持获取【有赞】订单的其他平台的客户
——【同步订单数据】需要保持关闭！！！
——如果【开启】此功能，会容易重复收到有赞的订单数据！！
2、未对接【数云】或者其他支持获取【有赞】订单的其他平台】的客户
——建议开启该按钮！否则无法获取到【有赞订单数据】！
路径：【连接管理】>【有赞】>【同步订单数据】
有赞自用版支持以下事件的记录：
1、交易成功事件和购买商品子事件：
| 电子商务SaaS | YOUZANSELF | YOUZANSELF__SO_SUCCESS | 订单交易成功 |
子事件：
| 电子商务SaaS | YOUZANSELF | YOUZANSELF__SO_ITEM | 购买商品 |
2、交易关闭事件和取消购买商品子事件
| 电子商务SaaS | YOUZANSELF | YOUZANSELF__SO_CLOSE | 订单交易关闭 |
子事件：
| 电子商务SaaS | YOUZANSELF | YOUZANSELF__SO_ITEM_CLOSE | 取消购买商品 |
3、会员等级变更事件
| 电子商务SaaS | YOUZANSELF | YOUZANSELF__CUSTOMER_GRADECHANGE | 有赞会员等级变更 |
4、用户行为事件：
| 分类 | 事件类型 |
|---|---|
| 浏览 | 小程序启动 |
| 小程序显示 | |
| 小程序隐藏 | |
| 页面离开 | |
| 浏览 | 页面浏览 |
| 分享 | 页面分享 |
| 搜索 | 搜索 |
| 商品 | 商品卡曝光 |
| 商品详情浏览 | |
| 订单 | 订单行为：【有赞订单交易成功】&【有赞订单交易关闭】 |
| 会员 | 会员等级变更事件 |
其中【订单行为】指订单创建事件
有赞自用版支持以下事件在客户旅程中的触发：
有赞商品详情浏览
用户在小程序商城浏览商品详情页触发
有赞页面分享
触发方式不详，小程序右上角分享和商品详情页分享都不能触发，有赞官方客服也未给出有效信息。
有赞搜索
用户在小程序商城内发生搜索操作触发
有赞商品卡曝光
点击类似下图中商品卡片触发
有赞订单
有赞订单交易成功
用户下单并确认收货，有赞后台订单状态变为“交易完成”，则触发“有赞订单交易成功”事件。
有赞订单交易关闭
用户或商家取消订单，有赞后台订单状态变为“交易关闭”，则触发“有赞订单交易关闭”事件。
有赞订单行为
用户在小程序商城创建订单行为
订单行为包括以下事件：
有赞会员等级变更
支持获取有赞会员等级变更事件
自用型无容器接入流程
【前提条件】
已有有赞云账号，并且完成认证。具体操作请参见新手指南。
有赞店铺后台确认授权
自用型应用在控制台创建完成后，还需要到有赞店铺后台确认授权。
美业店铺后台确认授权路径稍有不同。
后续操作
应用创建完成后，可以申请测试店铺，并完成授权操作，用于应用开发过程中测试使用。
关于测试店铺的申请与授权，请参见无容器申请并授权测试店铺。
有赞云注册流程
对于首次入驻的开发者，需要完成以下基本操作，才能使用或上架应用。
一、注册有赞云
二、实名认证
| 1 | 营业执照（提供资质附件如为复印件，须加盖公章。） |
| 2 | 法人证件 |
| 3 | 法人手持证件照（若无法提供法人手持证件照，可以选择通过企业授权代办人完成开发者认证。 并且在上传文件处补充授权书，附授权书模板：授权说明书.docx） |
| 4 | 常用联系人 姓名、手机号、客服电话 |
一、注册有赞云
1、注册登录
开发者通过手机号注册账号，手机号将成为开发者的有赞云账号。
1、进入有赞云官网，点击右上角控制台进入登陆界面。
2、点击右下角注册账号进入注册界面。
3、填写相关信息，勾选协议，点击确认注册。
1、若您曾经注册有赞商城账号，有可能会出现手机账号已被注册的情况，点击“已有账号，直接登录”。
2、输入手机号后输入密码登陆，若忘记密码可点击“忘记密码”重新设置密码进入有赞云控制台。
4、进入邮箱激活账号。
-激活邮件有效期为15分钟，请及时激活。
-如未收到激活邮件，请点击重新发送。
5、您所注册的邮箱地址会收到验证码
6、把验证码粘贴到红色框处完成邮箱激活
二、如何实名认证
1、实名认证
团队创建完成后，需进行实名认证才可以创建应用。可以选择个人认证和企业认证，通过企业认证的团队有更丰富的团队信息展示，如果是企业开发者请使用企业身份进行认证。
1、进入需要认证的团队，点击去认证。
2、根据开发者实际情况，选择个人认证或是企业认证。
-认证审核时间为1个工作日，若审核不通过，需要重新提交资料。
-请上传小于2M的图片。
2、所需材料
| 1 | 营业执照（提供资质附件如为复印件，须加盖公章。） |
| 2 | 法人证件 |
| 3 | 法人手持证件照（若无法提供法人手持证件照，可以选择通过企业授权代办人完成开发者认证。 并且在上传文件处补充授权书，附授权书模板：授权说明书.docx）
|
| 4 | 常用联系人 姓名、手机号、客服电话 |
个人认证和企业认证的区别
个人认证：不支持上架应用市场。
企业认证：支持上架应用市场。
建议：使用开发者使用企业认证。
有赞云认证入口：https://doc.youzanyun.com/doc#/content/27027/27062
注意：认证以后无法更换认证方式，即个人认证和企业人无法相互转换。企业认证成功后目前不支持更新。
开发者企业认证无法提供法人手持证件照怎么办？
开发者使用有赞云服务前，必须进行实名认证。个人认证和企业认证的区别可参考：个人认证和企业认证的区别？
企业认证时，若无法提供法人手持证件照，可以选择通过企业授权代办人完成开发者认证。 并且在上传文件处补充授权书，附授权书模板：授权说明书.docx 
2、照片需要清晰可见证件号码、代办人五官轮廓等，单张照片小于2M。