Method: properties.runFunnelReport

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

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
property

string

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

مثال: الخصائص/1234

نص الطلب

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

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

object (DateRange)

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

object (Funnel)

ضبط مسار الإحالة الناجحة هذا للطلب. ضبط مسار الإحالة الناجحة هذا مطلوب.
funnelBreakdown

object (FunnelBreakdown)

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

object (FunnelNextAction)

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

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

enum (FunnelVisualizationType)

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

object (Segment)

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

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

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

string (int64 format)

عدد الصفوف المطلوب عرضها. وفي حال عدم تحديد ذلك، يتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 100,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

نطاق التاريخ

مجموعة متجاورة من الأيام: startDate، وStartDate + 1، و...، وEndDate. يُسمح بالطلبات لما يصل إلى 4 نطاقات زمنية.

تمثيل JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
الحقول
startDate

string

تاريخ البدء الشامل لطلب البحث بالتنسيق YYYY-MM-DD. لا يمكن ذلك بعد endDate. يتم أيضًا قبول التنسيق NdaysAgo أو yesterday أو today، وفي هذه الحالة، يتم استنتاج التاريخ استنادًا إلى المنطقة الزمنية لإعداد التقارير في الموقع.
endDate

string

تمثّل هذه السمة تاريخ الانتهاء الشامل لطلب البحث بالتنسيق YYYY-MM-DD. لا يمكن أن يكون الحدث قبل startDate. يتم أيضًا قبول التنسيق NdaysAgo أو yesterday أو today، وفي هذه الحالة، يتم استنتاج التاريخ استنادًا إلى المنطقة الزمنية لإعداد التقارير في الموقع.
name

string

تخصيص اسم لهذا النطاق الزمني. البُعد dateRange مهم لهذا الاسم في استجابة التقرير. وفي حال ضبطها، لا يمكن أن يبدأ بـ date_range_ أو RESERVED_. وفي حال تم ترك هذه السياسة بدون ضبط، يتم تسمية النطاقات الزمنية حسب فهرسها صفر في الطلب: date_range_0 أو date_range_1 وما إلى ذلك.

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

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

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

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

boolean

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

