REST Resource: properties.customDimensions

المورد: المكوّن المخصّص

تعريف للسمة المخصّصة.

تمثيل JSON
{
  "name": string,
  "parameterName": string,
  "displayName": string,
  "description": string,
  "scope": enum (DimensionScope),
  "disallowAdsPersonalization": boolean
}
الحقول
name

string

النتائج فقط. اسم المورد لمورد المكوّن المخصّص هذا التنسيق: properties/{property}/customdimension/{customDimension}

parameterName

string

مطلوب. غير قابل للتغيير. اسم مَعلمة وضع العلامات لهذه السمة المخصّصة.

إذا كانت هذه سمة على مستوى المستخدِم، يكون هذا اسم خاصيّة المستخدِم. إذا كانت هذه سمة على مستوى الحدث، يكون هذا هو اسم مَعلمة الحدث.

إذا كانت هذه سمة على مستوى المنتج أو الخدمة، يكون هذا اسم المَعلمة في مصفوفة سلع التجارة الإلكترونية.

لا يمكن أن يحتوي إلا على أحرف أبجدية رقمية وشرطات سفلية فقط، بدءًا من حرف. يبلغ الحد الأقصى للطول 24 حرفًا للسمات على مستوى المستخدم و40 حرفًا للسمات على مستوى الحدث.

displayName

string

مطلوب. الاسم المعروض لهذه السمة المخصّصة كما هو موضّح في واجهة مستخدم "إحصاءات Google". الحد الأقصى للطول هو 82 حرفًا، أبجدية رقمية بالإضافة إلى مسافة وشرطة سفلية تبدأ بحرف. قد تحتوي الأسماء المعروضة القديمة التي ينشئها النظام على أقواس مربّعة، إلا أنّ تعديلات هذا الحقل لن تسمح مطلقًا باستخدام أقواس مربّعة.

description

string

اختياريّ. وصف لهذه السمة المخصّصة. 150 حرفًا كحدّ أقصى

scope

enum (DimensionScope)

مطلوب. غير قابل للتغيير. نطاق هذه السمة.

disallowAdsPersonalization

boolean

اختياريّ. وفي حال ضبطها على "صحيح"، يتم ضبط هذه السمة على أنّها إعلانات غير مخصَّصة واستبعادها من تخصيص الإعلانات.

لا تتوفّر هذه الميزة حاليًا إلا للسمات المخصّصة على مستوى المستخدِم.

DimensionScope

القيم الصالحة لنطاق هذه السمة

عمليات التعداد
DIMENSION_SCOPE_UNSPECIFIED النطاق غير معروف أو لم يتم تحديده.
EVENT تم تحديد السمة لأحد الأحداث.
USER تمّ تحديد السمة لمستخدم.
ITEM تم ضبط السمة على عناصر التجارة الإلكترونية

الطُرق

archive

أرشفة سمة مخصَّصة على أحد المواقع

create

تُنشئ سمة مخصّصة.

get

ابحث عن بُعد مخصّص واحد.

list

يسرد المكوّنات المخصّصة على أحد المواقع.

patch

لتعديل سمة مخصَّصة على أحد المواقع