Google Analytics(分析)电子表格插件

Philip Walton,Google Analytics(分析)开发者计划工程师 - 2014 年 3 月

借助 Google Analytics(分析)电子表格插件,Google Analytics(分析)用户可以更轻松地在 Google 电子表格中访问、共享、操作和直观呈现数据。

简介

Google Analytics(分析)电子表格插件可为您提供 Google Analytics(分析)API 的强大功能,以及 Google 电子表格中的数据操作功能。通过此工具,您可以:

  • 从多个数据视图查询和报告数据。
  • 计算和显示自定义计算。
  • 创建可视化并将其嵌入第三方网站。
  • 安排定期自动生成和更新报告。
  • 使用 Google 表格的共享和隐私保护功能控制哪些人可以查看您的数据和可视化图表。
Google Analytics(分析)电子表格插件pingmujie

视频教程

以下这两个视频介绍了如何下载和安装该插件,以及如何构建可自动更新且可嵌入第三方网站的信息中心。

Google Analytics(分析)电子表格插件简介

使用 Google Analytics(分析)电子表格插件构建信息中心

安装插件

要使用 Google Analytics(分析)插件,您必须首先将其添加到您的电子表格中。以下说明将逐步引导您完成整个guoc

  1. 创建新的 Google 电子表格(或打开现有的电子表格)。
  2. 从菜单栏中选择以下选项:“插件”>“获取插件…”
  3. 从插件库中找到 Google Analytics(分析)插件,并将其选中。
  4. 在插件说明页上,点击右上角的“+”即可将此插件添加到您的电子表格中。
  5. 此时会弹出一个对话框,要求您授予许可,以便插件能够访问您的 Google Analytics(分析)数据。点击“接受”。
  6. 插件现已安装完毕,此时“插件”菜单中会出现“Google Analytics(分析)”子菜单。

创建报告

您可以手动创建报告,也可以在插件的报告创建工具的帮助下创建报告。 如需使用该工具,请从菜单栏中选择“插件”、“Google Analytics(分析)”和“创建新报告”。 此时右侧将显示一个边栏,可让您轻松查找 Google Analytics(分析)帐号信息,并选择要查询的维度和指标。完成操作后,点击“创建报告”按钮,您的报告信息便会显示在一个名为“报告配置”的工作表中(如果该工作表之前并不存在,系统创建它)。

要创建其他报告,只需重复上述步骤即可。您每创建一份新报告,系统就会在上一份报告的右侧新增一列数据。

如果您查看报告创建工具在报告配置工作表中输入的值,就会发现单元格都已留空。这是有意而为的。该工具旨在帮助您快速上手,并为您提供您可能无法随时想起的信息。其余字段需要由您来输入内容。如果您对要在每个字段中输入的内容有疑问,请参阅本页面底部的参考说明

生成报告

要生成您创建的所有报告,请从菜单栏中选择“插件”>“Google Analytics(分析)”>“生成报告”

排除报告

默认情况下,插件将生成所有带名称的报告,因此,如果您想排除某个报告而不将其删除,只需删除相应名称值所在的单元格中的所有文本。

选择输出工作表

生成报告时,系统将向 Google Analytics(分析)API 发送请求,并将结果记录在您选择的工作表中。它可以是您目前使用的电子表格中的某个工作表,也可以是另一个完全不同的电子表格(只要您拥有该电子表格的修改权限)。要在不同的电子表格中记录请求结果,请复制该电子表格的网址,然后将其粘贴到“spreadsheet-url”参数右侧的单元格中。

安排定期自动生成报告

您可以从菜单栏中选择“插件”>“Google Analytics(分析)”>“定期生成报告”,以启用自动生成报告功能。此操作将打开一个定期生成报告对话框,您可以在其中启用和停用定期生成功能,并设置报告生成频率。

