原始数据导出 API 的升级迁移

原始数据导出 2.0 和原始数据导出 1.0 主要区别

接口请求 URL

原始数据导出 1.0 接口格式:

https://www.growingio.com/insights/:ai/:date.json

原始数据导出 2.0 接口格式:

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

接口响应数据格式

原始数据导出 1.0 接口返回数据格式:

{
  "status":"FINISHED",
  "downlinks":[
    "link1",
    "link2"
  ]
}

原始数据导出 2.0 接口返回数据格式:

{
  "status”:"FINISHED",
  "downloadLinks":[
    "link1",
    "link2"
  ],
  "exportType":"",
  "dataType":"",
  "exportDate":"",
  "exportVersion":"",
  "requestTime":"",
  "errorMsg":""
}

数据文件的获取方式和组织

原始数据导出 1.0

  1. 按天和小时的维度区分获取数据,一次获取所有类型的数据

  2. 天数据一次返回所有7种类型当天的7个数据文件

  3. 小时数据一次返回所有7种类型当天特定小时的7个数据文件

原始数据导出 2.0

  1. 按导出类型(天或小时)和数据类型(v2共9种)区分获取数据,一次获取一种类型特定时间的数据

  2. 天数据返回特定日期所有小时的数据文件

  3. 小时数据根据确定的数据类型和时间获取确定类型确定小时的1个数据文件

原始数据导出提供的数据类型

原始数据导出 1.0 提供的数据类型:

visit、page、action、action_tag、custom_attr、ads_track_click、ads_track_activation一共7种类型的数据

原始数据导出 2.0 提供的数据类型:

visit、page、action、action_tag、custom_event(原custom_attr)、ads_track_click、ads_track_activation、pvar(新增)、evar(新增)一共9种类型的数据

数据格式变化

visit:新增字段,部分字段名称变化

page:新增字段,部分字段名称变化

action:部分字段名称变化

action_tag:字段名称变化

ads_track_activation:部分字段名称变化

custom_event:原custom_attr,新增字段,部分字段名称变化

pvar:新增类型

evar:新增类型

如何升级原始数据导出功能

如果您目前使用的API版本是1.0,想要升级为2.0,请联系客户成功经理。如果您已经从1.0升级到了2.0,请注意如下事项:

  • 从API2.0接口开通那一刻起,API1.0接口依旧可以继续使用,但是一个月之后就会失效,请您在过渡期内尽快升级您的使用代码。

  • API2.0接口从开通的那一刻起就开始生效,比如您于2018-08-01 10:30:00升级到了API2.0接口,那么API2.0接口就可以下载2018-08-01 11:00:00之后的数据了,但是之前的数据还需要通过API1.0去获取。

Last updated