כדאי לנסות את שרת ה-MCP ל-Google Analytics. אפשר להתקין מ-
GitHub, ולקרוא את
ההודעה לפרטים נוספים.
REST Resource: properties.customDimensions
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: מאפיין מותאם אישית
הגדרה של מאפיין מותאם אישית.
ייצוג JSON |
{
"name": string,
"parameterName": string,
"displayName": string,
"description": string,
"scope": enum (DimensionScope ),
"disallowAdsPersonalization": boolean
} |
שדות |
name |
string
פלט בלבד. שם המשאב של המשאב המותאם אישית הזה. פורמט: properties/{property}/customDimensions/{customdimension}
|
parameterName |
string
חובה. בלתי ניתן לשינוי. שם הפרמטר של התיוג עבור המאפיין המותאם אישית הזה. אם מדובר במאפיין ברמת המשתמש, זהו השם של מאפיין המשתמש. אם מדובר במאפיין ברמת האירוע, זהו השם של פרמטר האירוע. אם מדובר במאפיין ברמת הפריט, זהו שם הפרמטר שנמצא במערך הפריטים של מסחר אלקטרוני. יכול להכיל רק תווים אלפאנומריים וקווים תחתונים, שמתחיל באות. האורך המקסימלי הוא 24 תווים למאפיינים ברמת המשתמש, ו-40 תווים למאפיינים ברמת האירוע.
|
displayName |
string
חובה. השם המוצג של המאפיין המותאם אישית הזה כפי שהוא מוצג בממשק המשתמש של Analytics. אורך מקסימלי של 82 תווים, אלפאנומרי + רווח וקווים תחתונים, שמתחיל באות. שמות תצוגה מדור קודם שנוצרו על ידי המערכת עשויים להכיל סוגריים מרובעים, אבל עדכונים בשדה הזה לעולם לא יאפשרו סוגריים מרובעים.
|
description |
string
זה שינוי אופציונלי. תיאור של המאפיין המותאם אישית הזה. האורך המרבי הוא 150 תווים.
|
scope |
enum (DimensionScope )
חובה. בלתי ניתן לשינוי. ההיקף של המאפיין הזה.
|
disallowAdsPersonalization |
boolean
זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, המאפיין הזה מוגדר כ'מודעות ללא התאמה אישית (NPA)' ומחריג אותו מההתאמה האישית של המודעות. נכון לעכשיו, האפשרות הזו נתמכת רק במאפיינים מותאמים אישית ברמת המשתמש.
|
DimensionScope
ערכים חוקיים להיקף של המאפיין הזה.
טיפוסים בני מנייה (enum) |
DIMENSION_SCOPE_UNSPECIFIED |
ההיקף לא ידוע או שלא צוין. |
EVENT |
מאפיין ברמת האירוע. |
USER |
מאפיין ברמת המשתמש. |
ITEM |
מאפיין בהיקף של פריטים של מסחר אלקטרוני |
שיטות |
|
העברה לארכיון של מאפיין מותאם אישית בנכס. |
|
יצירת מאפיין מותאם אישית. |
|
מחפשים מאפיין מותאם אישית אחד. |
|
בתיבת הדו-שיח הזו מפורטים מאפיינים מותאמים אישית בנכס. |
|
עדכון מאפיין מותאם אישית בנכס. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003e\u003ccode\u003eCustomDimension\u003c/code\u003e resource allows defining custom dimensions with specific parameters like name, display name, description, scope, and whether it's excluded from ads personalization.\u003c/p\u003e\n"],["\u003cp\u003eThe scope of a custom dimension can be \u003ccode\u003eEVENT\u003c/code\u003e, \u003ccode\u003eUSER\u003c/code\u003e, or \u003ccode\u003eITEM\u003c/code\u003e, determining the level at which the dimension is applied.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage custom dimensions using methods like \u003ccode\u003ecreate\u003c/code\u003e, \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003elist\u003c/code\u003e, \u003ccode\u003eupdate\u003c/code\u003e, and \u003ccode\u003earchive\u003c/code\u003e to control their lifecycle within your Google Analytics 4 property.\u003c/p\u003e\n"],["\u003cp\u003eCustom dimensions can be user-scoped, event-scoped or item-scoped, each with specific requirements for the parameter name used.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a \u003ccode\u003eCustomDimension\u003c/code\u003e includes fields for essential properties, allowing programmatic management of custom dimensions.\u003c/p\u003e\n"]]],["Custom dimensions are defined with properties like `name`, `parameterName`, `displayName`, `description`, `scope`, and `disallowAdsPersonalization`. The `parameterName` is a tagging parameter, while `scope` defines if it's for events, users, or items. Actions include creating, getting, listing, patching, and archiving a custom dimension. The `DimensionScope` can be `EVENT`, `USER`, or `ITEM`. `disallowAdsPersonalization` excludes the dimension from ads personalization and is only supported for user-scoped custom dimensions.\n"],null,["# REST Resource: properties.customDimensions\n\n- [Resource: CustomDimension](#CustomDimension)\n - [JSON representation](#CustomDimension.SCHEMA_REPRESENTATION)\n- [DimensionScope](#DimensionScope)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CustomDimension\n-------------------------\n\nA definition for a CustomDimension.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"parameterName\": string, \"displayName\": string, \"description\": string, \"scope\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions#DimensionScope), \"disallowAdsPersonalization\": boolean } ``` |\n\n| Fields ||\n|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name for this CustomDimension resource. Format: properties/{property}/customDimensions/{customDimension} |\n| `parameterName` | `string` Required. Immutable. Tagging parameter name for this custom dimension. If this is a user-scoped dimension, then this is the user property name. If this is an event-scoped dimension, then this is the event parameter name. If this is an item-scoped dimension, then this is the parameter name found in the eCommerce items array. May only contain alphanumeric and underscore characters, starting with a letter. Max length of 24 characters for user-scoped dimensions, 40 characters for event-scoped dimensions. |\n| `displayName` | `string` Required. Display name for this custom dimension 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| `scope` | `enum (`[DimensionScope](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions#DimensionScope)`)` Required. Immutable. The scope of this dimension. |\n| `disallowAdsPersonalization` | `boolean` Optional. If set to true, sets this dimension as NPA and excludes it from ads personalization. This is currently only supported by user-scoped custom dimensions. |\n\nDimensionScope\n--------------\n\nValid values for the scope of this dimension.\n\n| Enums ||\n|-------------------------------|-------------------------------------|\n| `DIMENSION_SCOPE_UNSPECIFIED` | Scope unknown or not specified. |\n| `EVENT` | Dimension scoped to an event. |\n| `USER` | Dimension scoped to a user. |\n| `ITEM` | Dimension scoped to eCommerce items |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------------------|-------------------------------------------|\n| ### [archive](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/archive) | Archives a CustomDimension on a property. |\n| ### [create](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/create) | Creates a CustomDimension. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/get) | Lookup for a single CustomDimension. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/list) | Lists CustomDimensions on a property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/patch) | Updates a CustomDimension on a property. |"]]