前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Flurry 分析 API 中文教程(Flurry Analytics API)

Flurry 分析 API 中文教程(Flurry Analytics API)

作者头像
他叫自己MR.张
发布2020-05-28 15:24:26
2.2K0
发布2020-05-28 15:24:26
举报
文章被收录于专栏:Android必知必会

如果移动端访问不佳,请使用 ==> Github Pages 版。

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

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

初期准备

示例:

Headers:

代码语言:javascript
复制
Authorization: Bearer xxxxxx

API 基础

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

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

代码语言:javascript
复制
endPoint/table/timeGrain/dimension1/dimension2;show=all/dimension3{...}?metrics=[comma-separated-metrics]&dateTime=[..]&filters=[...]&topN=[..]&sort=[..]&having=[..]&format=[..]&timeZone=[..]

参数表及示例详见原文。

参数

必要

例子

endpoint

v1: https://api-metrics.flurry.com/public/v1/data/

table

appUsage、appEvent、 eventParams、realtime

timeGrain

见表详情内容

dimension

见表详情内容

metrics

见表详情内容

dateTime

Format for Day, Week: YYYY-MM-DD/YYYY-MM-DD Format for Month: YYYY-MM/YYYY-MM Format for Hour: YYYY-MM-DDTHH/YYYY-MM-DDTHH (HH in 24- hour format) follows ISO 8601

filters

组合的一个或多个维度属性过滤器(使用 AND)以减少输出以匹配您的条件。 id和name可用于所有维度。 一些维度具有在维度部分中调用的附加属性。格式: dimension1 | attribute-operator [ value(s) ], dimension2 | attribute-operator [ value(s) ]运算符: in, notin, contains, startsWith例如: country | name-in [‘United States’,‘Canada’,’Mexico’] ,appVersion | name-in[‘2.3’]

sort

指定一个或多个指标来排序结果。 如果未指定顺序,则默认为降序。例如: sort=sessions | desc,activeDevices | desc

topN

减少结果以匹配此参数指定的数字。 如果使用此参数,则还必须使用排序来指示必须计算顶点 n 的度量和顺序例如:topN=5 & sort=sessions | desc

having

减少结果以匹配指定的指标标准。 您可以组合多个指标标准。格式:metric-operator[value(s)] 可用运算符:等于(eq),大于(gt),小于(lt),而不是版本例子:sessions-gt[1000],activeDevices-gt[200]

format

json (默认), csv

timeZone

默认的结果是UTC时区。 要获取所需时区的结果,请使用此参数。例如: America/New_York 或 America/Los_Angeles

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

Analytics Metrics 分析指标

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

Metric 指标

描述

sessions

用户访问应用程序的次数

activeDevices

访问应用程序的唯一设备

newDevices

安装并启动应用程序的新设备

timeSpent

用户花在应用程序中的时间

averageTimePerDevice

平均每个用户在应用程序中花费的时间

averageTimePerSession

平均用户在应用程序每个会话中花费的时间

Analytics Dimensions 分析范围、维度

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

Dimensions范围、维度

描述

company

Flurry company account

id, name (默认)

app

Flurry app

id, name (默认), company|id, apiKey, platform|id, platform|name

country

每个国家的维度总计

id, name (默认), iso

appVersion

应用程式的版本号,名称,公司编号,应用程式编号,已删除和筛选。 删除和过滤是布尔值(0或1),并根据开发人员对Flurry开发人员门户的操作反映应用程序版本的当前状态

id, name (默认), company|id, app|id, deleted, filtered

language

Language id and name

id, name (默认)

region

地区:Region id and name

id, name (default)

category

分类: App category id and name

id, name (default)

event

仅适用于appEvent表; 事件ID,名称,应用ID,公司ID,删除和过滤。 删除和过滤是布尔值(0或1),并根据开发人员对Flurry开发人员门户的操作反映应用程序事件的当前状态。

id, name (default) , company|id, app|id, deleted, filtered

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

代码语言:javascript
复制
https://api-metrics.flurry.com/public/v1/data/appUsage/day/company/app;show=name,apiKey?metrics=...

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

代码语言:javascript
复制
;show=all
or
;show=id  (any other value listed in the value column above for the given dimension

添加维度名称之后:

代码语言:javascript
复制
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: appUsage

Metrics 指标

Dimensions 范围

Time Grain

sessions

company

day

activeDevices

app

week

newDevices

appVersion

month

timeSpent

country

all

averageTimePerDevice

language

averageTimePerSession

region

medianTimePerSession

category

示例:关键应用指标查询

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

Request 请求:

代码语言:javascript
复制
https://api-metrics.flurry.com/public/v1/data/appUsage/day/app?metrics=sessions,activeDevices,newDevices&dateTime=2016-07-01/2016-07-03

Response 响应:

代码语言:javascript
复制
{
        "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:

代码语言:javascript
复制
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:

代码语言:javascript
复制
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:

代码语言:javascript
复制
{
        "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: appEvent

Metrics 指标

Dimensions 范围

Time Grain

activeDevices

company

day

newDevices

app

week

eventDuration

appVersion

month

averageTimePerDevice

country

all

averageTimePerSession

language

medianTimePerSession

region

occurrences

category

event

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

对于特定应用程序事件,应用程序版本的事件发生次数(2天):

Request:

代码语言:javascript
复制
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:

代码语言:javascript
复制
{
        "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:

代码语言:javascript
复制
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:

代码语言:javascript
复制
{
        "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: eventParams

Metrics

Dimensions

Time Grain

count

company

day

app

week

appVersion

month

country

all

language

region

category

event

paramName

paramValue

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

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

Request:

代码语言:javascript
复制
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:

代码语言:javascript
复制
{
        "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: realtime (最近 48 小时)

Metrics

Dimensions

Time Grain

sessions

company

hour

activeDevices

app

day

appVersion

all

country

示例:实时指标查询,仅限48小时

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

Request:

代码语言:javascript
复制
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:

代码语言:javascript
复制
{
        "rows": [{
                "dateTime": "2016-08-31 12:00:00.000-07:00",
                "app|name": "foo",
                "sessions": 145,
                "activeDevices": 90
        }]
}

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

Request:

代码语言:javascript
复制
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:

代码语言:javascript
复制
{
        "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/

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2019/07/13 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 初期准备
  • API 基础
    • Analytics Metrics 分析指标
      • Analytics Dimensions 分析范围、维度
      • App Usage Data 应用使用的数据
      • App Events Data
      • App Event Parameter Data
      • Real Time App Data 实时数据
      • Error
      领券
      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档