Method: properties.runFunnelReport

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

يتيح لك استكشاف خطوات المستخدمين إمكانية الاطّلاع على تمثيل بصري للخطوات التي يتّخذها المستخدمون لإكمال مهمة وبالتالي التعرُّف بشكل سريع على مدى نجاحهم أو فشلهم في كل خطوة. مثلاً، كيف يتحوّل العملاء المحتملون إلى متسوّقين ثم مشترين؟ كيف يتحوّل المشترون لمرة واحدة إلى مشترين يكرّرون عملية الشراء؟ باستخدام هذه المعلومات، يمكنك تحسين رحلات العملاء غير الفعّالة أو التي تم التخلي عنها. لمزيد من المعلومات، اطّلِع على مقالة استكشاف مسارات الإحالات الناجحة في "إحصاءات Google 4".

تم طرح هذه الطريقة في إصدار أوليّ مستقر بهدف جمع ملاحظات وآراء حول البنية والإمكانات قبل الدخول في إصدار تجريبي. لتقديم ملاحظاتك حول واجهة برمجة التطبيقات هذه، يُرجى إكمال الملاحظات والآراء بشأن إعداد تقارير مسار الإحالة الناجحة في Google Analytics Data API.

طلب HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
property

string

اختياريّ. معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. يتم تحديده في مسار عنوان URL وليس في النص الأساسي لمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. ضمن الطلب المجمّع، يجب أن تكون هذه السمة غير محدّدة أو متوافقة مع الموقع على مستوى الدفعة.

مثال: المواقع الإلكترونية/1234

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
الحقول
dateRanges[]

object (DateRange)

اختياريّ. النطاقات الزمنية للبيانات المطلوب قراءتها في حال طلب نطاقات زمنية متعددة، سيحتوي كل صف استجابة على فهرس نطاق زمني يستند إلى صفر. وفي حال تداخل نطاقَين زمنيَين، يتم تضمين بيانات الأحداث للأيام المتداخلة في صفوف الردود لكلا النطاقَين الزمنيَين.
funnel

object (Funnel)

اختياريّ. إعدادات مسار الإحالة الناجحة لهذا الطلب. يجب ضبط إعدادات مسار الإحالة الناجحة هذه.
funnelBreakdown

object (FunnelBreakdown)

اختياريّ. وفي حال تحديد هذه التفاصيل، تضيف هذه التفاصيل سمة إلى استجابة التقرير الفرعي لجدول مسار الإحالة الناجحة. توسّع سمة التقسيم هذه كل خطوة في مسار الإحالة الناجحة إلى القيم الفريدة لسمة التصنيف التفصيلي. على سبيل المثال، سيؤدي التقسيم حسب السمة deviceCategory إلى إنشاء صفوف للقيم mobile وtablet وdesktop والإجمالي.
funnelNextAction

object (FunnelNextAction)

اختياريّ. في حال تحديد الإجراء، يضيف الإجراء التالي سمة إلى استجابة التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة. يعمل سمة الإجراء التالي على توسيع كل خطوة في مسار الإحالة الناجحة إلى القيم الفريدة للإجراء التالي. على سبيل المثال، سيؤدي الإجراء التالي للسمة eventName إلى إنشاء صفوف لعدة أحداث (مثل session_start وclick) والإجمالي.

يتوافق الإجراء التالي فقط مع eventName ومعظم سمات الصفحة أو الشاشة، مثل pageTitle وpagePath.
funnelVisualizationType

enum (FunnelVisualizationType)

اختياريّ. يتحكّم نوع التمثيل البصري لمسار الإحالة الناجحة في السمات المتوفّرة في ردّ التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة. إذا لم يتم تحديد قيمة، سيتم استخدام السمة STANDARD_FUNNEL.
segments[]

object (Segment)

اختياريّ. تكوينات الشرائح. الشرائح هي مجموعات فرعية من بيانات الموقع. في تقرير مسار الإحالة الناجحة الذي يتضمّن شرائح، يتم تقييم مسار الإحالة الناجحة في كل شريحة.

ينتج عن كل مقطع محدد في هذا الطلب صف منفصل في الاستجابة؛ في الإجابة، يتم تحديد كل قسم باسمه.

مَعلمة الشرائح اختيارية. تقتصر الطلبات على 4 أقسام.
limit

string (int64 format)

اختياريّ. عدد الصفوف المطلوب عرضها. في حال عدم تحديد قيمة الحقل، سيتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 250,000 صف كحدٍ أقصى لكل طلب، بغض النظر عن عدد الصفوف التي تطلبها. يجب أن تكون قيمة limit موجبة.

ويمكن أن تعرض واجهة برمجة التطبيقات أيضًا صفوفًا أقل من قيمة limit المطلوبة، إذا لم يتوفّر عدد قيم السمات مثل limit.
dimensionFilter

object (FilterExpression)

اختياريّ. تسمح لك فلاتر السمات بطلب قيم سمات معيّنة فقط في التقرير. ولمزيد من المعلومات، يُرجى الاطّلاع على إنشاء تقرير: فلاتر السمات للحصول على أمثلة. لا يمكن استخدام المقاييس في هذا الفلتر.
returnPropertyQuota

boolean

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

نص الاستجابة

تتضمّن استجابة تقرير مسار الإحالة الناجحة تقريرَين فرعيَين. إنّ التقريرَين الفرعيَين هما مزيجان مختلفان من السمات والمقاييس.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
الحقول
funnelTable

object (FunnelSubReport)

جدول مسار الإحالة الناجحة هو تقرير يتضمّن الخطوة في مسار الإحالة الناجحة والشريحة وسمة التقسيم والمستخدمين النشطين ومعدّل الإكمال ومعدّل العزوف ومعدّل العزوف.

لا تتوفّر سمة الشريحة في هذه الاستجابة إلا في حال طلب شريحة. لا تتوفّر سمة التقسيم في هذه الاستجابة إلا إذا تم طلبها.
funnelVisualization

object (FunnelSubReport)

التمثيل البصري لمسار الإحالة الناجحة هو تقرير يتضمّن الخطوة في مسار الإحالة الناجحة والشريحة والتاريخ وسمة الإجراء التالي والمستخدمين النشطين.

