Method: properties.runFunnelReport

string

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

مثال: Property/1234

{
  "startDate": string,
  "endDate": string,
  "name": string
}

string

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

string

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

string

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

{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}

boolean

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

object (FunnelStep)

الخطوات التسلسلية لمسار الإحالة الناجحة هذا

{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}

string

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

boolean

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

object (FunnelFilterExpression)

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

string (Duration format)

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

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

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

{

  // 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.
}

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpression)

لا يحتوي FunnelFilterExpression على notExpression.

object (FunnelFieldFilter)

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

object (FunnelEventFilter)

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

{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}

object (FunnelFilterExpression)

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

{
  "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.
}

string

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

object (StringFilter)

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

object (InListFilter)

عامل تصفية لقيم القائمة.

object (NumericFilter)

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

object (BetweenFilter)

عامل تصفية بين قيمتين.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

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

string

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

boolean

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

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

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

boolean

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

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

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

object (NumericValue)

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

{

  // 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.
}

string (int64 format)

قيمة عدد صحيح

number

قيمة مزدوجة

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

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

object (NumericValue)

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

{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}

string

يطابق هذا الفلتر الأحداث الخاصة باسم الحدث الفردي هذا. يجب إدخال اسم الحدث.

object (FunnelParameterFilterExpression)

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

داخل تعبير فلتر المعلَمات، لا تتوفّر سوى فلاتر للمعلَمات.

{

  // 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.
}

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpression)

قيمة FunnelParameterFilterExpression ليست من notExpression.

object (FunnelParameterFilter)

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

{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}

object (FunnelParameterFilterExpression)

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

{

  // 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.
}

string

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

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

string

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

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

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

object (StringFilter)

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

object (InListFilter)

عامل تصفية لقيم القائمة.

object (NumericFilter)

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

object (BetweenFilter)

عامل تصفية بين قيمتين.

{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}

object (Dimension)

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

string (int64 format)

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

{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}

string

اسم السمة. اطّلِع على سمات واجهة برمجة التطبيقات للحصول على قائمة بأسماء السمات المتوافقة مع طرق إعداد التقارير الأساسية مثل runReport وbatchRunReports. اطّلِع على السمات في الوقت الفعلي للحصول على قائمة بأسماء السمات التي تتيحها طريقة runRealtimeReport. اطّلِع على سمات مسار الإحالة الناجحة للحصول على قائمة بأسماء السمات التي تتيحها طريقة runFunnelReport.

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

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

object (DimensionExpression)

يمكن أن تكون سمة واحدة نتيجة تعبير سمات متعددة. على سبيل المثال، البُعد "البلد، المدينة": concatenate(country, ", ", city).

{

  // 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.
}

object (CaseExpression)

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

object (CaseExpression)

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

object (ConcatenateExpression)

تُستخدَم هذه الوظيفة لدمج قيم السمات في سمة واحدة. على سبيل المثال، البُعد "البلد، المدينة": concatenate(country, ", ", city).

{
  "dimensionName": string
}

string

اسم السمة يجب أن يشير الاسم إلى اسم في حقل "السمات" بالطلب.

{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}

string

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

string

المحدِّد الموضوع بين أسماء السمات.

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

{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}

object (Dimension)

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

لا يتوافق nextActionDimension حاليًا إلا مع eventName ومعظم أبعاد الصفحة / الشاشة مثل pageTitle وpagePath. لا يمكن أن تكون السمة nextActionDimension تعبير سمة.

string (int64 format)

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

{
  "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.
}

string

اسم هذه الشريحة. في حال عدم تحديد نوع القسم، يُطلق على الشرائح اسم "القسم". يحدِّد هذا الاسم قيمة السلسلة التي تعرضها السمة segment. تُقسِّم بادئات السمة segment الأسماء حسب رقم الفهرس المستند إلى 1 للشريحة في الطلب (على سبيل المثال "1. القسم"، "2. القسم"، وما إلى ذلك).

