一步集成电商功能

阿里百川调研总结

关于百川

百川平台提供一个完整的解决方案，覆盖技术、数据服务、商业化，阿里百川甚至还具有一部分创业孵化功能，对于看中的APP，会提供创业场地与融资支持（百度百科）。

从百川提供的功能来看更加直观：1.百川多媒体（一站式文件存储、分发、处理服务。可以类比于阿里云的OSS）2.百川云测试（真机真人自动化APP测试服务。百度家的移动APP测试服务。）3.百川码力服务端监控（深入、全面、医用的服务端监控平台）4.云推送（类似于百度推送、个推推送）5.百川云旺即时通讯（类似于环信）6.电商SDK（标准化商品、交易、支付组件，打造应用内商城）7.测你喜欢（个性化推荐）8.用户反馈。

这里我们要用到的是电商SDK，接下来说下，用这个SDK可以做什么，怎么实现，以及App引流获利相关的内容。

在App中可以怎么用

1. 快速集成电商功能，百川的电商SDK相当于搭建了一个从App到淘宝页面的桥梁。当我们的App集成SDK之后，能够完成在App内直接进入淘宝商品详情页面，在详情页面进行加入购物车，支付操作。也就是说，详情页、购物车、支付链路都不需要在自己的App内实现，直接借用淘宝的功能。
2. 直接在App内登录淘宝账户，且90天内不需要再次登录。也就是说，SDK搭建的桥梁不是简单的把淘宝的H5页面嵌入到了App里面，而是建立了深度的结合。
3. 直接进入登录用户的购物车、订单列表页面。用户的淘宝账户在App内登录过之后，App可以直接借助SDK提供的方法，在App内打开用户的购物车和订单页面。
4. 登录状态检查，SDK提供了账号登录相关的登录状态检查，拉起淘宝登录（App或者web页面），注销登录功能，方面在App内直接操作淘宝账号。
5. 提供了从App进入淘宝的相关统计数据，方便查看App引流效果：访问的商品数量、下单数量、支付数量、总的支付金额等。

在淘宝和App之间同步数据

App集成了SDK之后，就具备了电商功能，但是这里有一个问题，就是App有App的后台（自家的服务器），淘宝有淘宝的后台，两个后台。那么淘宝上发生了商品的信息、价钱、库存变化之后，自家App里面不一致了怎么办？怎么把用户在淘宝下的订单同步到我们自家的系统里面来？

先说第二个问题：由于考虑到同一个App账户可以绑定多个不同人的淘宝账户（这是有可能的），会造成在一个淘宝账户里下的单可能分散在不同的App账户里，造成App账户里看到的订单和在淘宝账户里看到的订单不一致的情况。另外就是，考虑到SDK提供了直接跳转到用户订单列表的功能，可以直接查看用户在淘宝的下单。所以这一个同步点，我们选择放弃，即直接使用SDK提供的跳转功能，直接进入用户的淘宝订单列表。

关于商品信息、价钱、库存的变化问题。首选需要在百川的后台的API申请中申请高级电商能力（填写简单资料即可，大概一天后就能通过）。然后，在消息运维中添加商品信息相关的消息类型：标题变更、图片变更、价格变更、sku售空、商品售空、商品下架、商品上架等。

那么怎么订阅这些通知呢？两步：一步订阅、一步监听接收。

1. 订阅：
   前提是已经下载百川的服务端SDK。

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BaichuanItemSubscribeRelationsQueryRequest req = new BaichuanItemSubscribeRelationsQueryRequest();
Condition obj1 = new Condition();
obj1.setStartTime(StringUtils.parseDateTime("2015-11-23 12:00:32"));
obj1.setLimit(100L);
obj1.setStartId(0L);
obj1.setItemStatus(0L);
obj1.setEndTime(StringUtils.parseDateTime("2015-11-26 12:00:32"));
req.setCondition(obj1);
BaichuanItemSubscribeRelationsQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

1. 监听:
   见其中的“商品&订单状态变更消息通知”–>消息通知使用说明。

TmcClient client=new TmcClient("app_key","app_secret","default");//请求地址sdk默认已经封装
 client.setMessageHandler(new MessageHandler() {  
       public void onMessage(Message message, MessageStatus status) {  
           try {  
               System.out.println("============");  
               System.out.println(message.getContent());  
               System.out.println(message.getTopic());

               // 默认不抛出异常则认为消息处理成功  
           } catch (Exception e) {  
               e.printStackTrace();  
               status.fail();// 消息处理失败回滚，服务端需要重发  
           }  
       }  
   });  
   client.connect();
    System.out.println(client.isOnline());  
   Thread.sleep(64000000L);

这里需要对售空、下架、售空三个消息进行特别说明。这里没有减库存的通知，售空和下架都是在库存为0的时候发出。如果出现如下情况，淘宝发出售空通知后，不会再次发出上架通知，虽然实质上库存已经不是0。

即：如果A购买了最后一个库存，但是后来，A超时没有支付或者取消了订单，淘宝上的库存数会恢复成1.

那么，我如果想同步库存信息，该怎么办呢？还有一个主动查询的补偿办法，也就是定时的查询商品的信息。可以参见：http://open.taobao.com/doc2/apiDetail.htm?apiId=23559&scopeId=11681

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TaeItemDetailGetRequest req = new TaeItemDetailGetRequest();
req.setBuyerIp("127.0.0.1");
req.setFields("itemInfo,priceInfo,skuInfo,stockInfo,rateInfo,descInfo,sellerInfo,mobileDescInfo,deliveryInfo,storeInfo,itemBuyInfo,couponInfo");
req.setOpenIid("AAF123A");
req.setId("AAF123A");
TaeItemDetailGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

如何在App中集成SDK

1. 申请百川的账号，并在账号中创建一个应用（很多第三方服务都是如此）。创建应用后，可以取到appKey和appSecret。
2. 集成SDK到App，填入自己的appKey和appSecret。具体参见电商服务手册中的客户端开发部分。步骤和大多第三方的集成类似：导入sdk—》初始化—》使用。

如何实现引流获得收益

百川的SDK只是提供了跳转到商品详情的功能，不进行引流的统计。引流的统计实质是由阿里的另外一个产品提供的，也就是阿里妈妈旗下的淘宝客。所有的淘宝产品，如果参加了阿里妈妈的推广，那么就可以手动生成一个绑定到自己淘宝账户的淘宝客链接（url），如果App借助百川SDK进入的url是商品的淘宝客url，且完成支付，那么商品的所属商家就会把一定比例的佣金转账到我们自家的淘宝账户下，从而达到引流获取收益。