لا تتوفّر سمة الشريحة في هذه الاستجابة إلا في حال طلب شريحة. لا تتوفّر سمة التاريخ في هذه الاستجابة إلا إذا تم طلبها من خلال نوع مسار الإحالة الناجحة "TRENDED_FUNNEL". لا تتوفّر سمة الإجراء التالي في الردّ إلا إذا تم طلبها.
propertyQuota

object (PropertyQuota)

حالة حصة هذا الموقع على "إحصاءات Google" بما في ذلك هذا الطلب.
kind

string

يحدد نوع المورد الذي ينتمي إليه هذه الرسالة. تكون قيمة kind هذه دائمًا السلسلة الثابتة "analyticsData#runFunnelReport". ويكون ذلك مفيدًا للتمييز بين أنواع الاستجابة في JSON.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

مسار الإحالة الناجحة

تضبط هذه السياسة مسار الإحالة الناجحة في طلب تقرير مسار الإحالة الناجحة. يقدِّم مسار الإحالة الناجحة تقارير عن المستخدِمين أثناء مرورهم بسلسلة من الخطوات.

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

تمثيل JSON 
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
الحقول
isOpenFunnel

boolean

في مسار الإحالة الناجحة المفتوح، يمكن للمستخدمين الدخول إلى المسار في أي خطوة، وفي مسار الإحالة الناجحة المغلق، على المستخدمين الدخول إلى المسار في الخطوة الأولى. اختياريّ. وفي حال عدم تحديد قيمة هذه السمة، يتم استخدام مسار إحالة ناجحة مغلق.
steps[]

object (FunnelStep)

الخطوات المتسلسلة لمسار الإحالة الناجحة هذا

FunnelStep

تحدِّد الخطوات تجربة المستخدِم التي تريد قياسها. تحتوي الخطوات على شرط واحد أو أكثر يجب أن يستوفيه المستخدمون ليتم تضمينهم في تلك الخطوة من رحلة مسار الإحالة الناجحة.

تمثيل JSON 
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
الحقول
name

string

الاسم المميز لهذه الخطوة. وفي حال عدم تحديد هذه الخطوات، ستتم تسمية الخطوات باسم مفهرَس واحد (على سبيل المثال "0. "، "1. "، وما إلى ذلك). يحدّد هذا الاسم قيمة السلسلة التي تعرضها السمة funnelStepName. على سبيل المثال، سيؤدي تحديد name = Purchase في الخطوة الثالثة في مسار الطلب إلى عرض 3. Purchase في استجابة تقرير مسار الإحالة الناجحة.
isDirectlyFollowedBy

boolean

إذا كانت القيمة هي true، يجب أن تتبع هذه الخطوة الخطوة السابقة مباشرةً. وإذا كانت القيمة false، قد تكون هناك أحداث بين الخطوة السابقة وهذه الخطوة. وفي حال عدم تحديد هذه القيمة، يتم التعامل مع السمة isDirectlyFollowedBy على أنّها "خطأ".
filterExpression

object (FunnelFilterExpression)

الشرط الذي يجب أن يستوفيه المستخدمون ليتم تضمينه في هذه الخطوة من رحلة مسار الإحالة الناجحة.
withinDurationFromPriorStep

string (Duration format)

في حال تحديد هذه الخطوة، يجب إكمالها خلال مدة إكمال الخطوة السابقة. وتشمل withinDurationFromPriorStep نقطة النهاية بدقة الميكرو ثانية. على سبيل المثال، يمكن إكمال مدة 5 ثوانٍ عند 4.9 أو 5.0 ثوانٍ، ولكن ليس 5 ثوانٍ و1 ميكرو ثانية.

إنّ withinDurationFromPriorStep اختياري، وفي حال عدم تحديد الخطوات، يمكن فصل الخطوات حسب أي مدة.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

FunnelFilterExpression

تعبّر عن مجموعات فلاتر مسار الإحالة الناجحة.

تمثيل JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
الحقول
حقل الاتحاد expr. حدِّد نوع فلتر واحدًا لـ FunnelFilterExpression. يمكن أن يكون expr واحدًا فقط مما يلي:
andGroup

object (FunnelFilterExpressionList)

علاقة FunnelFilter Expression في andGroup بالعلاقة "و".
orGroup

object (FunnelFilterExpressionList)

ترتبط علاقة FunnelFilterExpression في orGroup بعلاقة OR.
notExpression

object (FunnelFilterExpression)

ليس FunnelFilterExpression ليس بقيمة notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

فلتر مسار الإحالة الناجحة لسمة أو مقياس معيّن
funnelEventFilter

object (FunnelEventFilter)

ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا.

FunnelFilterExpressionList

قائمة بتعبيرات فلاتر مسارات الإحالات الناجحة

تمثيل JSON 
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
الحقول
expressions[]

object (FunnelFilterExpression)

قائمة تعبيرات فلاتر مسار الإحالة الناجحة.

FunnelFieldFilter

تعبير لفلترة قيم السمات أو المقاييس

تمثيل JSON 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
الحقول
fieldName

string

اسم السمة أو اسم المقياس.
حقل الاتحاد one_filter. حدِّد نوعًا واحدًا من الفلاتر. يمكن أن يكون one_filter واحدًا فقط مما يلي:
stringFilter

object (StringFilter)

الفلتر المرتبط بالسلاسل
inListFilter

object (InListFilter)

فلتر لقيم القائمة.
numericFilter

object (NumericFilter)

فلتر للقيم الرقمية أو قيم التاريخ.
betweenFilter

object (BetweenFilter)

عامل تصفية للقيم بين قيمتين.

FunnelEventFilter

ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا.

تمثيل JSON 
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
الحقول
eventName

string

يطابق هذا الفلتر الأحداث لاسم الحدث الفردي هذا. يجب إدخال اسم الحدث.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

في حال تحديد هذا الفلتر، يتطابق مع الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلاتر المَعلمات.

داخل تعبير فلتر المَعلمات، تتوفّر فلاتر المَعلمات فقط.

FunnelParameterFilterExpression