object (UserSegment)

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

object (SessionSegment)

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

object (EventSegment)

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

{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}

object (UserSegmentConditionGroup)

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

object (UserSegmentSequenceGroup)

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

{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (UserCriteriaScoping)

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

اختياريّ. وفي حال عدم تحديدها، يتم استخدام السمة conditionScoping = ACROSS_ALL_SESSIONS.

object (SegmentFilterExpression)

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

{

  // 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.
}

object (SegmentFilterExpressionList)

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

object (SegmentFilterExpressionList)

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

object (SegmentFilterExpression)

العنصر segmentFilterExpression ليس من notExpression.

object (SegmentFilter)

فلتر شريحة أولية.

object (SegmentEventFilter)

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

{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}

object (SegmentFilterExpression)

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

{
  "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.
}

string

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

object (SegmentFilterScoping)

لتحديد نطاق الفلتر.

object (StringFilter)

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

object (InListFilter)

عامل تصفية لقيم القائمة.

object (NumericFilter)

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

object (BetweenFilter)

عامل تصفية بين قيمتين.

{
  "atAnyPointInTime": boolean
}

boolean

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

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

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

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

{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}

string

يطابق هذا الفلتر الأحداث الخاصة باسم الحدث الفردي هذا. يجب إدخال اسم الحدث.

object (SegmentParameterFilterExpression)

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

داخل تعبير فلتر المعلَمات، لا تتوفّر سوى فلاتر للمعلَمات.

{

  // 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.
}

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpression)

قيمة segmentParameterFilterExpression ليست من notExpression.

object (SegmentParameterFilter)

فلتر لمَعلمة شريحة أساسية.

{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}

object (SegmentParameterFilterExpression)

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

{
  "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.
}

object (SegmentParameterFilterScoping)

لتحديد نطاق الفلتر.

string

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

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

string

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

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

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

object (StringFilter)

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

object (InListFilter)

عامل تصفية لقيم القائمة.

object (NumericFilter)

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

object (BetweenFilter)

عامل تصفية بين قيمتين.

{
  "inAnyNDayPeriod": string
}

string (int64 format)

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

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

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

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

{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}

enum (UserCriteriaScoping)

ويجب استيفاء جميع خطوات التسلسل في تحديد نطاق مطابقة المستخدم للتسلسل. على سبيل المثال، إذا كانت السمة sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION، يجب إكمال جميع خطوات التسلسل خلال جلسة واحدة لكي يطابق المستخدم التسلسل. "sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT" غير متاح

اختياريّ. وفي حال عدم تحديدها، يتم استخدام السمة conditionScoping = ACROSS_ALL_SESSIONS.

string (Duration format)

تُحدِّد الفترة الزمنية التي يجب أن يحدث فيها التسلسل بالكامل، على سبيل المثال، 30 دقيقة. يشمل sequenceMaximumDuration نقطة النهاية بدقة ميكرو ثانية. على سبيل المثال، يمكن إكمال تسلسل بحدّ أقصى 5 ثوانٍ عند 4.9 أو 5.0 ثوانٍ، ولكن ليس 5 ثوانٍ و1 ميكرو ثانية.

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

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

object (UserSequenceStep)

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

