数据访问架构

对 Google Analytics(分析)Admin API 的数据访问报告方法的查询中支持的维度和指标。

维度

您可以在数据访问报告中请求以下维度。在 AccessDimension 资源的维度 name 字段中为报告响应中的维度列指定“API 名称”。

API 名称 界面名称 允许的属性 说明
accessDateHour 访问日期(小时) 所有 Google Analytics(分析)媒体资源 访问 Google Analytics(分析)报告数据的 Google Analytics(分析)用户的日期(小时)。格式为 YYYYMMDDHH。
accessMechanism 访问机制 Google Analytics 360 媒体资源 Google Analytics(分析)用户访问 Google Analytics(分析)报告数据的机制。可能的值包括 Google Analytics User InterfaceGoogle Analytics APIFirebaseGoogle Ads 等。
accessedPropertyId 访问过的媒体资源 ID 所有 Google Analytics(分析)媒体资源 访问了 Google Analytics(分析)报告数据的媒体资源 ID。大多数数据访问报告只包含一项媒体资源,但如果所请求的媒体资源具有子媒体资源,则数据访问报告同时包含对来源媒体资源和子媒体资源的访问权限。如需详细了解子媒体资源,请参阅子媒体资源简介
accessedPropertyName 所访问的媒体资源名称 所有 Google Analytics(分析)媒体资源 访问 Google Analytics(分析)报告数据的媒体资源显示名称。大多数数据访问报告只包含一项媒体资源,但如果所请求的媒体资源具有子媒体资源,则数据访问报告同时包含对来源媒体资源和子媒体资源的访问权限。如需详细了解子媒体资源,请参阅子媒体资源简介
accessorAppName 访问者应用名称 所有 Google Analytics(分析)媒体资源 访问 Google Analytics(分析)报告数据的应用的名称。
costDataReturned 返回的费用数据 Google Analytics 360 媒体资源 如果此报告中返回了费用数据,则返回 true。否则,此维度会返回 false。具有 No Cost Metrics 限制的 Google Analytics(分析)用户无法看到费用指标。当该限制有效时,此维度将始终为 false。如需了解详情,请参阅访问权限和数据限制管理
dataApiQuotaCategory Data API 配额类别 所有 Google Analytics(分析)媒体资源 Data API 请求的配额类别。可能的值包括:CoreRealtimeFunnel
epochTimeMicros 纪元时间(以微秒为单位) Google Analytics 360 媒体资源 Google Analytics(分析)用户访问 Google Analytics(分析)报告数据的时间(自纪元以来的 unix 微秒)。例如,1655220215027371 的 unix 微秒为 2022-06-14 11:23:35(位于 America/New_York)。
mostRecentAccessEpochTimeMicros 最近访问纪元时间(以微秒为单位) Google Analytics 360 媒体资源 此行的最近访问时间戳。以自纪元以来的 unix 微秒返回。通常与 userEmail 及类似维度配合使用,以确定 Google Analytics(分析)用户的上次访问时间。
reportType 举报类型 Google Analytics 360 媒体资源 Google Analytics(分析)用户访问的报告数据类型。可能的值包括 ReportingRealtimeFree form explorationFunnel exploration 等。
revenueDataReturned 返回的收入数据 Google Analytics 360 媒体资源 如果此报告中返回了收入数据,则返回 true。否则,此维度会返回 false。受 No Revenue Metrics 限制的 Google Analytics(分析)用户无法看到收入指标。当该限制有效时,此维度将始终为 false。如需了解详情,请参阅访问权限和数据限制管理
userCountry 用户所在国家/地区 Google Analytics 360 媒体资源 访问 Google Analytics(分析)报告数据的 Google Analytics(分析)用户所在的国家/地区。
userCountryId 用户所在国家/地区 ID Google Analytics 360 媒体资源 访问了 Google Analytics(分析)报告数据的 Google Analytics(分析)用户的国家/地区 ID。格式遵循 ISO 3166-1 alpha-2 标准。
userEmail 用户的电子邮件地址 所有 Google Analytics(分析)媒体资源 访问了 Google Analytics(分析)报告数据的 Google Analytics(分析)用户的电子邮件地址。某些集成允许用户通过集成访问 GA 报告数据,而无需用户直接访问媒体资源;在这种情况下,例如,userEmail 将返回 Google Ads Linked User,具体取决于集成情况。
userIP 用户 IP Google Analytics 360 媒体资源 访问 Google Analytics(分析)报告数据的 Google Analytics(分析)用户的 IP。

指标

您可以在数据访问报告中请求以下指标。在 AccessMetric 资源的指标 name 字段中,为报告响应中指标列指定“API 名称”。

API 名称 界面名称 允许的属性 说明
accessCount 访问数量 Google Analytics 360 媒体资源 Google Analytics(分析)报告数据的访问次数。
dataApiQuotaPropertyTokensConsumed 已使用的数据 API 配额属性令牌 所有 Google Analytics(分析)媒体资源 返回 Data API 请求消耗的媒体资源配额令牌总数。