REST Resource: properties.customDimensions

資源:自訂維度

自訂維度的定義。

JSON 表示法
{
  "name": string,
  "parameterName": string,
  "displayName": string,
  "description": string,
  "scope": enum (DimensionScope),
  "disallowAdsPersonalization": boolean
}
欄位
name

string

僅供輸出。這項自訂維度資源的資源名稱。格式:properties/{property}/customDimensions/{customDimensions}

parameterName

string

必要欄位。不可變動。這個自訂維度的代碼參數名稱。

如果是以使用者為範圍的維度,這會是使用者屬性名稱。如果這是以事件為範圍的維度,這會是事件參數名稱。

如果是以商品為範圍的維度,這會是電子商務項目陣列中的參數名稱。

只能使用英數字元和底線,並以英文字母開頭。以使用者為範圍的維度長度上限為 24 個字元,事件範圍維度最多 40 個字元。

displayName

string

必要欄位。Analytics UI 中顯示的自訂維度名稱。長度上限為 82 個字元,可以使用英數字元、空格和底線,開頭須為英文字母。舊版系統產生的顯示名稱可能包含方括號,但更新這個欄位時一律不允許使用方括號。

description

string

選用設定。此自訂維度的說明。長度上限為 150 個半形字元。

scope

enum (DimensionScope)

必要欄位。不可變動。這項維度的範圍。

disallowAdsPersonalization

boolean

選用設定。如果設為 true,請將這個維度設為非個人化廣告,並從廣告個人化中排除。

目前只有以使用者為範圍的自訂維度支援這項功能。

DimensionScope

這個維度範圍的有效值。

列舉
DIMENSION_SCOPE_UNSPECIFIED 範圍未知或未指定。
EVENT 維度範圍是以事件為範圍。
USER 以使用者為範圍的維度。
ITEM 以電子商務項目的維度為範圍

方法

archive

封存資源的自訂維度。

create

建立自訂維度。

get

查詢單一自訂維度。

list

列出資源的 CustomDimensions。

patch

更新資源的自訂維度。