object (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 اختيارية، وفي حال عدم تحديدها، يمكن فصل الخطوات حسب أي مدة زمنية.

مدة بالثواني يتكوَّن من تسعة أرقام كسور تنتهي بـ &#39؛s&#39؛ على سبيل المثال: "3.5s".

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

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

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

يملك تعبير Funnelفلترة Express في andGroup علاقة (و).
orGroup

object (FunnelFilterExpressionList)

إنّ التعبير عن مسار الإحالة الناجحة في orGroup مرتبط بعلاقة "أو".
notExpression

object (FunnelFilterExpression)

إنّ التعبير عن مسار الإحالة الناجحة ليس من notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

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

object (FunnelEventFilter)

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

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

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

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

object (FunnelFilterExpression)

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

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

تعبير لفلترة قيم المكوّنات أو المقاييس.

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

فلتر بين قيمتَين

فلتر السلسلة

فلتر السلسلة

تمثيل JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
الحقول
matchType

enum (MatchType)

نوع المطابقة لهذا الفلتر.
value

string

قيمة السلسلة المستخدَمة للمطابقة.
caseSensitive

boolean

إذا كانت القيمة صحيحة، تكون قيمة السلسلة حسّاسة لحالة الأحرف.

نوع المطابقة

نوع مطابقة فلتر السلسلة

عمليات التعداد
MATCH_TYPE_UNSPECIFIED غير محدّد
EXACT المطابقة التامة لقيمة السلسلة.
BEGINS_WITH تبدأ بقيمة السلسلة.
ENDS_WITH ينتهي بقيمة السلسلة.
CONTAINS يحتوي على قيمة السلسلة.
FULL_REGEXP مطابقة كاملة للتعبير العادي مع قيمة السلسلة.
PARTIAL_REGEXP المطابقة الجزئية للتعبير العادي مع قيمة السلسلة.

فلتر InList

يجب أن تكون النتيجة في قائمة من قيم السلاسل.

تمثيل JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
الحقول
values[]

string

قائمة قيم السلسلة. يجب ألا يكون الحقل فارغًا.
caseSensitive

boolean

إذا كانت القيمة صحيحة، تكون قيمة السلسلة حسّاسة لحالة الأحرف.

فلتر رقمي

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

تمثيل JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
الحقول
operation

enum (Operation)

نوع العملية لهذا الفلتر.
value

object (NumericValue)

قيمة رقمية أو قيمة تاريخ

العملية

تم تطبيق العملية على فلتر رقمي.

عمليات التعداد
OPERATION_UNSPECIFIED غير محدد
EQUAL متوازن
LESS_THAN أقل من
LESS_THAN_OR_EQUAL أقل من أو مساوٍ
GREATER_THAN أكبر من
GREATER_THAN_OR_EQUAL أكبر من أو يساوي

القيمة الرقمية

لتمثيل رقم.

تمثيل JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
الحقول
حقل الاتحاد one_value. يمكن أن تكون إحدى القيم الرقمية one_value واحدًا فقط مما يلي:
int64Value

string (int64 format)

قيمة عدد صحيح
doubleValue

number

قيمة مزدوجة

الفلتر بين

للتعبير عن ضرورة أن تكون النتيجة بين رقمَين (شاملَين).

تمثيل JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
الحقول
fromValue

object (NumericValue)

يبدأ بهذا الرقم.
toValue

object (NumericValue)

ينتهي بهذا الرقم.

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

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

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

string

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

object (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)

إنّ المعلّمة FunnelParameterFilter Expression في andGroup لها علاقة بالعلاقة"و".
orGroup

object (FunnelParameterFilterExpressionList)

إنّ المعلّمة FunnelParameterFilter Expression في orGroup لها علاقة "أو".
notExpression

object (FunnelParameterFilterExpression)

إنّ مسار الإحالة الناجحة"مسار المعلَمة"ليس من notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

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

قائمة المعلّمات لمسار الإحالة الناجحة

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

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

object (FunnelParameterFilterExpression)

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

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

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

تمثيل 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;firebase_screen" & "currency".

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

string

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

لا يمكن استخدام معلّمات العناصر إلا في شرائح &مسارات الإحالة الناجحة، ولا يمكن استخدامها إلا في فلتر تنازلي من فلتر Event. في فلتر تنازلي من خلال Eventفلترة، يجب استخدام معلّمات الحدث أو السلعة.

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

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

فلتر بين قيمتَين

تقسيم مسار الإحالة الناجحة

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

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

object (Dimension)

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

string (int64 format)

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

السمة

تمثِّل الأبعاد سمات بياناتك. على سبيل المثال، تشير سمة البُعد "المدينة" إلى المدينة التي نشأ منها حدث. قيم المكوّن في ردود التقرير هي سلاسل، على سبيل المثال، المدينة يمكن أن تكون "باريس" أو "نيويورك&quot.

تمثيل JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
الحقول
name

string

اسم السمة. ارجع إلى أبعاد واجهة برمجة التطبيقات للاطّلاع على قائمة بأسماء السمات.

إذا تم تحديد dimensionExpression، يمكن أن يكون name أي سلسلة تريدها ضمن مجموعة الأحرف المسموح بها. على سبيل المثال، إذا كانت السمة dimensionExpression تربط country وcity، يمكنك استدعاء تلك السمة countryAndCity. يجب أن تتطابق أسماء السمات التي تختارها مع التعبير العادي ^[a-zA-Z0-9_]$.

تتم الإشارة إلى الأبعاد من قِبل name في dimensionFilter وorderBys وdimensionExpression وpivots.
dimensionExpression

object (DimensionExpression)

يمكن أن يكون البُعد واحد ناتجًا عن تعبير للأبعاد المتعددة. على سبيل المثال، البُعد "و"؛ البلد، "المدينة": ""اتصال" (البلد، &"؛" &"؛ "المدينة").

التعبير عن البُعد