要启用定期生成功能,请选中标有“启用报告自动生成”的框。启用定期生成功能后,您可以使用选择下拉菜单来控制其生成时间和频率。您可以将报告安排为每小时、每天、每周或每月定期生成。

要停用定期生成功能,请取消选中标有“启用报告自动生成”的框。

常见使用场景

查询多个数据视图中的数据

通过 Google Analytics(分析)网页界面,您一次只能在一个视图中查看报告和可视化图表数据。借助此插件,您可以生成任意数量的数据视图的报告,并且可以根据需要以任何方式使用生成的数据。例如,如果您有一个跟踪 iOS 流量的数据视图,还有一个用于跟踪 Android 流量的数据视图,则可以使用此插件在同一数据视图中针对这两个数据视图生成报告,并轻松地将结果并排比较。

使用 Google Analytics(分析)数据创建自定义计算方法

Google Analytics(分析)API 可收集大量不同类型的数据,并为您提供关于数据报告方式的多种选择,但有时您需要使用特定的计算方法。当您的数据显示在 Google 电子表格中时,您就可以利用电子表格内置的数据操作功能。

创建具有嵌入式数据可视化图表的信息中心

当您的数据显示在 Google 电子表格中时,您可以充分利用 Google 为您提供的所有现成的可视化工具。此外,Google 电子表格图表可嵌入到外部网站中。 这意味着您可以轻松创建包含 Google Analytics(分析)数据图表的信息中心,并将其托管在您需要的任何位置,并且报告会在您生成报告时自动更新。

轻松控制能够查看您的 Google Analytics(分析)数据的用户

Google Analytics(分析)网站可让您一目了然地查看您的数据的深入信息,但是,有时您需要在不向利益相关方提供您 Google Analytics(分析)帐户的访问权限的情况下,与他们共享您的数据。

借助 Google Analytics(分析)电子表格,您可以轻松解决这一问题,因为 Google 电子表格拥有自己的内置权限系统。只需创建新的电子表格,向相应的用户授予访问权限,然后将报告数据输出到该电子表格中即可。

自动更新数据和可视化图表

您在第三方网站上创建报告或嵌入可视化图表后,可以安排定期自动生成报告,以确保数据始终是最新的。

常见问题解答

我如何知道定期生成的报告下一次何时生成?

定期生成的报告将在您指定的时间段内随机首次生成。后续运行将在同一时间以可预测的方式进行,并以您选择的间隔进行偏移。例如,如果您安排在每天凌晨 4 点到凌晨 5 点之间定期生成报告,并且第一次生成发生在凌晨 4:12,那么所有后续的生成操作也将在凌晨 4:12 进行。

我的定期生成报告没有在预期的时间生成,是失效了吗?

在设置定期生成报告时,请确保您在创建定期生成时间后,留出足够的时间供报告在预期时间生成。如果报表的时间太接近第一次生成时间,这些报表就有可能推迟到下一次生成时间。通常最好留出一小时的时间间隔。

我可以为不同的报告设置不同的定期生成时间吗?

定期生成时间适用于所有报告或无报告。 如果您需要按不同的时间间隔安排不同的报告,则可以使用多个电子表格。

为什么我的报告数据格式有误?

Google Analytics(分析)Reporting API 会返回采用美国格式的所有值。 如果您的电子表格已设置为其他语言区域,Google 表格会尝试为您转换,而有时会导致意外结果。

为避免此问题,请确保将报告电子表格的语言区域设置为“美国”(如需更改电子表格的语言区域说明,请参阅文档编辑器帮助)。然后,为了将您的数据转换为首选语言区域的格式,您可以创建包含首选语言区域设置的第二个电子表格,并使用 IMPORTRANGE 函数将报告数据导入这个新电子表格。从一个电子表格导入另一个电子表格时,Google 表格可以在语言区域之间正确转换格式。

获取帮助

