Coba server MCP untuk Google Analytics. Instal dari
GitHub, dan lihat
pengumuman untuk mengetahui detail selengkapnya.
REST Resource: properties.customMetrics
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: CustomMetric
Definisi untuk metrik kustom.
Representasi JSON |
{
"name": string,
"parameterName": string,
"displayName": string,
"description": string,
"measurementUnit": enum (MeasurementUnit ),
"scope": enum (MetricScope ),
"restrictedMetricType": [
enum (RestrictedMetricType )
]
} |
Kolom |
name |
string
Hanya output. Nama resource untuk resource CustomMetric ini. Format: properti/{property}/customMetrics/{customMetric}
|
parameterName |
string
Wajib. Tidak dapat diubah. Memberi tag pada nama untuk metrik kustom ini. Jika ini adalah metrik cakupan peristiwa, maka ini adalah nama parameter peristiwa. Hanya dapat berisi karakter alfanumerik dan garis bawah, yang dimulai dengan huruf. Panjang maksimal 40 karakter untuk metrik cakupan peristiwa.
|
displayName |
string
Wajib. Nama tampilan untuk metrik kustom ini seperti yang ditampilkan di UI Analytics. Panjang maksimal 82 karakter, alfanumerik plus spasi dan garis bawah yang dimulai dengan huruf. Nama tampilan lama yang dibuat sistem dapat berisi tanda kurung siku, tetapi pembaruan pada kolom ini tidak akan mengizinkan tanda kurung siku.
|
description |
string
Opsional. Deskripsi untuk dimensi kustom ini. Panjang maksimal 150 karakter.
|
measurementUnit |
enum (MeasurementUnit )
Wajib. Jenis untuk nilai metrik kustom.
|
scope |
enum (MetricScope )
Wajib. Tidak dapat diubah. Cakupan metrik kustom ini.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
Opsional. Jenis data yang dibatasi yang mungkin ada dalam metrik ini. Diperlukan untuk metrik dengan unit pengukuran CURRENCY. Harus kosong untuk metrik dengan unit pengukuran non-CURRENCY.
|
MeasurementUnit
Kemungkinan jenis representasi nilai metrik kustom.
Representasi mata uang dapat berubah di masa mendatang, sehingga memerlukan perubahan API yang dapat menyebabkan gangguan.
Enum |
MEASUREMENT_UNIT_UNSPECIFIED |
MeasurementUnit tidak ditentukan atau tidak ada. |
STANDARD |
Metrik ini menggunakan satuan default. |
CURRENCY |
Metrik ini mengukur mata uang. |
FEET |
Metrik ini mengukur kaki. |
METERS |
Metrik ini mengukur meter. |
KILOMETERS |
Metrik ini mengukur kilometer. |
MILES |
Metrik ini mengukur mil. |
MILLISECONDS |
Metrik ini mengukur milidetik. |
SECONDS |
Metrik ini mengukur detik. |
MINUTES |
Metrik ini mengukur menit. |
HOURS |
Metrik ini mengukur jam. |
MetricScope
Enum |
METRIC_SCOPE_UNSPECIFIED |
Cakupan tidak diketahui atau tidak ditentukan. |
EVENT |
Metrik yang dicakupkan ke peristiwa. |
RestrictedMetricType
Label yang menandai data dalam metrik kustom ini sebagai data yang harus dibatasi untuk pengguna tertentu.
Enum |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Jenis tidak diketahui atau tidak ditentukan. |
COST_DATA |
Metrik melaporkan data biaya. |
REVENUE_DATA |
Metrik melaporkan data pendapatan. |
Metode |
|
Mengarsipkan CustomMetric di properti. |
|
Membuat CustomMetric. |
|
Cari satu CustomMetric. |
|
Mencantumkan CustomMetrics pada properti. |
|
Memperbarui CustomMetric pada properti. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003eA \u003ccode\u003eCustomMetric\u003c/code\u003e defines custom metrics for data analysis within Google Analytics, allowing users to track specific events and parameters relevant to their business needs.\u003c/p\u003e\n"],["\u003cp\u003eThese metrics can be defined with various units of measurement (\u003ccode\u003eMeasurementUnit\u003c/code\u003e) including standard, currency, time, and distance, catering to diverse data types.\u003c/p\u003e\n"],["\u003cp\u003eThe scope of a custom metric can be specified (\u003ccode\u003eMetricScope\u003c/code\u003e) to be associated with an event, dictating the context in which the metric is collected.\u003c/p\u003e\n"],["\u003cp\u003eCustom metrics can also be designated as containing restricted data types such as cost or revenue (\u003ccode\u003eRestrictedMetricType\u003c/code\u003e) for enhanced privacy and access control.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Analytics provides methods to manage custom metrics: \u003ccode\u003earchive\u003c/code\u003e, \u003ccode\u003ecreate\u003c/code\u003e, \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003elist\u003c/code\u003e, and \u003ccode\u003epatch\u003c/code\u003e, allowing for comprehensive control over these custom data points.\u003c/p\u003e\n"]]],["CustomMetrics are defined by a name, parameter name, display name, description, measurement unit, scope, and restricted metric type. Measurement units include standard, currency, distance, and time. Metric scopes can be event-based. Restricted metric types include cost and revenue data. Key actions involve creating, retrieving, listing, updating, and archiving custom metrics, utilizing methods for each of these operations, like create, get, list, patch, and archive.\n"],null,["# REST Resource: properties.customMetrics\n\n- [Resource: CustomMetric](#CustomMetric)\n - [JSON representation](#CustomMetric.SCHEMA_REPRESENTATION)\n- [MeasurementUnit](#MeasurementUnit)\n- [MetricScope](#MetricScope)\n- [RestrictedMetricType](#RestrictedMetricType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CustomMetric\n----------------------\n\nA definition for a custom metric.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"parameterName\": string, \"displayName\": string, \"description\": string, \"measurementUnit\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics#MeasurementUnit), \"scope\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics#MetricScope), \"restrictedMetricType\": [ enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics#RestrictedMetricType) ] } ``` |\n\n| Fields ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name for this CustomMetric resource. Format: properties/{property}/customMetrics/{customMetric} |\n| `parameterName` | `string` Required. Immutable. Tagging name for this custom metric. If this is an event-scoped metric, then this is the event parameter name. May only contain alphanumeric and underscore charactes, starting with a letter. Max length of 40 characters for event-scoped metrics. |\n| `displayName` | `string` Required. Display name for this custom metric as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter. Legacy system-generated display names may contain square brackets, but updates to this field will never permit square brackets. |\n| `description` | `string` Optional. Description for this custom dimension. Max length of 150 characters. |\n| `measurementUnit` | `enum (`[MeasurementUnit](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics#MeasurementUnit)`)` Required. The type for the custom metric's value. |\n| `scope` | `enum (`[MetricScope](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics#MetricScope)`)` Required. Immutable. The scope of this custom metric. |\n| `restrictedMetricType[]` | `enum (`[RestrictedMetricType](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics#RestrictedMetricType)`)` Optional. Types of restricted data that this metric may contain. Required for metrics with CURRENCY measurement unit. Must be empty for metrics with a non-CURRENCY measurement unit. |\n\nMeasurementUnit\n---------------\n\nPossible types of representing the custom metric's value.\n\nCurrency representation may change in the future, requiring a breaking API change.\n\n| Enums ||\n|--------------------------------|-----------------------------------------|\n| `MEASUREMENT_UNIT_UNSPECIFIED` | MeasurementUnit unspecified or missing. |\n| `STANDARD` | This metric uses default units. |\n| `CURRENCY` | This metric measures a currency. |\n| `FEET` | This metric measures feet. |\n| `METERS` | This metric measures meters. |\n| `KILOMETERS` | This metric measures kilometers. |\n| `MILES` | This metric measures miles. |\n| `MILLISECONDS` | This metric measures milliseconds. |\n| `SECONDS` | This metric measures seconds. |\n| `MINUTES` | This metric measures minutes. |\n| `HOURS` | This metric measures hours. |\n\nMetricScope\n-----------\n\nThe scope of this metric.\n\n| Enums ||\n|----------------------------|---------------------------------|\n| `METRIC_SCOPE_UNSPECIFIED` | Scope unknown or not specified. |\n| `EVENT` | Metric scoped to an event. |\n\nRestrictedMetricType\n--------------------\n\nLabels that mark the data in this custom metric as data that should be restricted to specific users.\n\n| Enums ||\n|--------------------------------------|------------------------------|\n| `RESTRICTED_METRIC_TYPE_UNSPECIFIED` | Type unknown or unspecified. |\n| `COST_DATA` | Metric reports cost data. |\n| `REVENUE_DATA` | Metric reports revenue data. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------------|----------------------------------------|\n| ### [archive](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/archive) | Archives a CustomMetric on a property. |\n| ### [create](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/create) | Creates a CustomMetric. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/get) | Lookup for a single CustomMetric. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/list) | Lists CustomMetrics on a property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/patch) | Updates a CustomMetric on a property. |"]]