تعبّر عن مجموعات فلاتر مسار الإحالة الناجحة استنادًا إلى المَعلمات.

تمثيل JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
الحقول
حقل الاتحاد expr. حدِّد نوع فلتر واحدًا لـ FunnelParameterFilterExpression. يمكن أن يكون expr واحدًا فقط مما يلي:
andGroup

object (FunnelParameterFilterExpressionList)

ترتبط علاقة FunnelparamFilterExpression في andGroup بالعلاقة AND.
orGroup

object (FunnelParameterFilterExpressionList)

ترتبط علاقة FunnelparamFilterExpression في orGroup بالعلاقة "أو".
notExpression

object (FunnelParameterFilterExpression)

ليس FunnelparamFilterExpression ليس قيمة notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

فلتر مَعلمات مسار الإحالة الناجحة الأساسي

FunnelParameterFilterExpressionList

قائمة بتعبيرات فلاتر مَعلمات مسار الإحالة الناجحة

تمثيل JSON 
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
الحقول
expressions[]

object (FunnelParameterFilterExpression)

قائمة تعبيرات فلاتر مَعلمات مسار الإحالة الناجحة

FunnelParameterFilter

تعبير لفلترة قيم المَعلمات في مسار إحالة ناجحة

تمثيل JSON 
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
الحقول
حقل الاتحاد one_parameter. الحقل الذي تتم تصفيته. يمكن أن يكون one_parameter واحدًا فقط مما يلي:
eventParameterName

string

سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة الحدث المحدّدة. يتم تسجيل مَعلمات الحدث كمَعلمات للحدث. تتضمّن مَعلمات الأحداث حقولاً مثلfirebase_screen و "العملة".

لا يمكن استخدام مَعلمات الأحداث إلّا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter.
itemParameterName

string

سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة السلعة المحدّدة. يتم تسجيل مَعلمات السلع كمَعلمات في مصفوفة السلع. تتضمّن مَعلمات العناصر حقولاً مثل "item_name" و "item_category".

لا يمكن استخدام مَعلمات العناصر إلا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter.

لا تتوفّر مَعلمات السلع إلا في أحداث التجارة الإلكترونية. للمزيد من المعلومات عن أحداث التجارة الإلكترونية، اطّلِع على دليل قياس التجارة الإلكترونية.
حقل الاتحاد one_filter. حدِّد نوعًا واحدًا من الفلاتر. يمكن أن يكون one_filter واحدًا فقط مما يلي:
stringFilter

object (StringFilter)

الفلتر المرتبط بالسلاسل
inListFilter

object (InListFilter)

فلتر لقيم القائمة.
numericFilter

object (NumericFilter)

فلتر للقيم الرقمية أو قيم التاريخ.
betweenFilter

object (BetweenFilter)

عامل تصفية للقيم بين قيمتين.

FunnelBreakdown

تضيف التصنيفات التفصيلية سمة إلى ردّ التقرير الفرعي لجدول مسار الإحالة الناجحة.

تمثيل JSON 
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
الحقول
breakdownDimension

object (Dimension)

عمود السمات الذي تمّت إضافته إلى ردّ التقرير الفرعي لجدول مسار الإحالة الناجحة. وتقسّم سمة التقسيم كل خطوة في مسار الإحالة الناجحة. يجب إدخال قيمة breakdownDimension صالحة في حال تحديد السمة funnelBreakdown.
limit

string (int64 format)

الحد الأقصى لعدد القيم المختلفة لسمة التصنيف التفصيلي المطلوب عرضها في الردّ. يتم استخدام limit من 5 إذا لم يتم تحديد الحد. يجب أن يتجاوز الحد صفر ولا يمكن أن يتجاوز 15.

FunnelNextAction

تحدّد الإجراءات التالية قيمة البُعد بعد أن يكمل المستخدم خطوة ما ولكن قبل أن يحقق المستخدم نفسه الخطوة التالية. على سبيل المثال، إذا كانت قيمة nextActionDimension هي eventName، ستعرِض السمة nextActionDimension في صف الخطوة i في مسار الإحالة الناجحة الحدث الأول بعد الحدث الذي أدّى إلى تأهيل المستخدِم للخطوة رقم i ولكن قبل تحقيق المستخدِم للخطوة i+1 في مسار الإحالة الناجحة.

تمثيل JSON 
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
الحقول
nextActionDimension

object (Dimension)

عمود السمة الذي تمّت إضافته إلى ردّ التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة. تعرِض سمة الإجراء التالي قيمة السمة التالية لهذه السمة بعد أن يصل المستخدِم إلى الخطوة i في مسار الإحالة الناجحة.

يتوافق تطبيق "nextActionDimension" حاليًا مع eventName ومعظم سمات الصفحة أو الشاشة، مثل pageTitle وpagePath. لا يمكن أن يكون nextActionDimension تعبيرًا للسمة.
limit

string (int64 format)

الحد الأقصى لعدد القيم المختلفة لسمة التصنيف التفصيلي المطلوب عرضها في الردّ. يتم استخدام limit من 5 إذا لم يتم تحديد الحد. يجب أن يتجاوز الحد صفر ولا يمكن أن يتجاوز 5.

FunnelVisualizationType

تتحكّم هذه السياسة في السمات المتوفّرة في ردّ التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة.

عمليات التعداد
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED نوع غير محدَّد.
STANDARD_FUNNEL مسار إحالة ناجحة عادي (متقدّم). لن يحتوي التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة في الردّ على التاريخ.
TRENDED_FUNNEL مسار الإحالة الناجحة بشكل رسم بياني خطي. سيتضمّن التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة في الردّ سمة التاريخ.

تقسيم

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

لمزيد من المعلومات، اطّلِع على أداة إنشاء الشرائح في "إحصاءات Google 4".

تمثيل JSON 
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
الحقول
name

string

اسم هذه الشريحة. وفي حال عدم تحديد ذلك، يُطلق على الشرائح اسم "شريحة". يحدّد هذا الاسم قيمة السلسلة التي تعرضها السمة segment. تبدأ السمة segment بأسماء الشرائح حسب رقم الفهرس المستند إلى 1 للشريحة في الطلب (على سبيل المثال "1. الشريحة"، "2. الشريحة"، وما إلى ذلك).
حقل الاتحاد one_segment_scope. تم تحديد الشريحة في نطاق واحد. يمكن أن يكون one_segment_scope واحدًا فقط مما يلي:
userSegment

