REST Resource: properties.calculatedMetrics

المورد: CalculatedMetric

تعريف لمقياس محسوب.

تمثيل JSON
{
  "name": string,
  "description": string,
  "displayName": string,
  "calculatedMetricId": string,
  "metricUnit": enum (MetricUnit),
  "restrictedMetricType": [
    enum (RestrictedMetricType)
  ],
  "formula": string,
  "invalidMetricReference": boolean
}
الحقول
name

string

النتائج فقط. اسم المورد لمقياس CalculatedMetric هذا. التنسيق: 'Properties/{property_id}/calculatedMetrics/{calculatedMetricId}'

description

string

اختياريّ. وصف لهذا المقياس المحسوب. الحد الأقصى للطول هو 4096 حرفًا.

displayName

string

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

calculatedMetricId

string

النتائج فقط. رقم التعريف المطلوب استخدامه للمقياس المحسوب. يُشار إلى ذلك في واجهة المستخدم باسم "اسم واجهة برمجة التطبيقات".

يتم استخدام ComputeMetricId عند الإشارة إلى هذا المقياس المحسوب من واجهات برمجة التطبيقات الخارجية. على سبيل المثال، "calcMetric:{calculatedMetricId}".

metricUnit

enum (MetricUnit)

مطلوب. نوع قيمة المقياس المحسوب.

restrictedMetricType[]

enum (RestrictedMetricType)

النتائج فقط. أنواع البيانات المحظورة التي يحتوي عليها هذا المقياس.

formula

string

مطلوب. تعريف المقياس المحسوب الحد الأقصى لعدد المقاييس المخصّصة المرجعية الفريدة هو 5. تتيح المعادلات العمليات التالية: + (الجمع)، - (الطرح)، - (سالب)، * (الضرب)، / (القسمة)، () (الأقواس). يتم قبول أي أرقام حقيقية صالحة تتناسب مع رقم طويل طويل (عدد صحيح 64 بت) أو رقم نقطة عائمة مزدوجة 64 بت. مثال على الصيغة: "( customEvent:parameterName + CartPurchaseQuantity ) / 2.0"

invalidMetricReference

boolean

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

MetricUnit

الأنواع المحتملة لتمثيل قيمة المقياس المحسوب.

عمليات التعداد
METRIC_UNIT_UNSPECIFIED الوحدة المترية غير محدّدة أو غير متوفّرة.
STANDARD يستخدِم هذا المقياس الوحدات التلقائية.
CURRENCY يقيس هذا المقياس العملة.
FEET يقيس هذا المقياس قدم.
MILES يقيس هذا المقياس الأميال.
METERS يقيس هذا المقياس مترًا.
KILOMETERS يقيس هذا المقياس الكيلومترات.
MILLISECONDS ويقيس هذا المقياس المللي ثانية.
SECONDS يقيس هذا المقياس الثواني.
MINUTES يقيس هذا المقياس الدقائق.
HOURS يقيس هذا المقياس الساعات.

RestrictedMetricType

التصنيفات التي تضع علامة على البيانات في المقياس المحسوب الذي يتم استخدامه جنبًا إلى جنب مع أدوار المستخدمين التي تحظر الوصول إلى مقاييس التكلفة و/أو الأرباح.

عمليات التعداد
RESTRICTED_METRIC_TYPE_UNSPECIFIED النوع غير معروف أو غير محدّد.
COST_DATA بيانات تكلفة تقارير المقاييس.
REVENUE_DATA وتعرض المقاييس بيانات الأرباح.

الطُرق

create

تنشئ CalculatedMetric.

delete

لحذف سمة CalculatedMetric في أحد المواقع.

get

ابحث عن مقياس CalculatedMetric واحد.

list

يسرد CalculatedMetrics على أحد المواقع.

patch

لتعديل سمة CalculatedMetric على أحد المواقع.