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 وليس في النص الأساسي. للمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. ضمن الطلب المجمّع، يجب أن تكون هذه السمة غير محدّدة أو متسقة مع السمة على المستوى المجمّع.

مثال: Property/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

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

isDirectlyFollowedBy

boolean

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

filterExpression

object (FunnelFilterExpression)

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

withinDurationFromPriorStep

string (Duration format)

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

السمة 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)

هناك علاقة AND في FunnelFilterExpression في andGroup.

orGroup

object (FunnelFilterExpressionList)

هناك علاقة "أو" بين دالة FunnelFilterExpression في orGroup.

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)

العلاقة "و" للدالة FunnelParameterFilterExpression في andGroup.

orGroup

object (FunnelParameterFilterExpressionList)

هناك علاقة "أو" للمعلَمة FunnelParameterFilterExpression في orGroup.

notExpression

object (FunnelParameterFilterExpression)

قيمة FunnelParameterFilterExpression ليست من 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" و"currency".

لا يمكن استخدام مَعلمات الأحداث إلّا في الشرائح ومسارات الإحالات الناجحة ولا يمكن استخدامها إلّا في فلتر تنازلي من 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)

هناك علاقة AND في andGroup.

orGroup

object (SegmentFilterExpressionList)

هناك علاقة "أو" للعلاقة "ClipFilterExpression" في orGroup.

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 = false في حال عدم تحديده.

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)

هناك علاقة AND في andGroup.

orGroup

object (SegmentParameterFilterExpressionList)

هناك علاقة "أو" للمعلَمة ClipParameterFilterExpression في orGroup.

notExpression

object (SegmentParameterFilterExpression)

قيمة segmentParameterFilterExpression ليست من 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" و"currency".

لا يمكن استخدام مَعلمات الأحداث إلّا في الشرائح ومسارات الإحالات الناجحة ولا يمكن استخدامها إلّا في فلتر تنازلي من 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 إلى 2021-11-01، و2021-11-01 إلى 2021-11-02، و2021-11-01 إلى 2021-11-03، و2021-11-02-2021-10-01.

وتُعدّ السمة 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

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

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 رمز مميّز في اليوم، ويمكن لمواقع "إحصاءات Google 360" استخدام 2,000,000 رمز مميّز في اليوم. تستهلك معظم الطلبات أقل من 10 رموز مميّزة.

tokensPerHour

object (QuotaStatus)

يمكن أن تستخدم مواقع "إحصاءات Google" العادية ما يصل إلى 40,000 رمز مميّز في الساعة، في حين يمكن لمواقع "إحصاءات Google 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 رمز مميّز لكل مشروع في الساعة، ويمكن لمواقع "إحصاءات Google 360" استخدام 140,000 رمز مميّز لكل مشروع في الساعة. يستهلك طلب واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميّزة، ويتم خصم هذا الرقم من جميع الحصص بالساعة واليومية ولكل مشروع.

QuotaStatus

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

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

integer

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

remaining

integer

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