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

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

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

ينتج كلّ جزء محدّد في هذا الطلب صفًا منفصلاً في الاستجابة، ويتمّ تحديد كلّ جزء في الاستجابة باسمه.

المَعلمة segments اختيارية. تقتصر الطلبات على 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)

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

object (FunnelFilterExpressionList)

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

object (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 بعلاقة OR.
notExpression

object (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". على سبيل المثال، من بين المجموعة الكاملة من مستخدِمي موقعك، قد تتألف إحدى الشرائح من المستخدِمين من بلد معيّن أو مدينة معيّنة. ويمكن أن تتألف شريحة أخرى من المستخدِمين الذين يشترون خط منتجات معيّنًا أو يزورون جزءًا محددًا من موقعك أو يشغّلون أحداثًا معيّنة في تطبيقك.

لمزيد من المعلومات، يمكنك الاطّلاع على أداة إنشاء الشرائح.

تمثيل 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. Segment", "2. Segment"، وما إلى ذلك).
حقل الربط 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)

ترتبط SegmentFilterExpression في andGroup بعلاقة AND.
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)

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

object (SegmentParameterFilterExpressionList)

ترتبط SegmentParameterFilterExpression في orGroup بعلاقة OR.
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، وكان اسم الحدث هو "purchase"، وكانت مَعلمة الحدث هي "event_count"، وكانت معايير الفلتر أكبر من 5، سيجمع هذا الفلتر عدد أحداث الشراء على مدار كل فترة 3 أيام متتالية في النطاق الزمني للتقرير، وسيستوفي المستخدِم معايير هذا الفلتر ليتم تضمينه في هذا الشريحة إذا تجاوز عدد أحداث الشراء 5 في أي فترة 3 أيام متتالية. على سبيل المثال، سيتمّ اعتبار الفترات من 1 تشرين الثاني (نوفمبر) 2021 إلى 3 تشرين الثاني (نوفمبر) 2021، و2 تشرين الثاني (نوفمبر) 2021 إلى 4 تشرين الثاني (نوفمبر) 2021، و3 تشرين الثاني (نوفمبر) 2021 إلى 5 تشرين الثاني (نوفمبر) 2021، وما إلى ذلك.

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

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

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

object (UserSequenceStep)

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

UserSequenceStep

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

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

boolean

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

وفي حال عدم تحليل عيّنات من النتائج، لن يتم تحديد هذا الحقل.