注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
卖家店铺经营过程中，会关注很多店铺数据指标，千牛数字中心为卖家提供了“今日总流量、今日总访客”等数据，方便卖家在打开千牛时，可以第一时间看到自己关心的数据。同时，数字中心还支持卖家自定义添加/去除相关的数据指标。
卖家使用数字中心时，可以直接点击关注的数字，跳转到具体的插件，查看数据指标详情或者做具体的店铺操作。
如下图：
PC千牛数字中心：
移动千牛数字中心：
千牛数字中心展示在千牛工作台首页，是卖家使用频率最高的地方，ISV将自己插件中有价值的数字接入数字中心，可以为自己的插件提供更强的使用入口和场景。
常见的，ISV可以接入数字中心的数字，如：卖家的店铺经营利润、客服团队的绩效数字等。
第一步：确定需要接入的数字
1) 如果您需要对接数字中心，可以在本文档末尾查看可对接的“数字清单”。如果您想要接入的数字，不在“数字清单”中，您可以提出数字新增申请，申请方式：发送邮件至 dongyu.zdy#taobao.com（“#”换成“@”），邮件标题为“【数字新增申请】+插件名称”，邮件中请描述具体使用场景，并附上联系人旺旺ID。
2) 确定了要对接的数字之后，请加入旺旺群：413386615，并联系群主开通相关的权限。
几点说明如下：
a. 千牛的插件分为插槽(slot)类型和组类型(group)两种，数字接入后，用户查看数字的方式会有一点差别。
b. 对于插槽类数字，一个数字可有多个提供方，只有用户在使用您提供的插件做为默认插件时，您的数字才会得到展示。以“昨日订单数”为例，交易插件A和交易插件B都提供了“昨日订单数”指标，同时，卖家在千牛数字中心订阅了这个数字，那么当卖家的交易插槽默认使用的是A时，则会显示交易插件A提供的数字。
c. 对于组类型的数字，如果卖家订购了某个插件，该插件的数字才会出现在卖家的数字中心，供卖家选择订阅。
第二步：开发对接
需要调用的API接口是：taobao.qianniu.number.put
接口入参如下：
接口只有一个入参data，为json数组，支持一次上传多个数字。每个数字中，user_id为卖家uid。field即为数字的名称，可在数字清单或申请新增数字后获得。Value即为提供的数字，为字符串格式，这一数字将直接显示在用户界面，显示格式由ISV控制。
返回值格式如下：
对应输入参数，返回将是一个显示每条记录是否上传成功的json串。
例如：
上传数字data=[{userid:1,field:’a’,value:’1.0’},{userid:2,field:’b’,value:’2.0’}]时，
成功则会返回：
result=[{userid:1,field:’a’,success:’true’},{userid:2,field:’b’,success:’true’}]，
业务失败的话格式如下：
result=[{userid:1,field:’a’,success:’false’,error_code:101,error_msg:’auth failed’}, {userid:2,field:’b’,success:’false’ ,error_code:102,error_msg:’sys.error’}]
如果top调用失败，根据返回的错误类型，如果是isp.****的错误，说明服务端暂时有问题，可以稍后重试；如果是 isv.****，则说明调用内容有问题，请根据错误提示修改后重新调用。
1. 千牛数字均不保留历史数字，即一个数字只会有一个当前值的概念。
2. 千牛会提供每个数字的上传和用户使用情况，并根据这些情况对上传策略进行调整。一般来说，同个用户同个数字，一天上传次数会有所限制。
3. 如果上传的数字长期无用户使用，ISV的调用权限将被收回。
团队指标（24个，需要主账号或有管理员身份的子账号授权，其他子账号才可以查看）：
今日客服销售额
含义：客服团队的销售额，单位元
字段：today_customerservice_sales
今日客服销售量
含义：客服团队的销售量（件数）
字段：today_customerservice_salesvolume
今日客服客单价
含义：客服团队的平均客单价
字段：today_customerservice_salesunit
今日咨询人数
含义：今日发起聊天的买家数
字段：today_chat_buyers
今日接待人数
含义：今日客服回复过的买家数
字段：today_chat_reply
今日售前询单人数
含义：今日售前客服接待的买家数（售前咨询）
字段：today_chat_reply_presale
今日询单未下单人数
含义：今日询单没有下单的买家数
字段：today_inquiry_non_order
今日下单未付款人数
含义：下单没有付款
字段：today_order_non_payment
今日询单转化率
含义：询单到付款的转化率
字段：today_inquiry_payment_rate
今日平均响应时间
含义：平均响应时间
字段：today_average_responsetime
今日静默客单价
含义：今日店铺静默下单的客单件
字段：today_silent_salesunit
今日客服销售额占比
含义：今日客服销售额占店铺总销售额的百分比
字段：today_customerservice_sales_rate
今日团队平均首次响应时间
含义：客服团队的首次响应时间的平均值
字段：today_first_average_responsetime
今日平均接待时间
含义：客服接待一个买家平均消耗的时间
字段：today_average_receptiontime
今日未接待人数
含义：今天没有被回复过的买家数
字段：today_chat_non_reply
今日咨询接待率
含义：接待过的客户数/咨询的人数
字段：today_chat_reply_rate
今日询单下单人数
含义：询单后拍下订单的人数
字段：today_chat_reply_presale_order
今日咨询下单转化率
含义：下单人数/询单人数
字段：today_inquiry_order_rate
今日询单付款人数
含义：拍下的人数里最终付款的人数
字段：today_order_payment
今日付款转化率
含义：下单到付款的转化率
字段：today_order_payment_rate
今日评价发送率
含义：团队发出的满意度评价率（聊天窗口红心）
字段：today_satisfaction_sending_rate
今日满意度好评率
含义：收到的好评率（聊天窗口红心）
字段：today_favorable_rate
今日客服团队推荐成功率（可选指标）
含义：客服主动推荐的成功率
字段：today_recommendation_success_rate
今日客服团队推荐成功数（可选指标）
含义：客服主动推荐的成功商品个数
字段：today_recommendation_success
个人指标（22个，无需授权，客服岗位的子账号，默认展示）：
今日我的销售额
含义：客服个人的销售额，单位元
字段：my_customerservice_sales
今日我的销售量
含义：客服个人的销售量（件数）
字段：my_customerservice_salesvolume
今日我的客单价
含义：客服个人的平均客单价
字段：my_customerservice_salesunit
今日我的咨询人数
含义：今日发起聊天的买家数
字段：my_chat_buyers
今日我的接待人数
含义：今日客服回复过的买家数
字段：my_chat_reply
今日我的询单人数
含义：今日售前客服接待的买家数（售前咨询）
字段：my_chat_reply_presale
今日我的询单未下单人数
含义：今日询单没有下单的买家数
字段：my_inquiry_non_order
今日我的下单未付款人数
含义：下单没有付款
字段：my_order_non_payment
今日我的询单转化率
含义：询单到付款的转化率
含义：my_inquiry_payment_rate
今日我的平均响应时间
含义：平均响应时间
字段：my_average_responsetime
今日我的首次平均响应时间
含义：今日个人首次平均响应时间
字段：my_first_average_responsetime
今日我的平均接待时间
含义：个人接待一个买家平均消耗的时间
字段：my_average_receptiontime
今日我的未接待人数
含义：没有被回复的买家数
字段：my_chat_non_reply
今日我的咨询接待率
含义：接待过的客户数/咨询的人数
字段：my_chat_reply_rate
今日我的询单下单人数
含义：询单后拍下订单的人数
字段：my_chat_reply_presale_order
今日我的咨询下单转化率
含义：下单人数/询单人数
字段：my_inquiry_order_rate
今日我的询单付款人数
含义：拍下的人数里最终付款的人数
字段：my_order_payment
今日我的付款转化率
含义：下单到付款的转化率
字段：my_order_payment_rate
今日我的评价发出率
含义：今日个人发出的满意度评价率（聊天窗口红心）
字段：my_satisfaction_sending_rate
今日我的收到好评率
含义：收到的好评率（聊天窗口红心）
字段：my_favorable_rate
今日我的推荐成功率（可选）
含义：个人主动推荐的成功率
字段：my_recommendation_success_rate
今日我的推荐成功数（可选）
含义：个人主动推荐的成功商品个数
字段：my_recommendation_success
