Prova il server MCP per Google Analytics. Installa da
GitHub e consulta l'
annuncio per maggiori dettagli.
REST Resource: properties.customMetrics
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: CustomMetrica
Una definizione di una metrica personalizzata.
Rappresentazione JSON |
{
"name": string,
"parameterName": string,
"displayName": string,
"description": string,
"measurementUnit": enum (MeasurementUnit ),
"scope": enum (MetricScope ),
"restrictedMetricType": [
enum (RestrictedMetricType )
]
} |
Campi |
name |
string
Solo output. Nome della risorsa per questa risorsa CustomMetrica. Formato: proprietà/{property}/customMetrics/{customMetric}
|
parameterName |
string
Obbligatorio. Immutabile. Nome del tagging per questa metrica personalizzata. Se questa è una metrica basata sugli eventi, questo è il nome del parametro evento. Può contenere solo caratteri alfanumerici e trattini bassi, che iniziano con una lettera. La lunghezza massima di 40 caratteri per le metriche basate sugli eventi.
|
displayName |
string
Obbligatorio. Il nome visualizzato per questa metrica personalizzata, come indicato nella UI di Analytics. Lunghezza massima di 82 caratteri, caratteri alfanumerici più spazi e trattini bassi che iniziano con una lettera. I nomi visualizzati generati dal sistema precedenti possono contenere parentesi quadre, ma gli aggiornamenti a questo campo non consentono mai le parentesi quadre.
|
description |
string
(Facoltativo) Descrizione di questa dimensione personalizzata. La lunghezza massima di 150 caratteri.
|
measurementUnit |
enum (MeasurementUnit )
Obbligatorio. Il tipo di valore della metrica personalizzata.
|
scope |
enum (MetricScope )
Obbligatorio. Immutabile. L'ambito di questa metrica personalizzata.
|
restrictedMetricType[] |
enum (RestrictedMetricType )
(Facoltativo) Tipi di dati soggetti a limitazioni che possono essere contenuti in questa metrica. Obbligatorio per le metriche con l'unità di misura CURRENCY. Il campo deve essere vuoto per le metriche con un'unità di misura diversa dalla valuta.
|
MeasurementUnit
Possibili tipi di rappresentazione del valore della metrica personalizzata.
La rappresentazione della valuta potrebbe cambiare in futuro, il che richiede una modifica dell'API che provoca un errore.
Enum |
MEASUREMENT_UNIT_UNSPECIFIED |
MeasurementUnit non specificata o mancante. |
STANDARD |
Questa metrica utilizza le unità predefinite. |
CURRENCY |
Questa metrica misura una valuta. |
FEET |
Questa metrica misura i piedi. |
METERS |
Questa metrica misura i metri. |
KILOMETERS |
Questa metrica misura i chilometri. |
MILES |
Questa metrica misura le miglia. |
MILLISECONDS |
Questa metrica misura i millisecondi. |
SECONDS |
Questa metrica misura i secondi. |
MINUTES |
Questa metrica misura i minuti. |
HOURS |
Questa metrica misura le ore. |
MetricScope
L'ambito di questa metrica.
Enum |
METRIC_SCOPE_UNSPECIFIED |
Ambito sconosciuto o non specificato. |
EVENT |
Metrica che ha come ambito un evento. |
RestrictedMetricType
Etichette che contrassegnano i dati di questa metrica personalizzata come dati che devono essere limitati a utenti specifici.
Enum |
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Tipo sconosciuto o non specificato. |
COST_DATA |
Dati di costo nei report sulle metriche. |
REVENUE_DATA |
La metrica riporta i dati sulle entrate. |
Metodi |
|
Archivia una metrica personalizzata in una proprietà. |
|
Crea una metrica personalizzata. |
|
Cerca una singola CustomMetrica. |
|
Elenca le metriche personalizzate in una proprietà. |
|
Aggiorna una metrica personalizzata su una proprietà. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]