Google Analytics için MCP sunucusunu deneyin.
GitHub'dan yükleyin ve daha fazla bilgi için
duyuruyu inceleyin.
REST Resource: properties.customMetrics
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: CustomMetric
Özel bir metriğin tanımı.
JSON gösterimi |
{
"name": string,
"parameterName": string,
"displayName": string,
"description": string,
"measurementUnit": enum (MeasurementUnit ),
"scope": enum (MetricScope ),
"restrictedMetricType": [
enum (RestrictedMetricType )
]
} |
Alanlar |
name |
string
Yalnızca çıkış. Bu CustomMetric kaynağının kaynak adı. Biçim: mülkler/{property}/customMetrics/{customMetric}
|
parameterName |
string
Zorunlu. Sabit. Bu özel metrik için etiketleme adı. Bu, etkinlik kapsamlı bir metrikse etkinlik parametresinin adıdır. Bir harfle başlayan yalnızca alfanümerik ve alt çizgi karakterleri içerebilir. Etkinlik kapsamlı metrikler için maksimum 40 karakter uzunluğundadır.
|
displayName |
string
Zorunlu. Bu özel metriğin, Analytics kullanıcı arayüzünde gösterilen görünen adı. Maksimum 82 karakter, alfanümerik artı boşluk ve harfle başlayan alt çizgi. Sistem tarafından oluşturulan eski görünen adlar köşeli parantez içerebilir ancak bu alanda yapılacak güncellemeler hiçbir zaman köşeli parantezlere izin vermez.
|
description |
string
İsteğe bağlı. Bu özel boyutun açıklaması. En fazla 150 karakter.
|
measurementUnit |
enum (MeasurementUnit )
Zorunlu. Özel metrik değerinin türü.
|
scope |
enum (MetricScope )
Zorunlu. Sabit. Bu özel metriğin kapsamı.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
İsteğe bağlı. Bu metriğin içerebileceği kısıtlanmış veri türleri. CURRENCY ölçüm birimine sahip metrikler için gereklidir. CURRENCY olmayan bir ölçüm birimine sahip metrikler için boş olmalıdır.
|
MeasurementUnit
Özel metriğin değerini temsil etmeyle ilgili olası türler.
Para birimi gösterimi gelecekte değişebilir ve zarar veren bir API değişikliği gerekebilir.
Sıralamalar |
MEASUREMENT_UNIT_UNSPECIFIED |
Ölçüm Birimi belirtilmemiş veya eksik. |
STANDARD |
Bu metrikte varsayılan birimler kullanılır. |
CURRENCY |
Bu metrik bir para birimi ölçer. |
FEET |
Bu metrik fit ölçer. |
METERS |
Bu metrik metre ölçer. |
KILOMETERS |
Bu metrik kilometreyi ölçer. |
MILES |
Bu metrik mil ölçer. |
MILLISECONDS |
Bu metrik, milisaniye ölçer. |
SECONDS |
Bu metrik saniyeyi ölçer. |
MINUTES |
Bu metrik dakikayı ölçer. |
HOURS |
Bu metrik, saati ölçer. |
MetricScope
Sıralamalar |
METRIC_SCOPE_UNSPECIFIED |
Kapsam bilinmiyor veya belirtilmedi. |
EVENT |
Kapsamı bir etkinliğe ayarlanmış metrik. |
RestrictedMetricType
Bu özel metrikteki verileri belirli kullanıcılarla sınırlı olması gereken veri olarak işaretleyen etiketler.
Sıralamalar |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Bilinmeyen veya belirtilmedi. |
COST_DATA |
Metrik raporları maliyet verileri. |
REVENUE_DATA |
Metrik, gelir verilerini raporlar. |
Yöntemler |
|
Bir mülkteki CustomMetric'i arşivler. |
|
Bir CustomMetric oluşturur. |
|
Tek bir CustomMetric araması yapın. |
|
Bir mülkteki CustomMetrics'i listeler. |
|
Bir mülkteki CustomMetric'i günceller. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]