يُستخدَم للتعبير عن بُعد يكون ناتجًا عن صيغة من أبعاد متعدّدة. أمثلة على الاستخدامات: 1) الأحرف الصغيرة(البُعد) 2) السلسلة(البُعد 1، الرمز، البُعد 2).

تمثيل JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
الحقول
حقل الاتحاد one_expression. حدِّد نوعًا واحدًا من تعبيرات السمات للسمة DimensionExpression. يمكن أن يكون one_expression واحدًا فقط مما يلي:
lowerCase

object (CaseExpression)

يُستخدَم لتحويل قيمة سمة إلى أحرف صغيرة.
upperCase

object (CaseExpression)

يُستخدَم لتحويل قيمة سمة إلى أحرف كبيرة.
concatenate

object (ConcatenateExpression)

يُستخدَم لدمج قيم البُعد مع سمة واحدة. على سبيل المثال، البُعد "و"؛ البلد، "المدينة": ""اتصال" (البلد، &"؛" &"؛ "المدينة").

تعبير عن الحالة

يُستخدَم لتحويل قيمة سمة إلى حالة واحدة.

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

string

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

التعبير التعبيري

يُستخدَم لدمج قيم البُعد مع سمة واحدة.

تمثيل JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
الحقول
dimensionNames[]

string

أسماء السمات ويجب أن تشير الأسماء مرة أخرى إلى الأسماء في حقل الأبعاد في الطلب.
delimiter

string

المُحدِّد بين أسماء السمات.

غالبًا ما تكون المحدّدات أحرفًا فردية مثل "|" أو &&;;;;;;;، ولكن يمكن أن تكون سلاسل أطول. إذا كانت قيمة البُعد تحتوي على المُحدِّد، سيتم عرض كليهما استجابةً بدون اختلاف. على سبيل المثال، إذا كانت قيمة البُعد 1 = "US,FR" والمكوّن 2 = "JP" والمُحدِّد = "&;;;; ، حينئذٍ ستحتوي الاستجابة على "US,FR,JP&quot.

إجراء الإحالة الناجحة التالي

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

نوع التمثيل البصري لمسار الإحالة الناجحة

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

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

قسم

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

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

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

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

string

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

object (UserSegment)

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

object (SessionSegment)

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

object (EventSegment)

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

شريحة المستخدم

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

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

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

معايير شرائح المستخدمين

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

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

object (UserSegmentConditionGroup)

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

object (UserSegmentSequenceGroup)

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

تصنيف شرائح المستخدمين

تخبر الشروط "إحصاءات 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)

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

تحديد معايير المستخدم

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

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

تعبير الشريحة

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

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

إنّ فلتر Express Expression في andGroup له علاقة AND.
orGroup

object (SegmentFilterExpressionList)

إنّ فلتر الانعطاف في orGroup مرتبط بعلاقة "أو".
notExpression

object (SegmentFilterExpression)

تصنيف هذه الشريحة ليست من notExpression.
segmentFilter

object (SegmentFilter)

فلتر شريحة أساسية.
segmentEventFilter

object (SegmentEventFilter)

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

قائمة شرائح Express

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

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

object (SegmentFilterExpression)

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

فلتر الشرائح

تعبير لفلترة قيم المكوّنات أو المقاييس.

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

فلتر بين قيمتَين

تقسيم الشريحة

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

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

boolean

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

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

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

إذا كان معيار اختيار السياسة ACROSS_ALL_SESSIONS، يتم استخدام atAnyPointInTime = false إذا لم يتم تحديد قيمة.

فلتر الحدث

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

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

string

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

object (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)

إنّ المعلّمةالشرائح المعلّمة في andGroup تتضمّن علاقة (و).
orGroup

object (SegmentParameterFilterExpressionList)

إنّص المعلّمةالشرائح المعلّمة في orGroup لها علاقة باستخدام "أو".
notExpression

object (SegmentParameterFilterExpression)

إنّ المعلّمةالشرائح المعلّمة ليست للسمة notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

فلتر معلّمات أولية

معرّف الشريحة ضمن الشريحة

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

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

object (SegmentParameterFilterExpression)

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

فلتر الشرائح

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