object (UserSegment)

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

object (SessionSegment)

شرائح الجلسات هي مجموعات فرعية من الجلسات التي حدثت على موقعك الإلكتروني أو تطبيقك.
eventSegment

object (EventSegment)

شرائح الأحداث هي مجموعات فرعية من الأحداث التي تم تشغيلها على موقعك الإلكتروني أو تطبيقك.

UserSegment

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

تمثيل JSON 
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
الحقول
userInclusionCriteria

object (UserSegmentCriteria)

تُحدِّد المستخدِمين الذين يتم تضمينهم في هذه الشريحة. اختياريّ.
exclusion

object (UserSegmentExclusion)

تحدِّد المستخدِمين المستبعَدين في هذه الشريحة. اختياريّ.

UserSegmentCriteria

يطابق المستخدِم أحد المعايير إذا كانت أحداثه تستوفي الشروط الواردة في المعايير.

تمثيل JSON 
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
الحقول
andConditionGroups[]

object (UserSegmentConditionGroup)

ويتطابق المستخدم مع هذه المعايير إذا طابقَ المستخدم كلّاً من andConditionGroups هذه وكل من andSequenceGroups. قد يكون andConditionGroups فارغًا إذا تم تحديد andSequenceGroups.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

ويتطابق المستخدم مع هذه المعايير إذا طابقَ هذا المستخدم كلاً من andSequenceGroups وكل andConditionGroups. قد يكون andSequenceGroups فارغًا إذا تم تحديد andConditionGroups.

UserSegmentConditionGroup

تخبر الشروط "إحصاءات Google" بالبيانات التي يجب تضمينها في الشريحة أو استبعادها منها.

تمثيل JSON 
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
الحقول
conditionScoping

enum (UserCriteriaScoping)

يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع مجموعة الشروط. يحدِّد هذا النطاق عدد الأحداث التي يتم تقييم segmentFilterExpression استنادًا إليها قبل تحديد أنّ مجموعة الشروط هي مطابقة أو لا. على سبيل المثال، إذا كانت السمة conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION، يتم تقييم التعبير بناءً على جميع الأحداث في جلسة معيّنة، ثم يتم تحديد مجموعة الشروط لتكون مطابقة أو لا تتطابق مع هذا المستخدم. على سبيل المثال، إذا كانت السمة conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT، يتم تقييم التعبير استنادًا إلى حدث واحد، ثم يتم تحديد أنّ مجموعة الشروط مطابقة لهذا المستخدم أو لا.

اختياريّ. وفي حال عدم تحديد قيمة هذه السمة، يتم استخدام السمة conditionScoping = ACROSS_ALL_SESSIONS.
segmentFilterExpression

object (SegmentFilterExpression)

يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات.

UserCriteriaScoping

يحدِّد النطاق الأحداث التي يتم وضعها في الاعتبار عند تقييم ما إذا كان المستخدِم يستوفي إحدى المعايير.

عمليات التعداد
USER_CRITERIA_SCOPING_UNSPECIFIED تحديد نطاق معايير غير محدّدة يُرجى عدم التحديد.
USER_CRITERIA_WITHIN_SAME_EVENT في حال استيفاء المعايير ضمن حدث واحد، يتطابق المستخدم مع المعايير.
USER_CRITERIA_WITHIN_SAME_SESSION في حال استيفاء المعايير خلال جلسة واحدة، يتطابق المستخدم مع المعايير.
USER_CRITERIA_ACROSS_ALL_SESSIONS إذا استوفى المستخدم المعايير بواسطة أي أحداث للمستخدم، يطابق المستخدم المعايير.

SegmentFilterExpression

تعبّر عن مجموعات فلاتر الشرائح.

تمثيل JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
الحقول
حقل الاتحاد expr. حدِّد نوع فلتر واحدًا لـ SegmentFilterExpression. يمكن أن يكون expr واحدًا فقط مما يلي:
andGroup

object (SegmentFilterExpressionList)

علاقة SegmentFilter Expression في الدالة andGroup بالعلاقة "و".
orGroup

object (SegmentFilterExpressionList)

علاقة SegmentFilterExpression في الدالة orGroup بعلاقة OR.
notExpression

object (SegmentFilterExpression)

سمة SegmentFilterExpression ليست من notExpression.
segmentFilter

object (SegmentFilter)

فلتر قسم أساسي.
segmentEventFilter

object (SegmentEventFilter)

ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا.

SegmentFilterExpressionList

قائمة بتعبيرات فلاتر الشرائح.

تمثيل JSON 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
الحقول
expressions[]

object (SegmentFilterExpression)

قائمة تعبيرات فلاتر الشرائح

SegmentFilter

تعبير لفلترة قيم السمات أو المقاييس

تمثيل JSON 
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
الحقول
fieldName

string

اسم السمة أو اسم المقياس.
filterScoping

object (SegmentFilterScoping)

تُحدِّد نطاق الفلتر.
حقل الاتحاد one_filter. حدِّد نوع فلتر واحدًا لـ Filter. يمكن أن يكون one_filter واحدًا فقط مما يلي:
stringFilter

object (StringFilter)

الفلتر المرتبط بالسلاسل
inListFilter

object (InListFilter)

فلتر لقيم القائمة.
numericFilter

object (NumericFilter)

فلتر للقيم الرقمية أو قيم التاريخ.
betweenFilter

object (BetweenFilter)

عامل تصفية للقيم بين قيمتين.

SegmentFilterScoping

تحدد النطاقات كيفية توافق الأبعاد يجب مراعاة مقاييس الأحداث المتعددة عند تقييم فلتر شرائح.

تمثيل JSON 
{
  "atAnyPointInTime": boolean
}
الحقول
atAnyPointInTime

boolean

إذا كانت atAnyPointInTime صحيحة، يتم تقييم هذا الفلتر على أنّه "صحيح" لجميع الأحداث إذا تم تقييمه على "صحيح" لأي حدث في النطاق الزمني للطلب.

