MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
REST Resource: properties.customMetrics
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: CustomMetric
Eine Definition für einen benutzerdefinierten Messwert.
JSON-Darstellung |
{
"name": string,
"parameterName": string,
"displayName": string,
"description": string,
"measurementUnit": enum (MeasurementUnit ),
"scope": enum (MetricScope ),
"restrictedMetricType": [
enum (RestrictedMetricType )
]
} |
Felder |
name |
string
Nur Ausgabe. Ressourcenname für diese CustomMetric-Ressource. Format: properties/{property}/customMetrics/{customMetric}
|
parameterName |
string
Erforderlich. Nicht veränderbar. Tagging-Name für diesen benutzerdefinierten Messwert. Bei einem ereignisbezogenen Messwert ist das der Name des Ereignisparameters. Darf nur alphanumerische Zeichen und Unterstriche enthalten, die mit einem Buchstaben beginnen. Messwerte auf Ereignisebene dürfen maximal 40 Zeichen lang sein.
|
displayName |
string
Erforderlich. Anzeigename für diesen benutzerdefinierten Messwert, wie er in der Analytics-Benutzeroberfläche angezeigt wird. Darf 82 Zeichen lang sein, alphanumerische Zeichen plus Leerzeichen und Unterstriche beginnend mit einem Buchstaben. Ältere, vom System generierte Anzeigenamen können eckige Klammern enthalten. Aktualisierungen dieses Feldes lassen jedoch keine eckigen Klammern zu.
|
description |
string
Optional. Beschreibung dieser benutzerdefinierten Dimension. Max. 150 Zeichen.
|
measurementUnit |
enum (MeasurementUnit )
Erforderlich. Der Typ des benutzerdefinierten Messwerts.
|
scope |
enum (MetricScope )
Erforderlich. Nicht veränderbar. Umfang dieses benutzerdefinierten Messwerts.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
Optional. Arten von eingeschränkten Daten, die dieser Messwert enthalten kann. Erforderlich für Messwerte mit der Maßeinheit CURRENCY. Muss für Messwerte mit einer anderen Maßeinheit als CURRENCY leer sein.
|
MeasurementUnit
Mögliche Arten zur Darstellung des Werts des benutzerdefinierten Messwerts.
Die Währung kann sich in Zukunft ändern, sodass eine nicht abwärtskompatible API-Änderung erforderlich ist.
Enums |
MEASUREMENT_UNIT_UNSPECIFIED |
MeasurementUnit nicht angegeben oder fehlt. |
STANDARD |
Für diesen Messwert werden Standardeinheiten verwendet. |
CURRENCY |
Mit diesem Messwert wird eine Währung gemessen. |
FEET |
Diese Metrik misst Fuß. |
METERS |
Dieser Messwert misst Meter. |
KILOMETERS |
Mit diesem Messwert werden Kilometer gemessen. |
MILES |
Mit diesem Messwert werden Meilen gemessen. |
MILLISECONDS |
Dieser Messwert misst Millisekunden. |
SECONDS |
Dieser Messwert misst Sekunden. |
MINUTES |
Dieser Messwert misst die Minuten. |
HOURS |
Dieser Messwert gibt die Stunden an. |
MetricScope
Der Umfang dieses Messwerts.
Enums |
METRIC_SCOPE_UNSPECIFIED |
Bereich unbekannt oder nicht angegeben. |
EVENT |
Messwert, der auf ein Ereignis festgelegt ist. |
RestrictedMetricType
Labels, mit denen die Daten in diesem benutzerdefinierten Messwert als Daten gekennzeichnet werden, die auf bestimmte Nutzer beschränkt werden sollen.
Enums |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Typ unbekannt oder nicht angegeben. |
COST_DATA |
Messwertberichte Kostendaten. |
REVENUE_DATA |
Der Messwert enthält Umsatzdaten. |
Methoden |
|
Archiviert einen CustomMetric für eine Property. |
|
Erstellt einen CustomMetric. |
|
Suche nach einem einzelnen CustomMetric. |
|
Listet CustomMetrics für eine Eigenschaft auf. |
|
Aktualisiert einen CustomMetric für eine Eigenschaft. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]