REST Resource: properties.calculatedMetrics

リソース: CalculatedMetric

計算指標の定義。

JSON 表現
{
  "name": string,
  "description": string,
  "displayName": string,
  "calculatedMetricId": string,
  "metricUnit": enum (MetricUnit),
  "restrictedMetricType": [
    enum (RestrictedMetricType)
  ],
  "formula": string,
  "invalidMetricReference": boolean
}
フィールド
name

string

出力専用。この CalculatedMetric のリソース名。形式: 'properties/{property_id}/calculatedMetrics/{calculatedMetricId}'

description

string

省略可。この計算指標の説明。最大長は 4,096 文字です。

displayName

string

必須。Google アナリティクスの管理画面に表示されるこの計算指標の表示名。最大文字数は 82 文字です。

calculatedMetricId

string

出力専用。計算指標に使用する ID。UI では、この名前を「API 名」と呼びます。

predictedMetricId は、外部 API からこの計算指標を参照する際に使用されます。例: 「calcMetric:{calculatedMetricId}」

metricUnit

enum (MetricUnit)

必須。計算指標の値のタイプ。

restrictedMetricType[]

enum (RestrictedMetricType)

出力専用。この指標に含まれる制限付きデータの種類。

formula

string

必須。計算指標の定義。参照される一意のカスタム指標の最大数は 5 です。数式では、+(加算)、-(減算)、-(負)、*(乗算)、/(除算)、()(かっこ)の演算がサポートされています。Long(64 ビットの整数)または Double(64 ビットの浮動小数点数)に収まる有効な実数であれば、何でも構いません。数式の例: 「( customEvent:parameterName + cartPurchaseQuantity ) / 2.0」

invalidMetricReference

boolean

出力専用。true の場合、この計算指標には無効な指標参照が含まれています。InvalidMetricReference が true に設定された計算指標を使用すると、処理に失敗したり、警告が表示されたり、予期しない結果が生じたりする可能性があります。

MetricUnit

計算指標の値を表すタイプ。

列挙型
METRIC_UNIT_UNSPECIFIED MetricUnit が指定されていないか、存在しません。
STANDARD この指標ではデフォルトの単位が使用されます。
CURRENCY この指標は通貨を測定します。
FEET この指標はフィートを測定します。
MILES この指標はマイルを測定します。
METERS この指標はメートルを測定します。
KILOMETERS この指標はキロメートルを測定します。
MILLISECONDS この指標はミリ秒単位で測定されます。
SECONDS この指標は秒数を測定します。
MINUTES この指標は分を測定します。
HOURS この指標は時間を測定します。

RestrictedMetricType

計算指標のデータにマークを付けるためのラベルです。費用指標や収益指標へのアクセスを制限するユーザーロールと組み合わせて使用されます。

列挙型
RESTRICTED_METRIC_TYPE_UNSPECIFIED タイプが不明または未指定です。
COST_DATA 指標レポートの費用データ。
REVENUE_DATA 指標レポートの収益データ

メソッド

create

計算指標を作成します。

delete

プロパティの CalculatedMetric を削除します。

get

単一の CalculatedMetric のルックアップ。

list

プロパティの計算指標を一覧表示します。

patch

プロパティの CalculatedMetric を更新します。