{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

boolean

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

enum (UserCriteriaScoping)

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

اختياريّ. في حال عدم تحديد نوع السمة، تستخدم السمة stepScoping السمة UserCriteriaScoping نفسها المُستخدَمة في sequenceScoping.

object (SegmentFilterExpression)

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

{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}

enum (UserExclusionDuration)

تُحدِّد مدة استمرار الاستبعاد إذا تطابق مستخدم مع userExclusionCriteria.

اختياريّ. وفي حال عدم تحديد قيمة، سيتم استخدام السمة userExclusionDuration من إجمالي USER_EXCLUSION_TEMPORARY.

object (UserSegmentCriteria)

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

{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}

object (SessionSegmentCriteria)

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

object (SessionSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}

object (SessionSegmentConditionGroup)

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

{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (SessionCriteriaScoping)

يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع مجموعة الشروط. يحدِّد هذا النطاق عدد الأحداث التي يتم تقييم segmentFilterExpression عليها قبل تحديد أن مجموعة الشروط متطابقة أو لا. على سبيل المثال، إذا كان conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION، يتم تقييم التعبير في جميع الأحداث في الجلسة، وبعد ذلك، يتم تحديد مجموعة الشروط على أنّها مطابقة أو لا تتطابق مع هذه الجلسة. على سبيل المثال، إذا كان conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT، يتم تقييم التعبير على حدث واحد، وبعد ذلك، يتم تحديد مجموعة الشروط على أنّها مطابقة أو لا تتطابق مع هذه الجلسة.

اختياريّ. وفي حال عدم تحديدها، يتم استخدام conditionScoping من WITHIN_SAME_SESSION.

object (SegmentFilterExpression)

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

{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}

enum (SessionExclusionDuration)

تُحدِّد مدة استمرار الاستبعاد إذا تطابقت جلسة مع sessionExclusionCriteria.

اختياريّ. وفي حال عدم تحديدها، يتم استخدام sessionExclusionDuration من SESSION_EXCLUSION_TEMPORARY.

object (SessionSegmentCriteria)

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

{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}

object (EventSegmentCriteria)

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

object (EventSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}

object (EventSegmentConditionGroup)

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

{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (EventCriteriaScoping)

يجب أن تكون السمة conditionScoping دائمًا EVENT_CRITERIA_WITHIN_SAME_EVENT.

اختياريّ. وفي حال عدم تحديدها، يتم استخدام conditionScoping من EVENT_CRITERIA_WITHIN_SAME_EVENT.

object (SegmentFilterExpression)

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

{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}

enum (EventExclusionDuration)

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

اختياريّ. وفي حال عدم تحديدها، يتم استخدام eventExclusionDuration من EVENT_EXCLUSION_PERMANENT.

object (EventSegmentCriteria)

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

{

  // 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.
}

object (FilterExpressionList)

هناك علاقة "و" لـ "FilterExpressions" في andGroup.

object (FilterExpressionList)

لـ FilterExpressions في orGroup علاقة OR.

object (FilterExpression)

لا يعتبر FilterExpression ليس من notExpression.

object (Filter)

عامل تصفية أساسي. في FilterExpression نفسها، يجب أن تكون جميع أسماء حقول الفلتر إما كل السمات أو جميع المقاييس.

{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}

object (FilterExpression)

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

{
  "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.
}

string

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

object (StringFilter)

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

object (InListFilter)

عامل تصفية لقيم القائمة.

object (NumericFilter)

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

object (BetweenFilter)

عامل تصفية بين قيمتين.

{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}

object (DimensionHeader)

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

object (MetricHeader)

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

object (Row)

صفوف مجموعات قيم السمات وقيم المقاييس في التقرير

object (FunnelResponseMetadata)

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

{
  "name": string
}

string

اسم السمة.

{
  "name": string,
  "type": enum (MetricType)
}

string

اسم المقياس

enum (MetricType)

تمثّل هذه السمة نوع بيانات المقياس.

{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}

object (DimensionValue)

قائمة قيم السمات المطلوبة في تقرير PivotReport، لا يتم سرد قيم السمات إلا للسمات المضمنة في المحور المحوري.

object (MetricValue)

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

{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}

string

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

{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}

string

قيمة القياس. يُرجى الاطّلاع على MetricHeader لمعرفة النوع.

{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}

object (SamplingMetadata)

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

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

{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}

string (int64 format)

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

string (int64 format)

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

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

{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

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

{
  "consumed": integer,
  "remaining": integer
}

integer

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

integer

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