本文记录使用 API 获取 Flurry Analytics 报告的文档。

包含前期准备、API基础、数据详情、请求示例等

初期准备

• 获取 App Token
• header 中必须包含：Authorization: Bearer + App Token
• Flurry Analytics API Query Builder 查询器、调试器

示例：

Headers:

Authorization: Bearer xxxxxx

API 基础

API 地址：https://api-metrics.flurry.com/public/v1/data/

API 请求可以组合起来去查询分析数据的元素。 API 中的所有内容都区分大小写。

endPoint/table/timeGrain/dimension1/dimension2;show=all/dimension3{...}?metrics=[comma-separated-metrics]&dateTime=[..]&filters=[...]&topN=[..]&sort=[..]&having=[..]&format=[..]&timeZone=[..]

参数表及示例详见原文。

关于时区：https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Analytics Metrics 分析指标

以下是可用于报告的指标。

Analytics Dimensions 分析范围、维度

以下是可用于报告的维度和维度属性。

在运行度量标准查询之前，您需要知道可能的维度值。 例如：您公司帐户上所有应用的列表名称和api密钥：

https://api-metrics.flurry.com/public/v1/data/appUsage/day/company/app;show=name,apiKey?metrics=...

通常，要查看为给定维度返回的默认名称以外的值，请添加：