要询问关于该插件的问题或报告 bug,请在 google-analytics-spreadsheet-add-on Google 网上论坛中发帖。在发帖之前搜索群组,因为您的问题可能已有答案。

配置参数说明

以下各部分概述了必需、可选和隐藏的参数:

  • 每个报告都必须包含必需参数,否则报告将会出错。
  • 可选参数不是必需的,但可以指定。
  • 隐藏参数是大多数报告不需要的高级选项,默认情况下处于隐藏状态。您可通过在“报告配置”表格中取消隐藏第 14-16 行来使用这些参数。

必需参数

名称 说明
报告名称 此值为报告名称。它也是写入报告数据的工作表的名称。
数据视图 ID 您的 Google Analytics(分析)数据视图的 ID。您可以使用报告创建工具获取此值,也可以在 Google Analytics(分析)帐号管理员中找到此值。
开始日期

获取 Google Analytics(分析)数据的开始日期。请求可以指定格式为 YYYY-MM-DD 的开始日期,也可以指定相对日期(例如,todayyesterdayNdaysAgo,其中 N 是正整数)。

您还可以使用 Google 表格日期函数以编程方式指定此值。例如,以下表达式会返回上个月的最后一天:

=EOMONTH(TODAY(), -1)
结束日期

用于提取 Google Analytics(分析)数据的结束日期。请求可以指定格式为 YYYY-MM-DD 的结束日期,也可以指定相对日期(例如,todayyesterdayNdaysAgo,其中 N 是正整数)。

您还可以使用 Google 表格日期函数以编程方式指定此值。例如,以下表达式会返回上个月的最后一天:

=EOMONTH(TODAY(), -1)
指标

要查询的指标列表。可以采用以下两种格式之一指定指标:

例如,以下所有值均为 Metrics 参数的有效值。

ga:sessions,ga:bounces
ga:sessions
ga:bounces
[{
  "expression": "ga:sessions/ga:users",
  "alias": "Sessions per User",
  "formattingType": "FLOAT"
}, {
  "expression": "ga:totalEvents/ga:pageviews",
  "alias": "Events per Pageview",
  "formattingType": "FLOAT"
}]

对于大多数用例,使用指标 ID 列表是指定 Metrics 参数的最简单方法。但是,如果您希望利用 Analytics 报告 API 的高级功能(例如上述第三个示例中的指标表达式),则必须将值指定为 JSON。

如需查看维度和指标的完整组合及其有效的组合,请使用维度和指标浏览器

可选参数

名称 说明
维度

要查询的维度列表。您可以指定以下两种格式之一:

例如,以下所有值均为 Metrics 参数的有效值。

ga:source,ga:deviceCategory
ga:source
ga:deviceCategory
[{
  "name": "ga:source"
}, {
  "name": "ga:deviceCategory"
}]

对于大多数用例来说,使用维度 ID 列表是指定维度参数的最简单方法。

如需查看维度和指标的完整组合及其有效的组合,请使用维度和指标浏览器

排序

结果的排序顺序,按列(指标 ID 或维度 ID)和方向(升序或降序)排序。可以按照以下两种格式之一指定顺序:

例如,以下所有值均为 Order 参数的有效值。

-ga:sessions,ga:eventLabel
-ga:sessions
ga:eventLabel
[{
  "fieldName": "ga:sessions",
  "sortOrder": "DESCENDING"
}, {
  "fieldName": "ga:eventLabel",
  "sortOrder": "ASCENDING",
  "orderType": "DIMENSION_AS_INTEGER"
}]

对于大多数用例,用旧格式是指定 Order 参数的最简单方法。但是,如果您要使用 orderType 参数,则必须将值指定为 JSON。

过滤条件

用于限制返回的结果集的条件。过滤器可以采用以下两种格式之一:

例如,以下任何值均为 Filters 参数的有效值。

