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)

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

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

المَعلمة "الشرائح" اختيارية. تقتصر الطلبات على 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 على أنّه false.
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)

تتضمّن FunnelFilterExpression في andGroup علاقة AND.
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)

تتضمّن FunnelParameterFilterExpression في andGroup علاقة AND.
orGroup

object (FunnelParameterFilterExpressionList)

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

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

تمثيل 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. 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 = 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)

تتضمّن 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 أيام متتالية. على سبيل المثال، سيتم أخذ الفترات من 2021-11-01 إلى 2021-11-03، ومن 2021-11-02 إلى 2021-11-04، ومن 2021-11-03 إلى 2021-11-05، وما إلى ذلك في الاعتبار.

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

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 نطاقًا زمنيًا بالترتيب الذي تم تحديده في الطلب.

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