تمثيل 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;firebase_screen" & "currency".

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

string

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

لا يمكن استخدام معلّمات العناصر إلا في شرائح &مسارات الإحالة الناجحة، ولا يمكن استخدامها إلا في فلتر تنازلي من فلتر Event. في فلتر تنازلي من خلال Eventفلترة، يجب استخدام معلّمات الحدث أو السلعة.

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

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

فلتر بين قيمتَين

تقسيم معلّمات الشرائح

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

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

string (int64 format)

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

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

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

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

مجموعة شرائح المستخدمين

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

تمثيل 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 اختياريًا، وفي حال عدم تحديده، يمكن إكمال التسلسلات في أي فترة زمنية.

مدة بالثواني يتكوَّن من تسعة أرقام كسور تنتهي بـ &#39؛s&#39؛ على سبيل المثال: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

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

خطوة التسلسل للمستخدم

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

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

boolean

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

enum (UserCriteriaScoping)

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

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

object (SegmentFilterExpression)

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

استبعاد شرائح المستخدمين

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

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

enum (UserExclusionDuration)

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

اختياريّ. إذا لم يتم تحديدها، سيتم استخدام userExclusionDuration من USER_EXCLUSION_TEMPORARY.
userExclusionCriteria

object (UserSegmentCriteria)

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

مدة استبعاد المستخدم

إحصاء الخيارات المتعلقة بمدة الاستبعاد في حال مطابقة المستخدم userExclusionCriteria.

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

شريحة الجلسة

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

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

object (SessionSegmentCriteria)

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

object (SessionSegmentExclusion)

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

معايير شريحة الجلسة

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

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

object (SessionSegmentConditionGroup)

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

تصنيف شريحة الجلسة

تخبر الشروط "إحصاءات 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)

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

تحديد نطاق الجلسة

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

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

استبعاد شريحة الجلسة

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

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

enum (SessionExclusionDuration)

تحدِّد هذه السياسة طول مدة الاستبعاد في حال كانت الجلسة تتطابق مع sessionExclusionCriteria.

اختياريّ. إذا لم يتم تحديدها، سيتم استخدام sessionExclusionDuration من SESSION_EXCLUSION_TEMPORARY.
sessionExclusionCriteria

object (SessionSegmentCriteria)

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

مدة استبعاد الجلسة

إحصاء خيارات مدة استمرار الاستبعاد في حال مطابقة الجلسة sessionExclusionCriteria.

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

شريحة الحدث

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

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

object (EventSegmentCriteria)

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

object (EventSegmentExclusion)

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

معايير شرائح الجمهور

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

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

object (EventSegmentConditionGroup)

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

فئة الحدث

تخبر الشروط "إحصاءات 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)

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

تحديد معايير الأحداث

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

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

استثناء شرائح الجمهور

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

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

enum (EventExclusionDuration)

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

اختياريّ. إذا لم يتم تحديدها، سيتم استخدام eventExclusionDuration من EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

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

مدة استبعاد الحدث

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

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

تعبير الفلتر

للتعبير عن فلاتر المكوّنات أو المقاييس. يجب أن تكون الحقول في تطبيق Express Expression نفسه إما جميع السمات أو كل المقاييس.

تمثيل JSON 
{

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

object (FilterExpressionList)

إنّ للتعبيرات في مجموعة وأنّ هناك علاقة بين "و".
orGroup

object (FilterExpressionList)

إنّ التعبيرات في مجموعة مدمَجة لها علاقة مع OR.
notExpression

object (FilterExpression)

التعبير التعبيري ليس للتعبير عن Express.
filter

object (Filter)

فلتر أولي. في فلتر Express Expression نفسه، يجب أن تكون جميع أسماء حقول "الفلتر" إما جميع الأبعاد أو كل المقاييس.

قائمة الفلاتر

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

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

object (FilterExpression)

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

تصفية

تعبير لفلترة قيم المكوّنات أو المقاييس.

تمثيل 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. اختر نوعًا واحدًا للفلتر Filter. يمكن أن يكون one_filter واحدًا فقط مما يلي:
stringFilter

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

فلتر بين قيمتَين

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

تحتوي التقارير الفرعية لمسار الإحالة الناجحة على قيم بيانات السمات والمقاييس. على سبيل المثال، وصل 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)

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