لا تعمل مَعلمة atAnyPointInTime هذه على توسيع النطاق الزمني للأحداث في التقرير. إذا كانت atAnyPointInTime صحيحة، لن نأخذ في الاعتبار سوى الأحداث ضمن النطاق الزمني للتقرير عند تقييم هذا الفلتر.

لا يمكن تحديد atAnyPointInTime هذا إلا إذا كان نطاق المعايير هو ACROSS_ALL_SESSIONS ولا يمكن تحديده في التسلسل.

إذا كان نطاق المعايير هو ACROSS_ALL_SESSIONS، يتم استخدام atAnyPointInTime = خطأ إذا لم يتم تحديده.

SegmentEventFilter

ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا.

تمثيل JSON 
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
الحقول
eventName

string

يطابق هذا الفلتر الأحداث لاسم الحدث الفردي هذا. يجب إدخال اسم الحدث.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

في حال تحديد هذا الفلتر، يتطابق مع الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلاتر المَعلمات.

داخل تعبير فلتر المَعلمات، تتوفّر فلاتر المَعلمات فقط.

SegmentParameterFilterExpression

تعبّر عن مجموعات فلتر الشرائح على المَعلمات.

تمثيل JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
الحقول
حقل الاتحاد expr. حدِّد نوع فلتر واحدًا لـ SegmentParameterFilterExpression. يمكن أن يكون expr واحدًا فقط مما يلي:
andGroup

object (SegmentParameterFilterExpressionList)

علاقة SegmentElementFilterExpression في الدالة andGroup بعلاقة AND.
orGroup

object (SegmentParameterFilterExpressionList)

السمة SegmentElementFilterExpression في الدالة orGroup لها علاقة OR.
notExpression

object (SegmentParameterFilterExpression)

سمة SegmentمعلَمةFilterExpression ليست من notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

فلتر أساسي لمَعلمات الشريحة

SegmentParameterFilterExpressionList

قائمة بتعبيرات فلاتر مَعلمات الشرائح

تمثيل JSON 
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
الحقول
expressions[]

object (SegmentParameterFilterExpression)

قائمة تعبيرات فلاتر مَعلمات الشرائح

SegmentParameterFilter

تعبير لفلترة قيم المَعلمات في إحدى الشرائح

تمثيل JSON 
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
الحقول
filterScoping

object (SegmentParameterFilterScoping)

تُحدِّد نطاق الفلتر.
حقل الاتحاد one_parameter. الحقل الذي تتم تصفيته. يمكن أن يكون one_parameter واحدًا فقط مما يلي:
eventParameterName

string

سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة الحدث المحدّدة. يتم تسجيل مَعلمات الحدث كمَعلمات للحدث. تتضمّن مَعلمات الأحداث حقولاً مثلfirebase_screen و "العملة".

لا يمكن استخدام مَعلمات الأحداث إلّا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter.
itemParameterName

string

سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة السلعة المحدّدة. يتم تسجيل مَعلمات السلع كمَعلمات في مصفوفة السلع. تتضمّن مَعلمات العناصر حقولاً مثل "item_name" و "item_category".

لا يمكن استخدام مَعلمات العناصر إلا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter.

لا تتوفّر مَعلمات السلع إلا في أحداث التجارة الإلكترونية. للمزيد من المعلومات عن أحداث التجارة الإلكترونية، اطّلِع على دليل قياس التجارة الإلكترونية.
حقل الاتحاد one_filter. حدِّد نوعًا واحدًا من الفلاتر. يمكن أن يكون one_filter واحدًا فقط مما يلي:
stringFilter

object (StringFilter)

الفلتر المرتبط بالسلاسل
inListFilter

object (InListFilter)

فلتر لقيم القائمة.
numericFilter

object (NumericFilter)

فلتر للقيم الرقمية أو قيم التاريخ.
betweenFilter

object (BetweenFilter)

عامل تصفية للقيم بين قيمتين.

SegmentParameterFilterScoping

تحدِّد النطاقات كيفية مراعاة الأحداث المتعددة عند تقييم فلتر مَعلمات الشريحة.

تمثيل JSON 
{
  "inAnyNDayPeriod": string
}
الحقول
inAnyNDayPeriod

string (int64 format)

تجمع المَعلمة خلال الفترة المحدّدة من الأيام قبل تطبيق الفلتر. لا تتوفَّر هذه الميزة إلّا إذا كان نطاق المعايير هو ACROSS_ALL_SESSIONS أو WITHIN_SAME_SESSION. ولا يتوفّر هذا الخيار إلا إذا كانت المَعلمة event_count.

على سبيل المثال، إذا كانت قيمة inAnyNDayPeriod هي 3، وكان eventName هو "purchase"، ومعلَمة الحدث هي "event_count"، ومعايير الفلتر أكبر من 5، سيجمع هذا الفلتر عدد الأحداث لأحداث الشراء على مدار كل 3 أيام متتالية في النطاق الزمني للتقرير. سيجتاز المستخدِم معايير هذا الفلتر حتى يتم تضمينه في هذه الشريحة إذا تجاوز عدد أحداث الشراء 5 في أيّ فترة 3 أيّام متتالية. على سبيل المثال، سيتم أخذ الفترات من 2021-11-01 إلى 2021-11-03 و 2021-11-02 إلى 2021-11-04 و 2021-11-03 إلى 2021-11-05 وما إلى ذلك.

لا يتم تمديد النطاق الزمني لغرض وجود فترة N يوم كاملة بالقرب من بداية النطاق الزمني. على سبيل المثال، إذا كان التقرير عن الفترة من 2021-11-01 إلى 2021-11-10 وinAnyNDayPeriod = 3، سيتم تقصير فترة أول يومَين بشكلٍ فعّال لأنّه لن تتم قراءة أي بيانات أحداث خارج النطاق الزمني للتقرير. على سبيل المثال، ستكون الفترات الأربع الأولى فعليًا: من 2021-11-01 إلى 01-11-2021، و01-11-2021 إلى 2021-11-01-2021-11-01-2021-03-11-2021، و03-11-2021 إلى 03-11-2021.

