统计数据导出 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
project_id
string
项目 uid
Headers
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
dashboard_id
string
看板 id
project_id
string
项目 uid
Headers
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
chart_id
string
事件分析(单图 ID)
project_id
string
项目 uid
Query Parameters
interval
integer
数据粒度,3600000(小时),86400000(天),604800000(周), 2592000000(月),默认为天
endTime
integer
数据结束时间,unix 毫秒时间戳
startTime
integer
数据起始时间,unix 毫秒时间戳
Headers
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
funnel_id
string
漏斗分析(单图ID)
project_id
string
项目uid
Query Parameters
conversionWindow
integer
转化周期
endTime
integer
数据结束时间,unix毫秒时间戳
startTime
integer
数据起始时间,unix毫秒时间戳
Headers
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
retention_id
string
留存分析(单图ID)
project_id
string
项目uid
Query Parameters
range
string
范围 day(日留存) | week(周留存) | month(月留存)
endTime
integer
数据结束时间,unix毫秒时间戳
startTime
integer
数据起始时间,unix毫秒时间戳
Headers
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
project_id
string
项目 uid
Headers
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
segmentation_id
string
分群 id
project_id
string
项目 uid
Headers
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
project_id
string
项目 uid
Headers
Authorization
string
认证 Token,见 API 认证文档
X-Client-Id
string
GrowingIO 分配的公钥,见 API 认证文档
ruleId,eventName,eventType
f2503720,元素_注册按钮,clck
Last updated