感谢您的反馈！
智能硬件
天猫快闪店智能硬件数据回流
更新时间：2019/03/15
访问次数：1331
一、天猫快闪店介绍
天猫快闪店是由天猫平台统一招商对接/搭建实施的快闪店，会有一个或者多个品牌商入驻，以及各类智能硬件/软件服务商提供技术支持服务。
在天猫快闪店，消费者在店内互动购买分享等操作会通过智能硬件设备回流到智慧快闪的数据中心，并提供给天猫快闪店中入驻的品牌商进行运营分析和营销。
天猫快闪店由平台官方账号管理 每个快闪店中入驻的品牌信息和使用的硬件设备信息，新增品牌门店和对应硬件设备会由运营小二会后台操作。 如果服务商或者品牌商需要变更快闪店和设备类型，要联系快闪店运营小二进行操作。
二、天猫快闪店智能硬件设备信息获取
天猫快闪店 与 智慧门店智能硬件场景不同，快闪店场景下，涉及活动信息，场地档期和参与的智能硬件服务商都有平台小二统一配置。
品牌商在天猫快闪店活动报名页面，选择活动，再选择场地档期，再选择智能硬件，会生成品牌与服务商之间的合作意向记录。
服务商通过API获取对应的商家的活动列表，以及活动对应场地档期。 然后根据需要自行创建设备device_code。
接口会根据服务商传入的appkey，去查询品牌与服务商的意向数据，展示出可以参与的活动列表。
具体接口列表：
tmall.popupstore.activity.device.query 查询某段时间内的快闪活动列表
tmall.popupstore.activity.query 根据活动id查询活动相关快闪店及设备信息
tmall.popupstore.device.single.save 单个设备code创建接口
三、数据回流接口使用
设备在线状态回流 taobao.smartstore.device.status.feedback
需要在智能设备终端调用设备在线状态接口，请保证每5分钟回流一次设备状态，taobao.smartstore.device.status.feedback 设备在线状态回流，一般使用status：ONLINE_WITH_CONTENT就行。
智能硬件业务数据回流
建议系统架构，提供独立的服务端，做有一套日志采集分析系统； 智能设备上打点的用户操作数据先回传到服务端，服务端再定时（一般5-10分钟间隔）调用 智慧门店API接口回流数据给平台快闪数据中心。 如果回流接口出现异常，还可以通过打点记录回补数据。
新增数据回流字段，outer_user 用于智能硬件识别的游客标识，用于分析设备的UV访问情况。
1、智能硬件试妆镜数据回流 taobao.smartstore.device.makeupmirror.feedback
智慧门店试妆镜设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权,
3.action为ITEM_CLICK和TRY_MAKEUP时，item_id必须传入,且必须是淘宝商品的数字id；
4.skin_detection 和scalp_detection 涉及相关检测功能的硬件设备回传。
5.每一个acion都必须传入用户操作时间op_time；
6.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
2、智能硬件店头互动游戏数据回流 taobao.smartstore.device.storegame.feedback
智慧门店店头互动游戏设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权
3.每一个action都必须传入用户身份user_nick，需要传入淘宝账号名称；
4.每一个action都必须传入用户操作时间op_time；（start/end_time后续废弃）
5.action为GAME_OVER_WITH_PROMOTION时，需传入draw_result，只能传入0或者1；
6.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
3、智能硬件售货机数据回流 taobao.smartstore.device.vendor.feedback
智慧门店售货机设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权,
3.action为VENDING_MACHINE_SHIPMENT时，trade_type 和trade_no 必须传入且配套使用；
4.action为ITEM_CLICK、BUY_CLICK、VENDING_MACHINE_SHIPMENT时，item_id必须传入,且必须是淘宝商品的数字id；
5.每一个action都必须传入用户身份user_nick，需要传入淘宝账号名称。
6.每一个action都必须传入用户操作时间op_time；
7.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
4、智能硬件互动云货架数据回流 taobao.smartstore.device.iashelf.feedback
智慧门店互动云货架设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权,
3.每一个action都必须传入用户操作时间op_time；（start/end_time后续废弃）
4.action为ITEM_CLICK、ITEM_SENSOR、BUY_CLICK时，item_id必须传入,且必须是淘宝商品的数字id；
5.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
5、智能硬件客流摄像头数据回流 taobao.smartstore.device.camera.feedback
智慧门店客流摄像头设备回流 规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权,
3.face_id使用自定义标识，用于区分是否同一个访客；性别字段sex，只能传入M/F/N，其中M表示男，F表示女女 ，N表示无法判断；
4.必须传入用户操作时间op_time；（start/end_time后续废弃）
5.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
6、智能硬件试衣镜数据回流 taobao.smartstore.device.fittingmirror.feedback
智慧门店试衣镜设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权,
3.action为ITEM_CLICK和BUY_CLICK时，item_id必须传入,且必须是淘宝商品的数字id；
4.action为TRY_FITTING_CLICK 点击试衣时，try_fitting需传入搭配商品id
5.每一个acion都必须传入用户操作时间op_time；（start/end_time后续废弃）
6.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
7、快闪店快闪码URL生成 taobao.popstore.qrcode.get
快闪店商品码和活动码需要使用这个接口生成，会统计对应device_code的用户线上扫码操作。
8、商品优惠价格获取 tmall.popupstore.item.discount.price
根据商品id 获取商品sku级别的优惠价格。
四、数据回流数据查看
在开放平台控制台， 进入全渠道智慧门店应用，可以进入到 数据回流查询工具。通过该工具可以查询到智能硬件已经回流的具体数据。
五、数据回流验收标准
前置条件
1、按照API开放文档回流100条业务数据，并在本地保存一份，以下称为【数据A】；
2、打开【回流数据查询页面】，查询最近回流的100条数据,以下称为【数据B】；
3、打开【开放API文档】
数据校验
（上图片中的文字内容在下面表格中）
| 维度 | 校验点 | 说明 | 操作 | 验证 | 举例 |
| 数据合法性 | 空字段检测 | 开放API约定必传字段不能为空 | 检查数据B | 【开放API文档】中“是否必须”要求为必须的字段，【数据B】中必须全部不为空； | 例如，云货架数据回流，【开放API文档】中约定device_code、datas、end_time、start_time、action字段“是否必传”为必须，那么需要验证【数据B】中100条数据涉及这些字段必须全部不为空； |
| 重复值检测 | 检查数据B | 100条数据必须不能出现互相重复； | 例如，【数据B】中存在相同的两条记录，那么该验证点验证不通过； | ||
| 枚举值检测 | 开放API约定枚举值字段，回传数据值必须在枚举值范围内 | 检查数据B | 【开放API文档】中“描述”约定了取值说明的字段，【数据B】中字段值必须全部包含在文档约定范围内 | 例如，云货架数据回流，【开放API文档】中“描述”字段约定action取值范围，那么需要验证【数据B】中100条数据中action字段是否都包含在约定的取值范围内； | |
| 数据格式验证 | 开放API约定数据类型必须满足 | 检查数据B | 【数据B】中各字段类型必须满足【开放API文档】中 "类型"字段约定 | 例如，云货架数据回流，【开放API文档】中约定device_code“类型”为String，那么需要验证【数据B】中100条数据device_code字段必须全部为String类型； | |
| 数据一致性 | 数据量一致 | 回流前与回流后数据量一致 | 对比数据A和B | 【数据A】和【数据B】数据量一致 | 例如，数据A为100条，数据B为101条，则该验证点验证不通过 |
| 全文一致 | 回流前与回流后数据所有字段一致 | 对比数据A和B | 【数据A】和【数据B】所有字段取值一致 | 例如： 数据A包含记录a，而数据B未包含a，则该验证点验证不通过； 数据A不包含记录a，而数据数据B包含a，则该验证点验证不通过； |
|
| 数据有效性 | 实体真实性 | 回流数据相应主体必须是真实行为产生 | 检查数据B | 如果【数据A】包含用户、商品、卖家、门店、设备、订单号等实体信息,则在【数据B】中这些字段必须是真实业务场景产生的数据 | 例如： 【数据B】中用户非真实淘系用户ID，则该验证点验证不通过； 【数据B】中商品非真实淘系商品ID，则该验证点验证不通过； 【数据B】中卖家非真实淘系卖家ID，则该验证点验证不通过； 【数据B】中门店非真实门店ID，则该验证点验证不通过； 【数据B】中设备非真实设备ID，则该验证点验证不通过； 【数据B】中订单非真实订单ID，则该验证点验证不通过； |
| 实体关系校验 | 回流数据逻辑关系必须保证 | 检查数据B | 如果【数据A】包含商品及其卖家等实体信息,则在【数据B】中必须保证商品属于该卖家 | 例如，商品a属于卖家A，而【数据B】中呈现关系是商品a数据卖家X，则该严重点验证不通过； |