获取不同类型原始数据下载链接

URL

https://www.growingio.com/v2/insights/{export_type}/{data_type}/{ai}/{export_date}.json?expire={minutes}

请求类型

GET

请求头部

公共头部请参考公共请求头参数。

参数说明与示例

请求参数

路径参数

类型

是否必传

说明

export_type

string

是

导出任务类型，系统目前支持小时与天的导出，可选值：hour 或者 day

data_type

string

是

导出事件类型，系统支持以下事件类型的导出，可选值： visit: 访问事件 page: 页面事件 action: 动作事件，包括点击、修改等动作 action_tag: 动作事件与圈选规则关联关系 custom_event: 自定义事件 ads_track_activation: 广告激活事件 ads_track_click: 广告点击事件 pvar:页面级变量 evar: 转化变量 vstr：访问用户变量

ai

string

是

项目ID。

export_date

string

是

导出数据北京时间，格式为 yyyyMMddHHmm, 表现请求导出哪段时间内的数据，分为以下情况： 当 export_type 为 day 时，只会截取 export_date 中 yyyyMMdd, 其余将忽略。 当 export_type 为 hour 时，只会截取 export_date 中 yyyyMMddHH, 其余将忽略。

查询参数

类型

是否必传

说明

expire

integer

否

下载链接失效时间，单位为分钟。最长时间为7天。 默认值：5

返回参数

名称

说明

status

导出状态。可能值为： FINISHED：导出任务完成，客户可以使用 downloadLinks 中的链接进行文件下载。 RUNNING：导出任务正在运行。 NOT_EXISTS：导出任务不存在，请检查是否开启了导出功能并检查请求日期时间。 ERROR：导出任务发生错误。

downloadLinks

文件下载链接。 链接可能随时调整，不应使用链接中的任何内容作为处理程序依据，链接过期时间默认为5分钟。

exportType

表示导出任务类型，由用户传入，服务器原样返回。

dataType

表示导出事件类型，由用户传入，服务器原样返回。

exportDate

表示导出数据时间，由用户传入，服务器根据 exportType 截取后返回。

exportVersion

表示导出数据版本，当前版本下默认为 v2。

requestTime

客户请求发生时服务器时间。

errorMsg

请求发生错误时，服务器返回的错误信息。

响应示例

// 如果下载的是页面级变量数据， pvar 中数据是通过埋点代码上报页面级变量数据，不包含通过圈选定义的页面级变量
{
  "status": "",
  "downloadLinks": [],
  "exportType": "",
  "dataType": "",
  "exportDate": "",
  "exportVersion": "",
  "requestTime": "",
  "errorMsg": ""
}