统计数据导出 API

注意:

  • 本页 API 中的 project_id、dashboard_id、chart_id 、funnel_id、retention_id字段,均可在项目页面url中找到,如:"https://www.growingio.com/admin/projects/nxog09md/dashboard/YoX28w7R" 中的 "nxog09md" 和 "YoX28w7R" 分别是 project_id 和dashboard_id。

  • dashboard_id的获取方式:

    • 第一种是在项目的url上获取。

    • 第二种是根据1.1获取看板列表的api根据project_id获取所有看板信息。

  • chart_id、funnel_id、retention_id的获取方式:

    • 第一种是在项目页面的url中获取。

    • 第二种是根据1.2获取看板中的图表信息api,根据dashboard_id获取当前看板的所有图表信息,返回的信息中会包含图表id、图表类型等信息。

  • 在进行导出之前,请务必参考“GrowingIO接口认证”文档,完成接口认证获取 token 。

  • 统计数据导出的延迟一般为 30 分钟,比如导出早上 8 点到 9 点之间的数据时,一般需要 9:30 才能统计完毕。另外,每天凌晨因为需要运行天级别的统计任务,此时前一天的统计数据大概有 3-4 小时的延迟,一般凌晨 4 点以后会统计完毕。

1.看板数据信息 API

1.1 获取看板列表

GET https://www.growingio.com/projects/:project_id/dashboards.json

获取当前项目下全部看板列表,按更新时间由近到远排序

Path Parameters

Name
Type
Description

project_id

string

项目 uid

Headers

Name
Type
Description

X-Client-Id

string

GrowingIO 分配的公钥,见 API 认证文档

Authorization

string

认证 Token,见 API 认证文档

[
  {
    "id": "Dashboard Uid",
    "name": "我的看板",
    "type": "看板类型", // normal: 普通看板, realtimeV2: 实时看板
    "createdAt": "2019-01-01",
    "updatedAt": "2019-01-02",
    "scope": "看板所属", // global: 全局, project: 项目, user: 个人
    "updater": "Dashboard Last Updator",
    "creator": "Dashboard Creator"
  },
  ...
]

1.2 获取看板中的图表信息

GET https://www.growingio.com/projects/:project_id/dashboards/:dashboard_id.json

Path Parameters

Name
Type
Description

dashboard_id

string

看板 id

project_id

string

项目 uid

Headers

Name
Type
Description

Authorization

string

认证 Token,见 API 认证文档

X-Client-Id

string

GrowingIO 分配的公钥,见 API 认证文档

{
  "id": "Dashboard Uid",
  "name": "Dashboard Name",
  "charts": [
    {
      "id": "Chart Uid",
      "name": "Chart Name",
      "createor": "Chart Creator",
      "createdAt": "Created Time",
      "resource_type": "chart"
    },
    {
      "id": "Funnel Uid",
      "name": "Chart Name",
      "createor": "Chart Creator",
      "createdAt": "Created Time",
      "resource_type": "funnel"
    }
    {
      "id": "Retention Uid",
      "name": "Chart Name",
      "createor": "Chart Creator",
      "createdAt": "Created Time",
      "resource_type": "retention"
    }
    ...
  ]
}

2.事件分析下载 API V2(2018-08-29更新)

获取事件分析数据(单图下载每秒限速 2 次)

GET https://www.growingio.com/v2/projects/:project_id/charts/:chart_id.json

Path Parameters

Name
Type
Description

chart_id

string

事件分析(单图 ID)

project_id

string

项目 uid

Query Parameters

Name
Type
Description

interval

integer

数据粒度,3600000(小时),86400000(天),604800000(周), 2592000000(月),默认为天

endTime

integer

数据结束时间,unix 毫秒时间戳

startTime

integer

数据起始时间,unix 毫秒时间戳

Headers

Name
Type
Description

Authorization

string

认证 Token,见 API 认证文档

X-Client-Id

string

GrowingIO 分配的公钥,见 API 认证文档

{
    "id":  "Chart  Uid",
    "name":  "Chart  Name",
    "startTime":  1462118400000,
    "endTime":  1462118400000,
    "interval":  86400000,
    "aggregator": {    // 当大数字图时返回该字段
        "values": [
            27557,    // 本周期聚合值
            25409     // 上周期聚合值
        ]
    }
    "meta":  [
        {  "name":  "目标用户",  "dimension":  true},
        {  "name":  "城市",  "dimension":  true  },
        {  "name":  "浏览器",  "dimension":  true  },
        {  "name":  "Metric  1",  "metric":  true  },
        {  "name":  "Metric  2",  "metric":  true  }
    ],
    "data":  [
        //  线图
        [目标用户,  timestamp,  metric1,  metric2],
        [目标用户,  timestamp,  metric1,  metric2]

        //  横向柱图
        [目标用户,  dimension_v1,  metric1],
        [目标用户,  dimension_v2,  metric1]

        //  纵向柱图
        [目标用户,  timestamp,  metric1,  metrics2],
        [目标用户,  timestamp,  metric1,  metrics2]

        //  表格
        [目标用户,  dimension1_v1,  dimension2_v1,  metric1,  metric2],
        [目标用户,  dimension1_v2,  dimension2_v1,  metric1,  metric2]

        //  大数字
        [目标用户,  timestamp,  metric1]

        //  气泡图
        [目标用户,  dimension1_v1,  dimension2_v1,  metric1,  metric2]
    ]
}