عنوان البُعد

يصف عمود البُعد في التقرير. تنتج السمات المطلوبة في أحد التقارير إدخالات الأعمدة ضمن الصفوف وHeadersHeaders. ومع ذلك، فإن المكوّنات المستخدمة حصريًا ضمن الفلاتر أو التعبيرات لا تؤدي إلى ظهور أعمدة في التقرير، في المقابل، لا تنتج هذه المكوّنات رؤوسًا.

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

string

اسم المكوّن.

عنوان المقياس

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

تمثيل JSON 
{
  "name": string,
  "type": enum (MetricType)
}
الحقول
name

string

تمثّل هذه السمة اسم المقياس.
type

enum (MetricType)

نوع بيانات المقياس.

نوع المقياس

نوع قيمة المقياس.

عمليات التعداد
METRIC_TYPE_UNSPECIFIED نوع غير محدّد.
TYPE_INTEGER نوع صحيح
TYPE_FLOAT نوع النقطة العائمة
TYPE_SECONDS مدة الثواني، نوع خاص من النقاط العائمة
TYPE_MILLISECONDS مدة بالمللي ثانية؛ نوع نقطة عائمة خاص.
TYPE_MINUTES تمثّل هذه السمة مدة بالدقائق، بالإضافة إلى نوع خاص من النقاط العائمة.
TYPE_HOURS تمثّل هذه السمة مدة بالساعات، ونوع خاص من النقاط العائمة.
TYPE_STANDARD مقياس مخصّص من النوع العادي، ونوع خاص من النقاط العائمة.
TYPE_CURRENCY مبلغ من المال، نوع خاص من نقاط عائمة.
TYPE_FEET طول القدم، نوع نقطة عائمة خاص.
TYPE_MILES طول بالأميال، نوع خاص من النقاط العائمة.
TYPE_METERS طول متر بالمتر، وهو نوع خاص من النقاط العائمة.
TYPE_KILOMETERS طول الكيلومتر، وهو نوع نقطة عائمة خاص.

الصف

الإبلاغ عن البيانات لكل صف. على سبيل المثال، إذا كان RunReportRequest يحتوي على:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

الصف الذي يحتوي على 'in_app_purchase' مثل eventName و##39;JP' مثل countryId، و15 بصفته eventCount، سيكون:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
تمثيل JSON 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
الحقول
dimensionValues[]

object (DimensionValue)

قائمة قيم السمات المطلوبة. في محور التقارير، لا يتم إدراج قيم البُعد إلا للأبعاد المضمّنة في المحور.
metricValues[]

object (MetricValue)

قائمة قيم المقاييس المرئية المطلوبة.

قيمة السمة

قيمة السمة.

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

string

القيمة كسلسلة إذا كان نوع السمة سلسلة.

قيمة المقياس

قيمة المقياس.

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

string

قيمة القياس. يمكنك الاطّلاع على MetricHeader للنوع.

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

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

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

object (SamplingMetadata)

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

ومع ذلك، إذا لم تكن النتائج مستندة إلى عينات، لن يتم تعريف هذا الحقل.

تحليل عينات البيانات الوصفية

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

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

string (int64 format)

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

string (int64 format)

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

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

حصة الملكية

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

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

يمكن أن تستخدم مواقع "إحصاءات Google" ما يصل إلى 25% من رموزها المميّزة لكل مشروع في الساعة. ويمكن أن تستخدِم هذه المبالغ في المواقع العادية على "إحصاءات Google" ما يصل إلى 1,250 رمزًا مميزًا لكل مشروع في الساعة، ويمكن أن تستخدم المواقع على "إحصاءات 360" 12,500 رمز مميّز لكل مشروع في الساعة. يستهلك طلب البيانات من واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميزة، ويتم خصم هذا الرقم من جميع حصص كل ساعة وكل يوم ولكل مشروع.

حالة الحصة

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

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

integer

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

integer

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