وتكون السمة inAnyNDayPeriod اختيارية. وإذا لم يتم تحديد هذه السمة، سيتم تطبيق السمة segmentParameterFilter على كل حدث على حدة.

UserSegmentSequenceGroup

حدِّد الشروط التي يجب أن تحدث بترتيب معيّن ليصبح المستخدِم عضوًا في الشريحة.

تمثيل JSON 
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
الحقول
sequenceScoping

enum (UserCriteriaScoping)

يجب استيفاء جميع خطوات التسلسل في النطاق لكي يطابق المستخدم التسلسل. على سبيل المثال، إذا كان sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION، يجب إكمال جميع خطوات التسلسل خلال جلسة واحدة حتى يتطابق المستخدم مع التسلسل. "sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT" غير متاح

اختياريّ. وفي حال عدم تحديد قيمة هذه السمة، يتم استخدام السمة conditionScoping = ACROSS_ALL_SESSIONS.
sequenceMaximumDuration

string (Duration format)

وتحدِّد الفترة الزمنية التي يجب أن يحدث فيها التسلسل بالكامل. على سبيل المثال، 30 دقيقة. وتشمل sequenceMaximumDuration نقطة النهاية بدقة الميكرو ثانية. على سبيل المثال، يمكن إكمال تسلسل بمدّته 5 ثوانٍ بحدّ أقصى 4.9 أو 5.0 ثوانٍ، ولكن ليس 5 ثوانٍ و1 ميكرو ثانية.

تكون السمة sequenceMaximumDuration اختيارية، وفي حال عدم تحديد تسلسلات، يمكن إكمالها في أي مدة زمنية.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"
userSequenceSteps[]

object (UserSequenceStep)

تمثّل هذه السمة تسلسلًا مُرتبًا لخطوات الشرط. يجب أن تكمل أحداث المستخدم كل خطوة حتى يتطابق المستخدم مع UserSegmentSequenceGroup.

UserSequenceStep

شرط يجب أن يحدث بترتيب الخطوات المحدّد حتى يتطابق هذا المستخدم مع التسلسل.

تمثيل JSON 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
الحقول
isDirectlyFollowedBy

boolean

إذا كانت القيمة هي true، يجب أن يكون الحدث الذي يستوفي هذه الخطوة هو الحدث التالي بعد وقوع الحدث في الخطوة الأخيرة. إذا كانت القيمة "خطأ"، فإنّ هذه الخطوة تتبع الخطوة السابقة بشكل غير مباشر. على سبيل المثال، قد تكون هناك أحداث بين الخطوة السابقة وهذه الخطوة. يجب أن يكون isDirectlyFollowedBy false في الخطوة الأولى.
stepScoping

enum (UserCriteriaScoping)

يجب استيفاء هذه الخطوة في التسلسل من أجل مطابقة المستخدم للتسلسل. على سبيل المثال، إذا كانت sequenceScoping = WITHIN_SAME_SESSION، يجب إكمال هذه الخطوات في التسلسل خلال جلسة واحدة حتى يتطابق المستخدم مع التسلسل. لا يُسمح باستخدام stepScoping = ACROSS_ALL_SESSIONS إلا إذا كانت السمة sequenceScoping = ACROSS_ALL_SESSIONS.

اختياريّ. في حال عدم تحديد هذه السمة، يستخدم stepScoping نفس UserCriteriaScoping مثل sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

يطابق أحد المستخدمين خطوة التسلسل هذه إذا تطابقت أحداثه مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات.

UserSegmentExclusion

تُحدِّد المستخدِمين المستبعَدين في هذه الشريحة.

تمثيل JSON 
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
الحقول
userExclusionDuration

enum (UserExclusionDuration)

تحدِّد هذه السياسة مدة استمرار الاستبعاد إذا تطابق مستخدم مع userExclusionCriteria.

اختياريّ. في حال عدم تحديد قيمة، يتم استخدام userExclusionDuration من إجمالي USER_EXCLUSION_TEMPORARY.
userExclusionCriteria

object (UserSegmentCriteria)

إذا استوفى مستخدم هذا الشرط، سيتم استبعاد المستخدم من العضوية في شريحة userExclusionDuration.

UserExclusionDuration

لسرد خيارات مدة الاستبعاد إذا تطابق مستخدم مع userExclusionCriteria.

عمليات التعداد
USER_EXCLUSION_DURATION_UNSPECIFIED مدة الاستبعاد غير محدّدة. يُرجى عدم التحديد.
USER_EXCLUSION_TEMPORARY استبعاد المستخدِمين مؤقتًا من الشريحة خلال الفترات التي يستوفي فيها المستخدِم شرط userExclusionCriteria.
USER_EXCLUSION_PERMANENT استبعاد المستخدِمين من الشريحة نهائيًا إذا استوفى المستخدِم شرط userExclusionCriteria في أي وقت.

SessionSegment

شرائح الجلسات هي مجموعات فرعية من الجلسات التي حدثت على موقعك الإلكتروني أو تطبيقك: على سبيل المثال، جميع الجلسات التي نشأت من حملة إعلانية معيّنة.

تمثيل JSON 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
الحقول
sessionInclusionCriteria

object (SessionSegmentCriteria)

تحدد الجلسات المضمّنة في هذه الشريحة. اختياريّ.
exclusion

object (SessionSegmentExclusion)

تحدد الجلسات المستبعدة في هذه الشريحة. اختياريّ.

SessionSegmentCriteria

تتطابق الجلسة مع أحد المعايير إذا كانت أحداث الجلسة تستوفي الشروط الواردة في المعايير.

تمثيل JSON 
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
الحقول
andConditionGroups[]

object (SessionSegmentConditionGroup)

تتطابق الجلسة مع هذا المعيار إذا تطابقت الجلسة مع كلّ من andConditionGroups هذه.

SessionSegmentConditionGroup

تخبر الشروط "إحصاءات Google" بالبيانات التي يجب تضمينها في الشريحة أو استبعادها منها.

تمثيل JSON 
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
الحقول
conditionScoping

enum (SessionCriteriaScoping)

يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع مجموعة الشروط. يحدِّد هذا النطاق عدد الأحداث التي يتم تقييم segmentFilterExpression استنادًا إليها قبل تحديد ما إذا كانت مجموعة الشروط مطابقة أم لا. على سبيل المثال، إذا كانت السمة conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION، يتم تقييم التعبير بناءً على جميع الأحداث في جلسة معيّنة، ثم يتم تحديد مجموعة الشروط لتكون مطابقة أو لا تتطابق مع هذه الجلسة. على سبيل المثال، إذا كانت السمة conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT، يتم تقييم التعبير استنادًا إلى حدث واحد، ثم يتم تحديد أنّ مجموعة الشروط متطابقة أو لا تتطابق مع هذه الجلسة.

اختياريّ. في حال عدم تحديد قيمة، يتم استخدام conditionScoping من WITHIN_SAME_SESSION.
segmentFilterExpression

object (SegmentFilterExpression)

يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات.

SessionCriteriaScoping

يحدِّد النطاق الأحداث التي يتم وضعها في الاعتبار عند تقييم ما إذا كانت الجلسة تستوفي أحد المعايير.

عمليات التعداد
SESSION_CRITERIA_SCOPING_UNSPECIFIED تحديد نطاق معايير غير محدّدة يُرجى عدم التحديد.
SESSION_CRITERIA_WITHIN_SAME_EVENT وإذا تم استيفاء المعايير ضمن حدث واحد، ستتطابق الجلسة مع المعايير.
SESSION_CRITERIA_WITHIN_SAME_SESSION إذا تم استيفاء المعايير خلال جلسة واحدة، تتطابق الجلسة مع المعايير.

SessionSegmentExclusion

تُحدِّد الجلسات التي يتم استبعادها في هذه الشريحة.

تمثيل JSON 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
الحقول
sessionExclusionDuration

enum (SessionExclusionDuration)

تحدِّد هذه السياسة مدة استمرار الاستبعاد إذا تطابقت إحدى الجلسات مع sessionExclusionCriteria.

اختياريّ. في حال عدم تحديد قيمة، يتم استخدام sessionExclusionDuration من SESSION_EXCLUSION_TEMPORARY.
sessionExclusionCriteria

object (SessionSegmentCriteria)

وإذا استوفت جلسة هذا الشرط، يتم استبعاد الجلسة من العضوية في شريحة sessionExclusionDuration.

SessionExclusionDuration

لسرد خيارات مدة الاستبعاد إذا كانت الجلسة تطابق sessionExclusionCriteria.

عمليات التعداد
SESSION_EXCLUSION_DURATION_UNSPECIFIED مدة الاستبعاد غير محدّدة. يُرجى عدم التحديد.
SESSION_EXCLUSION_TEMPORARY استبعاد الجلسات مؤقتًا من الشريحة خلال الفترات التي تستوفي فيها الجلسة شرط sessionExclusionCriteria
SESSION_EXCLUSION_PERMANENT استبعاد الجلسات نهائيًا من الشريحة إذا استوفت الجلسة شرط sessionExclusionCriteria في أي وقت.

EventSegment

شرائح الأحداث هي مجموعات فرعية من الأحداث التي تم تشغيلها على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، جميع أحداث الشراء التي تمّت في موقع جغرافي معيّن أحداث app_exception التي حدثت على نظام تشغيل محدَّد.

تمثيل JSON 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
الحقول
eventInclusionCriteria

object (EventSegmentCriteria)

تحدد الأحداث التي يتم تضمينها في هذه الشريحة. اختياريّ.
exclusion

object (EventSegmentExclusion)

تحدِّد الأحداث المستثناة في هذه الشريحة. اختياريّ.

EventSegmentCriteria

يتطابق الحدث مع أحد المعايير إذا كان الحدث يستوفي الشروط المحدّدة.

تمثيل JSON 
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
الحقول
andConditionGroups[]

object (EventSegmentConditionGroup)

يتطابق حدث مع هذه المعايير إذا كان الحدث يتطابق مع كلٍ من andConditionGroups هذه.

EventSegmentConditionGroup

تخبر الشروط "إحصاءات Google" بالبيانات التي يجب تضمينها في الشريحة أو استبعادها منها.

تمثيل JSON 
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
الحقول
conditionScoping

enum (EventCriteriaScoping)

يجب أن تكون القيمة conditionScoping دائمًا EVENT_CRITERIA_WITHIN_SAME_EVENT.

اختياريّ. في حال عدم تحديد قيمة، يتم استخدام conditionScoping من EVENT_CRITERIA_WITHIN_SAME_EVENT.
segmentFilterExpression

object (SegmentFilterExpression)

يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات.

EventCriteriaScoping

يحدِّد النطاق الأحداث التي يتمّ وضعها في الاعتبار عند تقييم ما إذا كان الحدث يستوفي أحد المعايير.

عمليات التعداد
EVENT_CRITERIA_SCOPING_UNSPECIFIED تحديد نطاق معايير غير محدّدة يُرجى عدم التحديد.
EVENT_CRITERIA_WITHIN_SAME_EVENT فإذا تم استيفاء المعايير داخل حدث واحد، فإن الحدث يطابق المعايير.

EventSegmentExclusion

لتحديد الأحداث التي يتم استثناؤها في هذه الشريحة.

تمثيل JSON 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
الحقول
eventExclusionDuration

enum (EventExclusionDuration)

يجب أن تكون قيمة eventExclusionDuration دائمًا PERMANENTLY_EXCLUDE.

اختياريّ. في حال عدم تحديد قيمة، يتم استخدام eventExclusionDuration من EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

إذا استوفى حدث هذا الشرط، سيتم استبعاد الحدث من العضوية في شريحة "eventExclusionDuration".

EventExclusionDuration

لتعداد الخيارات لمدة الاستثناء إذا كان حدث تطابق eventExclusionCriteria.

عمليات التعداد
EVENT_EXCLUSION_DURATION_UNSPECIFIED مدة الاستبعاد غير محدّدة. يُرجى عدم التحديد.
EVENT_EXCLUSION_PERMANENT استبعاد الأحداث نهائيًا من الشريحة إذا استوفى الحدث شرط eventExclusionCriteria في أي وقت.

