# 账号打通 #### 一、使用场景 **APP内嵌小鹅通店铺，用户无需再登录，即可顺滑观看直播或下单。核心能力：帐号打通。** 效果展示：直播嵌入APP里，APP用户只需登录APP账号，即可观看小鹅通直播或下单，无需多次登录账号  <br/> **帐号打通后App侧已经获得小鹅通userid，还可实现：** 1. **获取用户订单，关联用户订单到App帐号**。[订单接口](https://api-doc.xiaoe-tech.com/api_list/order/get_order_list_1.0.1.html) 2. **与自有App积分、优惠券、会员信息及其权益的打通**，能够直接给App用户发放积分、优惠券、会员卡等。 3. **资产打通**，用户在各渠道（（微信公众号、微信小程序、自有App等））的资产都可以保持一致，比如所有的订单、课程权限、积分、会员等级、优惠券等。 <br/> #### 二、登陆打通  **1) App用户静默登录（无需二次登录）小鹅通店铺的主要场景如下：** <font style="background:yellow">场景一，App直接访问店铺主页（以下三种不同嵌入页的登录效果模式）</font> 1. 用户打开App，<font color='red'>点击某个入口(例如banner图、icon等）访问小鹅通店铺</font>，可直接查看，无需二次登录 2. 用户访问<font color='red'>首页或商品详情页</font>（商品售前页）等无需登录的页面时，可直接查看，无需二次登录 3. 用户<font color='red'>下单或访问直播间、个人中心等页面</font>时，此时需要登录小鹅通店铺，H5会跳转到一个中间页，在中间页里App会收到SDK传递的登录通知。在收到登录通知后，需要判断用户是否已登录App： * 如果用户已登录App，后台可直接同步有小鹅通店铺登录态； * 如果用户未登录App，需要先调起App登录，用户登录成功后，后台再同步小鹅通店铺登录态 4. <font color='red'>App同步小鹅通店铺登录态时</font>，用户在前端会看到页面处于加载中，如果认证成功（即登录成功），就能跳转到下一级页面， 此时静默登录成功  <br/> <font style="background:yellow">场景二，App直接访问直播间</font> 1. <font color='red'> 用户打开App，点击某个入口访问直播间</font>（直播链接可在小鹅通后台复制配置到APP运营位） 2. 因小鹅通的直播间目前没有游客角色，必须要登录，所以进入直播间前App可以先行判断： * 如果用户已登录App，后台可直接同步有小鹅通店铺登录态； * 如果用户未登录App，需要先调起App登录，用户登录成功后，后台再同步小鹅通店铺登录态 3. <font color='red'> App同步了小鹅通店铺登录态后</font>，再进入直播间，直接是已登录的状态，直接可看直播。 （案例图） **2)App用户与原有的小鹅通店铺账号打通主要（实现的方法）场景如下**： <font style="background:yellow">场景一，App用手机号打通</font> 1. App用户进行静默登录小鹅通的时候<font color='red'>接口参数必传手机号(phone)</font>，我们会通过这个手机号去寻找您店铺内的现有账号，如果找到了，<font color='red'>将直接返回这个店铺账号的信息(token、小鹅通user\_id)回来，App就可以完全实现资产打通</font>，用户在各终端渠道的资产都可以保持一致。 2. H5店铺必须打开强制绑定手机号，因为小鹅通H5店铺是默认微信登录，不强制绑定手机号的，只有打开强制绑定手机号，您的小鹅通所有用户账号都是拥有手机号的，<font color='red'>App这边做账号打通用手机号即可</font>。 操作如下图：  优点：比较贴合App拥有手机号的账号体系。 缺点：H5上需要强制绑定手机号，用户体验打了折扣。 <font style="background:yellow">场景二，App用微信unionid打通</font> **<font color='red'>必要知识</font>**：微信unionid是将您的公众号或是App应用绑定在 [微信开放平台](https://open.weixin.qq.com) 后，进行微信授权时程序可获得的微信用户唯一标识。 1. 小鹅通后台进行服务号认证绑定，[点击阅读详细教程](https://helpcenter.xiaoe-tech.com/#/problem/detail?document_id=doc_5e9ef63c91801_ur7ck)或询问管家。 2. 绑定后用户进入小鹅通H5注册微信账号后，小鹅通后台会获得该用户在您的微信开放平台的unionid。 3. App上用户也绑定微信或微信登录，App能够拿到相同的unionid，在进行静默登录小鹅通店铺的时候，<font color='red'>调用接口参数必传unionid</font>，我们会通过这个unionid去寻找您店铺内的现有账号，如果找到了，将直接<font color='red'>返回这个店铺账号的信息(token、小鹅通user\_id)回来，App就可以完全实现资产打通，用户在各终端渠道的资产都可以保持一致。</font> 优点：H5上不需要强制绑定手机号，保证了H5上的用户体验 缺点：App需要进行微信登录或绑定微信才可以流程访问小鹅通。 <br/> **3) App用户、小鹅通账户用户信息变更场景解决方案如下：** 1. <font style="background:yellow">App用户头像、昵称等信息变更</font>，可以调用OpenAPI的更新用户信息接口进行同步更新小鹅通的昵称、头像等信息，[点击查看详情](https://api-doc.xiaoe-tech.com/api_list/user/update_user_instruction.html)。 2. <font style="background:yellow">小鹅通H5系统上用户头像、昵称信息变更暂不支持通知回App服务器。</font> 3. <font style="background:yellow">小鹅通H5账号因各种风控原因被注销</font>，可通知回App服务器，App可做相应处理，例如重新用注册用户或做相应提示，[点击查看异步推送详情](https://api-doc.xiaoe-tech.com/api_list/news_push/status_update.html) 4. 用户先在小鹅通H5上注册，如果App想及时收到注册用户的信息，可对接用户注册推送，[点击查看异步推送详情](https://api-doc.xiaoe-tech.com/api_list/news_push/user_register.html)