REST Resource: properties.customMetrics

资源:CustomMetric

自定义指标的定义。

JSON 表示法
{
  "name": string,
  "parameterName": string,
  "displayName": string,
  "description": string,
  "measurementUnit": enum (MeasurementUnit),
  "scope": enum (MetricScope),
  "restrictedMetricType": [
    enum (RestrictedMetricType)
  ]
}
字段
name

string

仅供输出。此 CustomMetric 资源的资源名称。格式:properties/{property}/customMetrics/{customMetric}

parameterName

string

必需。不可变。此自定义指标的标记名称。

如果此指标为事件级范围的指标,则此参数为事件参数名称。

只能包含字母数字和下划线字符,以字母开头。事件级范围的指标的长度上限为 40 个字符。

displayName

string

必需。此自定义指标的显示名称,显示在 Google Analytics(分析)界面中。长度上限为 82 个字符,包括字母数字字符、空格和下划线(以字母开头)。系统生成的旧版显示名称可能包含方括号,但对此字段的更新不允许使用方括号。

description

string

可选。此自定义维度的说明。长度上限为 150 个字符。

measurementUnit

enum (MeasurementUnit)

必需。自定义指标值的类型。

scope

enum (MetricScope)

必需。不可变。此自定义指标的范围。

restrictedMetricType[]

enum (RestrictedMetricType)

可选。此指标可能包含的受限数据的类型。对于采用 CURRENCY 度量单位的指标,此字段必填。对于采用非 CURRENCY 衡量单位的指标,必须为空。

MeasurementUnit

表示自定义指标值的可能类型。

货币表示方式在将来可能会发生变化,因此需要进行重大的 API 更改。

枚举
MEASUREMENT_UNIT_UNSPECIFIED MeasurementUnit 未指定或缺失。
STANDARD 此指标使用默认单位。
CURRENCY 该指标用于衡量货币。
FEET 该指标以英尺为单位。
METERS 该指标测量米。
KILOMETERS 该指标以公里为单位。
MILES 此指标以英里为单位。
MILLISECONDS 此指标以毫秒为度量单位。
SECONDS 此指标用于衡量秒数。
MINUTES 此指标用于衡量分钟数。
HOURS 该指标用于衡量小时数。

MetricScope

此指标的范围。

枚举
METRIC_SCOPE_UNSPECIFIED 范围未知或未指定。
EVENT 指标范围限定为事件。

RestrictedMetricType

用于将此自定义指标中的数据标记为应仅限特定用户查看的标签。

枚举
RESTRICTED_METRIC_TYPE_UNSPECIFIED 类型未知或未指定。
COST_DATA 指标报告费用数据。
REVENUE_DATA 指标报告收入数据。

方法

archive

对媒体资源的 CustomMetric 进行归档。

create

创建自定义指标。

get

查找单个自定义指标。

list

列出媒体资源的 CustomMetrics。

patch

更新媒体资源的 CustomMetric。