ga:sessions>10;ga:country==United States
{
  "metricFilterClauses": [{
    "filters": [
      {
        "metricName": "ga:totalEvents",
        "operator": "GREATER_THAN",
        "comparisonValue": "100"
      }
    ]
  }],
  "dimensionFilterClauses": [{
    "operator": "AND",
    "filters": [
      {
        "dimensionName": "ga:eventCategory",
        "operator": "EXACT",
        "expressions": ["Outbound Link"]
      }
    ],
    "filters": [
      {
        "dimensionName": "ga:eventAction",
        "operator": "EXACT",
        "expressions": ["click"]
      }
    ]
  }]
}

对于大多数用例,旧式格式是指定 Filters 参数的最简单方法。但是,如果您需要执行高级过滤(例如,对维度使用比较运算符),则必须将该值指定为 JSON。

细分

通过设置条件,您可以限制查询所适用的会话或用户集。可以采用以下两种格式之一指定细分:

例如,细分受众群参数的有效值包括以下任意一项。

gaid::-1,sessions::condition::ga:city==New York
gaid::-1,
sessions::condition::ga:city==New York
[{
  "dynamicSegment": {
    "name": "New York Sessions",
    "sessionSegment": {
      "segmentFilters": [{
        "simpleSegment": {
          "orFiltersForSegment": [{
            "segmentFilterClauses":[{
              "dimensionFilter": {
                "dimensionName": "ga:city",
                "expressions": ["New York"]
              }
            }]
          }]
        }
      }]
    }
  }
}, {
  "dynamicSegment": {
    "name": "Non-referral Sessions",
    "sessionSegment": {
      "segmentFilters": [{
        "simpleSegment": {
          "orFiltersForSegment": [{
            "segmentFilterClauses": [{
              "dimensionFilter": {
                "dimensionName": "ga:medium",
                "operator": "EXACT",
                "expressions": [ "referral" ]
              }
            }]
          }]
        },
        "not": "True"
      }]
    }
  }
}]

对于大多数用例,最简单的方法是指定细分 ID 或使用旧版定义格式。但是,如果您需要执行高级细分(例如,对维度使用比较运算符),则必须将该值指定为 JSON。

限额

将为报告返回的结果数上限。如果将此参数留空,系统会返回所有结果。

电子表格网址 输出结果的外部电子表格的网址。默认情况下,系统会将结果输出到当前电子表格中的工作表。请注意,您必须拥有电子表格的编辑权限,才能使用此功能。
跳过报告

如果值为 TRUE,则系统不会生成相应列中的报告。如果您正在使用新报告进行实验,但在完成前不想生成所有报告,此选项会非常有用。此外,如果您想停止生成已存在且数据不会发生变化的报告,此视图也很有用。

请注意,可以使用公式以编程方式设置此字段。例如,如果结束日期(单元格“B5”)是过去的日期,则以下表达式会跳过报告:

=IF(B5 < TODAY(), TRUE, FALSE)

隐藏的参数

名称 总结
报告类型

默认情况下(或留空时),此报告将查询 Analytics Reporting API v4。要查询 Multi-ChannelFunnel Reporting API,您可以将该值设置为“mcf”。

请注意,使用 MCF API 时,您还必须使用 MCF 维度和指标。此外,MCF 报告中不提供部分其他功能(如细分受众群)。

抽样级别 所需的报告样本大小。可能的值包括“DEFAULT”(与留空)、“SMALL”或“LARGE”。
使用资源配额 基于资源的配额系统是一种新的配额系统,可使某些 Analytics 360 帐号在使用 Analytics Reporting API 时具有更高的抽样最低限额。如果您有权使用此功能,则可以将此参数设置为 TRUE 来启用它。
排除空白行

使用此参数,您可以从报告中排除相应行中的所有指标值为零的行。默认行为(或留空)会显示所有行(推荐)。

请注意,此参数与 Analytics Reporting API v4includeEmptyRows 参数相对应,但已从“包含”重命名为“排除”,以便更易于理解。