流量数据API使用说明

一、功能简介

流量数据是淘宝对用户访问日志、历史交易信息等进行筛选及敏感数据处理后而开放给ISV的数据，通过对流量数据的统计及二次加工ISV可以为商家提供数据分析工具或其他功能。例如：流量数据提供每一个用户当前访问页面的URL地址及来源页面的URL地址，通过对其统计分析就可以得到由站外，直通车，搜索引擎，及其他广告推广而产生的PV操作所占比例，使商家可以精确的做商品的定向推广；流量数据提供量子统计信息，即在当前这个SessionID下，截止到当前时间戳，用户访问了多少次量子统计；流量数据同时还提供包含本次会话达成交易的淘宝交易订单号（若产生交易），通过对其统计分析就可以得到PV操作转化为实际购买力的比例，从而对商家做出相应的建议。

为便于ISV对异步任务的了解及异步API使用流程的理解，将提供一个Demo展示整个的异步任务中的流程，及开发中注意的事项，这个Demo是一个基于调用异步API中的taobao.topats.visitlog.get(获取访问日志根据传入的日期及商家的sessionKey，创建一个任务获取商家店铺指定时间（前七天）的访问日志，并返回任务Id，详情请参阅文档)及taobao.topats.result.get(获取异步任务处理的结果，根据传入任务Id，查看任务执行状态，如果任务已完成，则返回下载URL，详情请参阅文档)，而实现的一个获取一个商家店铺指定时间（前七天）的访问日志并加以解析的例子，要求有以下两点：

1.taobao.topats.visitlog.get 需要用户授权
2.taobao.topats.result.get 传入的task_id必需属于当前的AppKey才可以

二、准备工作

本次应用将需要开发者的AppKey及AppSecret，用户的SessionKey，同时需要使用到交易的增值SDK。所以需要执行以下流程：

1.应用的申请流程请参阅文档

2.appKey及appSecret的申请流程请参阅文档

3.交易的增值SDK申请及下载流程请参阅文档

4.Java使用SDK调用接口的用例请参阅文档

三、异步API的使用流程及注意事项

 整个异步任务的流程如图一所示
                                                                                                             图1 整个异步任务流程    

 
 
 

  
  
  
  
  
                                                                                   
 
 
 
以下将按照异步任务的流程的三步分步介绍：

1提交任务请求

提交任务请求将使用到taobao.topats.visitlog.get，入参为日期及商家的SessionKey，结果为一个任务的Id，若不成功将返回错误码及错误信息，常见的错误及解决方案如下表

表1提交任务请求常见的错误及解决方案

错误码	错误描述	解决方案
isv.invalid-parameter	参数格式错误	请按照文档的格式来写
isv.missing-parameter