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 على أنّه خطأ.
filterExpression

object (FunnelFilterExpression)

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

string (Duration format)

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

withinDurationFromPriorStep هو حقل اختياري، وفي حال عدم تحديده، يمكن الفصل بين الخطوات بأي مدة زمنية.

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

FunnelFilterExpression

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

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
حدِّد نوعًا واحدًا من الفلاتر لـ FunnelFilterExpression. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
fieldName

string

اسم السمة أو اسم المقياس
حدِّد نوعًا واحدًا من الفلاتر. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
حدِّد نوعًا واحدًا من الفلاتر لـ FunnelParameterFilterExpression. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
تمثّل هذه السمة الحقل الذي تتم فلترته. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
eventParameterName

string

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

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

string

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

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

لا تتوفّر مَعلمات المنتجات أو الخدمات إلا في أحداث التجارة الإلكترونية. لمزيد من المعلومات عن أحداث التجارة الإلكترونية، اطّلِع على دليل قياس التجارة الإلكترونية.
نهاية الحقول التي يستبعد كلّ منها الآخر
حدِّد نوعًا واحدًا من الفلاتر. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of mutually exclusive fields.
}
الحقول
name

string

اسم شريحة الجمهور هذه. في حال عدم تحديد اسم، يتم تسمية الشرائح "شريحة". يحدّد هذا الاسم قيمة السلسلة التي تعرضها السمة segment. تضيف السمة segment بادئات إلى أسماء الشرائح حسب رقم الفهرس المستند إلى الرقم 1 للشريحة في الطلب (مثلاً "1. المقطع"، "2. المقطع" وما إلى ذلك).
يتم تحديد شريحة في نطاق واحد. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
حدِّد نوعًا واحدًا من الفلاتر لـ SegmentFilterExpression. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
fieldName

string

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

object (SegmentFilterScoping)

تحدّد هذه السمة نطاق الفلتر.
حدِّد نوعًا واحدًا من الفلاتر لـ 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
حدِّد نوعًا واحدًا من الفلاتر لـ SegmentParameterFilterExpression. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eventParameterName": string,
  "itemParameterName": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of mutually exclusive fields.
}
الحقول
filterScoping

object (SegmentParameterFilterScoping)

تحدّد هذه السمة نطاق الفلتر.
تمثّل هذه السمة الحقل الذي تتم فلترته. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
eventParameterName

string

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

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

string

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

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

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

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