;show=all
or
;show=id  (any other value listed in the value column above for the given dimension

添加维度名称之后：

https://api-metrics.flurry.com/public/v1/data/appUsage/day/company/country;show=all/category?metrics=sessions,activeDevices,newDevices,timeSpent&dateTime=2017-05-01/2017-05-02

https://api-metrics.flurry.com/public/v1/data/appUsage/day/company/country;show=iso/category?metrics=sessions,activeDevices,newDevices,timeSpent&dateTime=2017-05-01/2017-05-02

App Usage Data 应用使用的数据

Table: <a id="appUsage">appUsage</a>

示例：关键应用指标查询

对于所有应用程序，每日会话，每日活动设备，2 天的新设备：请注意，由于过滤器中没有应用信息，结果将包括您公司的所有应用程序。

Request 请求：

https://api-metrics.flurry.com/public/v1/data/appUsage/day/app?metrics=sessions,activeDevices,newDevices&dateTime=2016-07-01/2016-07-03

Response 响应：

{
        "rows": [{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "sessions": 372,
                "activeDevices": 123,
                "newDevices": 32},
        {
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "bar",
                "sessions": 1120,
                "activeDevices": 487,
                "newDevices": 34},
        {
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "sessions": 421,
                "activeDevices": 140,
                "newDevices": 12},
        {
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "bar",
                "sessions": 1164,
                "activeDevices": 453,
                "newDevices": 51}]
}

对于特定应用程序，每月会话，有效设备和新设备（2个月）：

Request using Flurry API key:

https://api-metrics.flurry.com/public/v1/data/appUsage/day?metrics=sessions,activeDevices,newDevices&dateTime=2016-06-01/2016-08-01&filters=app|apiKey-in[3WD7Q8329867K7MY6RNS]

Request using App name:

https://api-metrics.flurry.com/public/v1/data/appUsage/day?metrics=sessions,activeDevices,newDevices&dateTime=2016-06-01/2016-08-01&filters=app|name-in[appname]

Response:

{
        "rows": [{
                "dateTime": "2016-06-01 00:00:00.000-07:00",
                "app|name": "foo",
                "sessions": 12744,
                "activeDevices": 6373,
                "newDevices": 6373
        },{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "sessions": 13805,
                "activeDevices": 6882,
                "newDevices": 6882
        }]
}

App Events Data

Table: <a id="appEvent">appEvent</a>

示例：关键应用事件指标查询

对于特定应用程序事件，应用程序版本的事件发生次数（2天）：

Request:

https://api-metrics.flurry.com/public/v1/data/appEvent/day/app/appVersion/event?metrics=occurrences&dateTime=2016-07-01/2016-07-03&filters=app|name-in[foo],event|name-in[login,register]

Response:

{
        "rows": [{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "occurrences": 293
        },{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "register",
                "occurrences": 57
        },{
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "occurrences": 146
        },{
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "register",
                "occurrences": 31
        }]
}

对于特定的应用程序事件，按活动设备排序的前5个国家的有效设备和新设备（2天）：

Request:

https://api-metrics.flurry.com/public/v1/data/appEvent/day/app/country?metrics=activeDevices,newDevices&dateTime=2016-07-01/2016-07-03&filters=app|name-in[foo],event|name-in[login]&topN=5&sort=activeDevices|desc

Response:

{
        "rows": [{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "United States",
                "occurrences": 515
        },{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "United Kingdom",
                "occurrences": 210
        },{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "Canada",
                "occurrences": 165
        },{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "Germany",
                "occurrences": 87
        },{
                "dateTime": "2016-07-01 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "France",
                "occurrences": 46
        },{
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "United States",
                "occurrences": 435
        },{
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "United Kingdom",
                "occurrences": 190
        },{
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "Canada",
                "occurrences": 127
        },{
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "Germany",
                "occurrences": 76
        },{
                "dateTime": "2016-07-02 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "country|name": "France",
                "occurrences": 39
        }]
}

App Event Parameter Data

Table: <a id="eventParams">eventParams</a>

示例：app 事件参数指标查询

对于特定的应用程序事件，提供1天的事件参数值细目：

Request:

https://api-metrics.flurry.com/public/v1/data/eventParams/day/app;show=all/event/paramName/paramValue?metrics=count&filters=app|name-in[foo],event|name-in[level_complete]&dateTime=2016-11-07/2016-11-08

Response:

{
        "rows": [{
                "dateTime": "2016-11-07 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "level_complete",
                "paramName|name": "level",
                "paramValue|name": "1",
                "count": 32
        },{
                "dateTime": "2016-11-07 00:00:00.000-07:00",
                "app|name": "foo",
                "event|name": "login",
                "paramName|name": "level",
                "paramValue|name": "2",
                "count": 15
        }]
}

Real Time App Data 实时数据

Table: <a id="realtime">realtime</a> (最近 48 小时)

示例：实时指标查询，仅限48小时

对于特定应用程序，会话和活动设备在特定时间内：

Request:

https://api-metrics.flurry.com/public/v1/data/realtime/hour?metrics=sessions,activeDevices&dateTime=2016-08-27T12/2016-08-27T13&filters=app|name-in[foo]

Response:

{
        "rows": [{
                "dateTime": "2016-08-31 12:00:00.000-07:00",
                "app|name": "foo",
                "sessions": 145,
                "activeDevices": 90
        }]
}

对于特定应用程序，在特定24小时内（不是日期边界），区分应用程序版本的会话总数和活动设备：

Request:

https://api-metrics.flurry.com/public/v1/data/realtime/all/app/appVersion?metrics=sessions,activeDevices&dateTime=2016-08-31T12/2016-09-01T13&filters=app|name-in[appname]

Response:

{
        "rows": [{
                "dateTime": "2016-08-31 12:00:00.000-07:00",
                "app|name": "foo",
                "appVersion|name": "1.0",
                "sessions": 231,
                "activeDevices": 87
        },{
                "dateTime": "2016-08-31 12:00:00.000-07:00",
                "app|name": "foo",
                "appVersion|name": "1.1",
                "Sessions": 345,
                "activeDevices": 167
        }]
}

Error

详见原文。

官方文档：https://developer.yahoo.com/flurry/docs/api/code/analyticsapi/

如果有什么建议或者问题可以随时联系我，共同探讨学习：

• Github： likfe
• CSDN：他叫自己Mr.张
• 掘金：cafeting
• 微博：cafeting