作者丨唐至清
全文共1474字 阅读时间:5分钟
GA Reporting API(本文简称:GA API)以程序化的方式获取GA报告中的数据,借助于GA API,你可以将GA中的数据集成到其他业务应用,例如自动化报告、自定义的仪表盘、CRM系统、BI系统等。本篇文章将为您介绍如何启用GA API以及怎么访问GA API获取GA报表的数据。 (说明:文章中使用示例是最新版本:Analytics Reporting API v4 ,您可以继续使用v3或更早的版本,但v4的功能集更丰富,如生命周期价值、同类群组以及高级细分报告。)
一、启用API
在开始使用 API 之前,您需要先在 Google APIs 平台中创建项目,启用 API 以及创建凭据。如果您不知道如何下手,可以直接使用谷歌为您提供的设置工具,该工具会引导您进行相关设置。 Google APIs 平台地址: https://console.developers.google.com/apis/ 设置工具地址: https://console.developers.google.com/start/api?id=analyticsreporting.googleapis.com&credential=client_key 其中创建GA API授权(即创建凭据)有3种方式:API密钥、OAuth2.0客户端ID以及服务账号密钥。- API密钥是一种简单通用的方式,但是需要定时验证,不符合我们高效自动化获取数据的目标。
- OAuth2.0客户端ID大多应用于应用的访问,例如Web端应用、安卓应用、iOS应用,以及Chrome插件等。
- 服务账号密钥通常应用于服务期间的数据传输。
下面重点介绍服务账号密钥这种方式的授权步骤和注意事项。
1.选择服务账号项,点击创建服务账号 2.在创建服务账号窗口中,输入服务账号名称,此时会自动生成服务账号ID 3.点击创建密钥 密钥的类型有两种:JSON和P12,官方推荐使用JSON。创建完成后,JSON文件将自动下载到您本地。 4.将服务账号ID添加到GA账号中 这一步骤重点强调一下,假如您的GA账号拥有查看编辑等权限,并不代表您的服务账号同样具有GA的访问权限。
如果不在GA中添加服务账号,访问API时会出现“User does not have any Google Analytics account”错误。
当然,添加账号的前提是您的GA账号权限需要拥有用户管理权限,否则将无法添加。
二、访问GA API获取数据
谷歌提供了多种常用语言的GA API客户端,让您可以轻松获取GA数据。本文将以Python为例,介绍如何使用Python访问访问GA API获取数。 (由于篇幅限制,本文中只介绍了访问API的重要环节,完整代码示例可参考以下链接:https://developers.google.com/analytics/devguides/reporting/core/v4/quickstart/service-py) 1.首先使用pip工具安装python版API客户端库sudo pip install --upgradegoogle-api-python-client
2.设置初始化参数,连接服务
其中初始化参数的替换说明如下:
SCOPE: 设置成分析只读权限即可
KEY_FILE_LOCATION: 替换为您下载好的JSON密钥文件地址
VIEW_ID:被获取数据的GA视图ID
3.使用batchGet方法访问GA报告资源
要使用 Analytics Reporting API v4 请求数据,您必须构建 ReportRequest 对象,该对象需要满足以下这些最低要求:
用于 viewId 字段的有效数据视图 ID
dateRanges字段中至少有一个有效条目
metrics字段中至少有一个有效条目
以下是满足所需字段的请求示例:
如果您想更加高效灵活地获取到您想获取的GA数据,在构建batchGet的请求正文时,还需要进一步掌握常用的metrics、dimensions,过滤器、表达式、排序方式、细分等更多知识点的使用。
4. 解析API的返回结果
API 请求的如果成功响应,响应正文将会是一个JSON结构的对象。响应字段中包含了您查询报告的指标和维度的名称,指标和维度的值,返回的数据行,以及是否抽样、抽样数量等信息。根据您的具体需求,解析API的响应,获取您需要的数据即可。
最后,自动化获取GA数据的方式除了GA API之外,我们还可以使用BigQuery API,BigQuery的强大结构可以让您查看更加深入、更细粒度的匹配(hit)级数据。但是BigQuery API只限于GA 360用户,而GA API是GA标准用户目前可用的唯一的自动获取数据的方式。
结语
如果您想了解有关GA API抽样问题及最佳实践的内容,敬请期待作者的下一篇内容分享:《GA API抽样问题及最佳实践》,更多干货等你来!(全文完) # 学习让我们成为更好的自己 #
●三分钟带你了解Google Analytics
●掌握Google Analytics基础概念,抓住营销命脉(上)
●掌握Google Analytics基础概念,抓住营销命脉(下)
●掌握Google Analytics核心模块,抓住营销命脉(上)
●掌握Google Analytics核心模块,抓住营销命脉(下)
●GA的实际应用之目标设置看这里
●GA的过滤器应用
●GA的受众识别与用户画像
●GA再营销与动态再营销