FunnelSubReport

تتضمّن تقارير مسارات الإحالات الناجحة الفرعية قيم بيانات السمات والمقاييس. على سبيل المثال، وصل 12 مستخدمًا إلى الخطوة الثانية من مسار الإحالة الناجحة.

تمثيل JSON 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
الحقول
dimensionHeaders[]

object (DimensionHeader)

يصف أعمدة السمات. وتتضمّن تقارير مسارات الإحالات الناجحة دائمًا سمة الخطوة في مسار الإحالة الناجحة في الردود على التقارير الفرعية. وقد تتوفّر سمات إضافية في الردّ إذا لزم الأمر، مثل البيانات التفصيلية والتواريخ والإجراءات التالية.
metricHeaders[]

object (MetricHeader)

تصف أعمدة المقاييس. تتضمّن تقارير مسارات الإحالات الناجحة دائمًا المستخدمين النشطين في الردود على التقارير الفرعية. يتضمّن جدول مسار الإحالة الناجحة مقاييس إضافية مثل معدّل الإكمال، ومعدّل المغادرة، ومعدّل التراجع.
rows[]

object (Row)

صفوف مجموعات قيم السمات وقيم المقاييس في التقرير
metadata

object (FunnelResponseMetadata)

البيانات الوصفية لتقرير مسار الإحالة الناجحة

FunnelResponseMetadata

تتضمّن البيانات الوصفية للاستجابة في تقرير مسار الإحالة الناجحة معلومات إضافية عن تقرير مسار الإحالة الناجحة.

تمثيل JSON 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
الحقول
samplingMetadatas[]

object (SamplingMetadata)

إذا كانت نتائج تقرير مسار الإحالة الناجحة مستنِدة إلى عيّنات، يصف هذا المقياس النسبة المئوية للأحداث التي تم استخدامها في تقرير مسار الإحالة الناجحة هذا. تتم تعبئة samplingMetadatas واحد لكل نطاق زمني. يتوافق كل samplingMetadatas مع نطاق زمني بالترتيب الذي تم فيه تحديد النطاقات الزمنية في الطلب.

ومع ذلك، إذا لم يتم أخذ عينات من النتائج، لن يتم تحديد هذا الحقل.

SamplingMetadata

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

تمثيل JSON 
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
الحقول
samplesReadCount

string (int64 format)

إجمالي عدد الأحداث التي تمت قراءتها في هذا التقرير المستند إلى عينات في نطاق زمني معيّن. هذا هو حجم المجموعة الفرعية لبيانات هذا الموقع التي تم تحليلها في تقرير مسار الإحالة الناجحة هذا.
samplingSpaceSize

string (int64 format)

إجمالي عدد الأحداث المتاحة في بيانات هذا الموقع والتي كان من الممكن تحليلها في تقرير مسار الإحالة الناجحة هذا لنطاق زمني يكشف أخذ العينات عن المعلومات المفيدة حول مجموعة البيانات الأكبر، وهذا هو حجم مجموعة البيانات الأكبر.

لاحتساب النسبة المئوية للبيانات المتاحة التي تم استخدامها في تقرير مسار الإحالة الناجحة هذا، احسب samplesReadCount/samplingSpaceSize.

PropertyQuota

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

تمثيل JSON 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
الحقول
tokensPerDay

object (QuotaStatus)

يمكن لمواقع "إحصاءات Google" العادية استخدام ما يصل إلى 200,000 رمز مميّز في اليوم. يمكن لمواقع "إحصاءات 360" استخدام 2,000,000 رمز مميّز في اليوم. تستهلك معظم الطلبات أقل من 10 رموز مميّزة.
tokensPerHour

object (QuotaStatus)

يمكن لمواقع "إحصاءات Google" العادية استخدام ما يصل إلى 40,000 رمز مميّز في الساعة. يمكن لمواقع "إحصاءات 360" استخدام 400,000 رمز مميّز في الساعة. يستهلك طلب واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميزة، ويتم خصم هذا الرقم من جميع الحصص كل ساعة ويومية ولكل مشروع.
concurrentRequests

object (QuotaStatus)

يمكن لمواقع "إحصاءات Google" العادية إرسال ما يصل إلى 10 طلبات متزامنة. يمكن لمواقع "إحصاءات 360" استخدام ما يصل إلى 50 طلبًا متزامنًا.
serverErrorsPerProjectPerHour

object (QuotaStatus)

يمكن أن تتضمّن مواقع "إحصاءات Google" العادية وأزواج المشاريع على السحابة الإلكترونية ما يصل إلى 10 أخطاء في الخادم في الساعة. يمكن أن تسجِّل مواقع "إحصاءات 360" والمشاريع على السحابة الإلكترونية ما يصل إلى 50 خطأ في الخادم في الساعة.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

يمكن لمواقع "إحصاءات Google" إرسال ما يصل إلى 120 طلبًا بسمات يُحتمَل أن يتم تطبيق حدود عليها في الساعة. في الطلب المجمّع، يتم احتساب كل طلب تقرير بشكل فردي لهذه الحصة إذا كان الطلب يحتوي على سمات يُحتمل أن تكون قد بلغت الحدّ الأدنى.
tokensPerProjectPerHour

object (QuotaStatus)

يمكن لمواقع "إحصاءات Google" استخدام ما يصل إلى 35% من رموزها المميّزة لكلّ مشروع في الساعة. ويبلغ هذا الحد بالنسبة إلى مواقع "إحصاءات Google" العادية ما يصل إلى 14,000 رمز مميّز لكلّ مشروع في الساعة، ويمكن لمواقع "إحصاءات 360" استخدام 140,000 رمز مميّز لكلّ مشروع في الساعة. يستهلك طلب واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميزة، ويتم خصم هذا الرقم من جميع الحصص كل ساعة ويومية ولكل مشروع.

QuotaStatus

الحالة الحالية لمجموعة حصص معيّنة.

تمثيل JSON 
{
  "consumed": integer,
  "remaining": integer
}
الحقول
consumed

integer

الحصة التي يستهلكها هذا الطلب.
remaining

integer

الحصة المتبقية بعد هذا الطلب.