3.漏斗分析下载API

获取漏斗分析数据(单图下载每秒限速 2 次)

GET https://www.growingio.com/v2/projects/:project_id/funnels/funnel_id.json

Path Parameters

Name
Type
Description

funnel_id

string

漏斗分析(单图ID)

project_id

string

项目uid

Query Parameters

Name
Type
Description

conversionWindow

integer

转化周期

endTime

integer

数据结束时间,unix毫秒时间戳

startTime

integer

数据起始时间,unix毫秒时间戳

Headers

Name
Type
Description

Authorization

string

认证Token,见API认证文档

X-Client-Id

string

GrowingIO分配的公匙,见API认证文档

{
"id":  "Funnel Uid",
"name":  "Funnel Name",
"conversionWindow":  1,
"startTime":  1571068800000,
"endTime":  1572278399999,
"interval":  86400000,
"meta":  [
    {"name":"目标用户","dimension":true},
    {"name":"时间","dimension":true},
    {"name":"总转化率","metric":true},
    {"name":"第一步人数","metric":true},
    {"name":"第一步转化率","metric":true},
    ...
    {"name":"最后一步人数","metric":true},
    {"name":"最后一步转化率","metric":true}
]
"data":  [
    [目标用户, 时间, 总转化率, 第一步人数, ... , 最后一步转化率],
    [目标用户, 时间, 总转化率, 第一步人数, ... , 最后一步转化率],
    ...
]
}

4.留存分析下载 API

获取留存分析数据(单图下载每秒限速 2 次)

GET https://www.growingio.com/v2/projects/:project_id/retentions/:retention_id.json

Path Parameters

Name
Type
Description

retention_id

string

留存分析(单图ID)

project_id

string

项目uid

Query Parameters

Name
Type
Description

range

string

范围 day(日留存) | week(周留存) | month(月留存)

endTime

integer

数据结束时间,unix毫秒时间戳

startTime

integer

数据起始时间,unix毫秒时间戳

Headers

Name
Type
Description

Authorization

string

认证Token,见API认证文档

X-Client-Id

string

GrowingIO分配的公匙,见API认证文档

{
    "id":  "Retention Uid",
    "name":  "Retention Name",
    "range":  "day",
    "startTime":  1569686400000,
    "endTime":  1572278399999,
    "interval":  86400000,
    "meta":  [
        {"name":"目标用户","dimension":true},
        {"name":"对比值","dimension":true},
        {"name":"用户行为","dimension":true},
        {"name":"时间","dimension":true},
        {"name":"留存人数","metric":true},
        {"name":"当日","metric":true},
        {"name":"当日留存率","metric":true},
        {"name":"次日","metric":true},
        {"name":"次日留存率","metric":true},
        {"name":"2日后","metric":true},
        {"name":"2日后留存率","metric":true},
        . . .
        {"name":"29日后","metric":true},
        {"name":"29日后留存率","metric":true}
    ],
    "data":  [
        [目标用户,对比值,用户行为,时间,留存,...,29日后留存],
        . . .,
        [目标用户,对比值,用户行为,时间,留存,...,29日后留存]
    ]
}

5.分群下载 API

5.1 获取分群列表

GET https://www.growingio.com/projects/:project_id/segmentations.json

Path Parameters

Name
Type
Description

project_id

string

项目 uid

Headers

Name
Type
Description

Authorization

string

认证 Token,见 API 认证文档

X-Client-Id

string

GrowingIO 分配的公钥,见 API 认证文档

[
  {
    "id": "Segmentation Uid",
    "name": "Segmentation Name",
    "userType": 'u',
    "userNum": 1230,
    "updatedAt": "2016-08-03"
  },
  {
    "id": "Segmentation Uid",
    "name": "Segmentation Name",
    "userType": 'cs1',
    "userNum": 1230,
    "updatedAt": "2016-08-03"
  },
  ...
]

5.2 获取特定分群的用户列表

GET https://www.growingio.com/projects/:project_id/segmentations/:segmentation_id/users.csv

Path Parameters

Name
Type
Description

segmentation_id

string

分群 id

project_id

string

项目 uid

Headers

Name
Type
Description

Authorization

string

认证 Token,见 API 认证文档

X-Client-Id

string

GrowingIO 分配的公钥,见 API 认证文档

cs1    name    
12249    GrowingIO

6.规则逻辑 API 接口

获取圈选元素定义

GET https://www.growingio.com/projects/:project_id/rules.csv

Path Parameters

Name
Type
Description

project_id

string

项目 uid

Headers

Name
Type
Description

Authorization

string

认证 Token,见 API 认证文档

X-Client-Id

string

GrowingIO 分配的公钥,见 API 认证文档

ruleId,eventName,eventType
f2503720,元素_注册按钮,clck

Last updated