REST Resource: properties.customDimensions
منبع: CustomDimension
تعریفی برای CustomDimension.
نمایندگی JSON |
---|
{
"name": string,
"parameterName": string,
"displayName": string,
"description": string,
"scope": enum (DimensionScope ),
"disallowAdsPersonalization": boolean
} |
فیلدها |
---|
name | string فقط خروجی نام منبع برای این منبع CustomDimension. قالب: خواص/{property}/customDimensions/{customDimension} |
parameter Name | string مورد نیاز. تغییرناپذیر. برچسب گذاری نام پارامتر برای این بعد سفارشی. اگر این یک بعد با محدوده کاربر است، این نام ویژگی کاربر است. اگر این یک بعد با دامنه رویداد است، این نام پارامتر رویداد است. اگر این یک بعد با دامنه مورد است، این نام پارامتر موجود در آرایه اقلام تجارت الکترونیک است. ممکن است فقط شامل نویسههای حروف عددی و زیرخط باشد که با یک حرف شروع میشوند. حداکثر طول 24 نویسه برای ابعاد با محدوده کاربر، 40 نویسه برای ابعاد با محدوده رویداد. |
display Name | string مورد نیاز. نام نمایشی برای این بعد سفارشی همانطور که در رابط کاربری Analytics نشان داده شده است. حداکثر طول 82 کاراکتر، حروف عددی به اضافه فاصله و خط زیر که با یک حرف شروع می شود. نامهای نمایشی تولید شده توسط سیستم قدیمی ممکن است دارای کروشه باشد، اما بهروزرسانیهای این فیلد هرگز اجازه ایجاد براکت را نمیدهد. |
description | string اختیاری. توضیحات برای این بعد سفارشی. حداکثر طول 150 کاراکتر |
scope | enum ( DimensionScope ) مورد نیاز. تغییرناپذیر. دامنه این بعد. |
disallow Ads Personalization | boolean اختیاری. اگر روی درست تنظیم شود، این بعد را به عنوان NPA تنظیم می کند و آن را از شخصی سازی تبلیغات مستثنی می کند. این در حال حاضر فقط توسط ابعاد سفارشی با محدوده کاربر پشتیبانی می شود. |
DimensionScope
مقادیر معتبر برای دامنه این بعد.
Enums |
---|
DIMENSION_SCOPE_UNSPECIFIED | محدوده نامعلوم یا مشخص نشده است. |
EVENT | ابعاد محدوده به یک رویداد. |
USER | ابعاد برای یک کاربر. |
ITEM | ابعاد محدوده به موارد تجارت الکترونیک |
روش ها |
---|
| یک CustomDimension را در یک ویژگی بایگانی می کند. |
| یک CustomDimension ایجاد می کند. |
| جستجو برای یک CustomDimension واحد. |
| CustomDimensions را در یک ویژگی فهرست می کند. |
| یک CustomDimension را در یک ویژگی به روز می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-14 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-14 بهوقت ساعت هماهنگ جهانی."],[[["`CustomDimension` resource allows defining custom dimensions with specific parameters like name, display name, description, scope, and whether it's excluded from ads personalization."],["The scope of a custom dimension can be `EVENT`, `USER`, or `ITEM`, determining the level at which the dimension is applied."],["You can manage custom dimensions using methods like `create`, `get`, `list`, `update`, and `archive` to control their lifecycle within your Google Analytics 4 property."],["Custom dimensions can be user-scoped, event-scoped or item-scoped, each with specific requirements for the parameter name used."],["The JSON representation of a `CustomDimension` includes fields for essential properties, allowing programmatic management of custom dimensions."]]],["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"]]