"GoogleAnalytics" (服务连接)

通过 Wolfram 语言连接到 Google Analytics API 来检索和分析网络数据.

连接与验证

ServiceConnect["GoogleAnalytics"] 创建至 Google Analytics API 的连接.

要求

ServiceExecute["GoogleAnalytics","request",params] 使用参数 params，给 Google Analytics API 发送请求. 以下给出了可能的请求.

网站人数的报表数据

要求：

"ReportData" — 检索网站人数的数据

参数：
  • "ProfileID"(required)与要求的数据相关的 Analytics view (profile) ID
    "StartDate"(required)请求需要开始日期；接受 DateObject 和字符串
    "EndDate"(required)请求需要截止日期；接受 DateObject 和字符串
    "Metrics"(required)用于指定度量法的字符串列表，如 "Sessions" 或 "Users"
    "Dimensions"None用于指定维度的字符串列表，如 "Hour" 或 "Day"
    "Sort"None指明排序顺序的维度和度量法列表；在改变排序方向的元素之前使用 "-"
    "Filters"None限制返回给您的请求的数据的维度和度量法的过滤器
    "Segment"None分割返回给您的请求的数据；接受整数的 Segment ID
    "SamplingLevel""Default""Default"、 "Faster" 和 "HigherPrecision" 所需的抽样水准
    "StartIndex"1开始索引
    MaxItems1000返回的元素数目
    "UserIP"None指定发出 API 调用的终端用户的 IP 地址
    "QuotaUser"None用户的 IP 地址未知时转换成 "UserIP"

    • "Filters" 参数允许使用 List 中的元素来表示它们之间的“与”算符（"Metrics" 和 "Dimensions"不能以这种方式结合）. Alternatives 用于表示“或”算符.

    度量法和维度

    要求：

    "Metrics" — 获取按类别的可用度量法列表

    "Dimensions" — 获取按类别的的可用维度列表

    参数：
  • "Category"All按类别过滤

    • Using ServiceExecute["GoogleAnalytics","Metrics","Categories"] 显示 "Metrics" 和 "Dimensions" 的所有可用类别.

    所有数据

    要求：

    "AllData" — 检索包括原始输出在内的所有信息

    参数：
  • "ProfileID"(required)与请求数据相关的 Analytics view (profile) ID
    "StartDate"(required)请求需要开始日期；接受 DateObject 和字符串
    "EndDate"(required)请求需要截止日期；接受 DateObject 和字符串
    "Metrics"(required)用于指定度量法的字符串列表，如"Sessions" 或 "Users"
    "Dimensions"None用于指定维度的字符串列表，如 "Hour" 或 "Day"
    "Sort"None指出排序顺序的维度和度量法的列表；在改变排序方向的元素前使用 "-"
    "Filters"None限制您的请求的返回数据的维度或度量法过滤
    "Fields"None较少包含在输出中的字段
    "Segment"None分割返回给您的请求的数据；接受整数 Segment ID
    "SamplingLevel""Default""Default"、 "Faster" 和 "HigherPrecision" 所需的抽样水准
    "StartIndex"1开始索引
    MaxItems1000要返回的元素数
    "UserIP"None指定发出 API 调用的终端用户的 IP 地址
    "QuotaUser"None用户的 IP 地址未知时转换成 "UserIP"

    • 参数细节

    与 "Filters" 参数共同使用的 "Metrics" 的可能运算符包括：
  • "metric""value"等于
    "metric"Except["value"]不等于
    "metric">"value"大于
    "metric"<"value"小于
    "metric"≥"value"大于等于
    "metric"≤"value"小于等于
    • 与 "Filters" 参数共同使用的 "Dimensions" 的可能运算符包括：
  • "dimension""value"准确匹配
    "dimension"Except["value"]不匹配
    "dimension"⊃"value"包含子字符串
    "dimension"⊅"value"不包含子字符串
    "dimension"RegularExpression["value"]包含正则表达式的匹配
    "dimension"RegularExpression[Except["value"]]不匹配正则表达式

    • 范例

    基本范例  (4)

    创建一个新的连接：

    获取给定 "ProfileID" 的维度和度量法：

    使用 "ReportData" 获取给定 "ProfileID" 的 "Dimensions" 和 "Metrics" 数据：

    使用 "Sort" 通过选定的 Keys 排序. 排序方向可以通过在选定键前使用 "-" 来改变：

    通过用户数过滤结果：

    通过多个限制进行过滤；AND 运算符通过 List 中的元素表示：

    OR 运算符通过 Alternatives 表示：

    "AllData" 返回所有与询问相关的数据. Key "Rows" 包含 "ReportData" 的结果：