- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- مسار الإحالة الناجحة
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- القسم
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- جرِّبه الآن
تعرِض تقرير مسار إحالة ناجحة مخصّصًا لبيانات الأحداث في "إحصاءات Google". يتم عرض البيانات من واجهة برمجة التطبيقات كجدول يحتوي على أعمدة للسمات والمقاييس المطلوبة.
يتيح لك استكشاف خطوات المستخدمين إمكانية الاطّلاع على تمثيل بصري للخطوات التي يتّخذها المستخدمون لإكمال مهمة وبالتالي التعرُّف بشكل سريع على مدى نجاحهم أو فشلهم في كل خطوة. مثلاً، كيف يتحوّل العملاء المحتملون إلى متسوّقين ثم مشترين؟ كيف يتحوّل المشترون لمرة واحدة إلى مشترين يكرّرون عملية الشراء؟ باستخدام هذه المعلومات، يمكنك تحسين رحلات العملاء غير الفعّالة أو التي تم التخلي عنها. لمزيد من المعلومات، اطّلِع على مقالة استكشاف مسارات الإحالات الناجحة في "إحصاءات Google 4".
تم طرح هذه الطريقة في إصدار أوليّ مستقر بهدف جمع ملاحظات وآراء حول البنية والإمكانات قبل الدخول في إصدار تجريبي. لتقديم ملاحظاتك حول واجهة برمجة التطبيقات هذه، يُرجى إكمال الملاحظات والآراء بشأن إعداد تقارير مسار الإحالة الناجحة في Google Analytics Data API.
طلب HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
property |
اختياريّ. معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. يتم تحديده في مسار عنوان URL وليس في النص الأساسي لمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. ضمن الطلب المجمّع، يجب أن تكون هذه السمة غير محدّدة أو متوافقة مع الموقع على مستوى الدفعة. مثال: المواقع الإلكترونية/1234 |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dateRanges": [ { object ( |
الحقول | |
---|---|
dateRanges[] |
اختياريّ. النطاقات الزمنية للبيانات المطلوب قراءتها في حال طلب نطاقات زمنية متعددة، سيحتوي كل صف استجابة على فهرس نطاق زمني يستند إلى صفر. وفي حال تداخل نطاقَين زمنيَين، يتم تضمين بيانات الأحداث للأيام المتداخلة في صفوف الردود لكلا النطاقَين الزمنيَين. |
funnel |
اختياريّ. إعدادات مسار الإحالة الناجحة لهذا الطلب. يجب ضبط إعدادات مسار الإحالة الناجحة هذه. |
funnelBreakdown |
اختياريّ. وفي حال تحديد هذه التفاصيل، تضيف هذه التفاصيل سمة إلى استجابة التقرير الفرعي لجدول مسار الإحالة الناجحة. توسّع سمة التقسيم هذه كل خطوة في مسار الإحالة الناجحة إلى القيم الفريدة لسمة التصنيف التفصيلي. على سبيل المثال، سيؤدي التقسيم حسب السمة |
funnelNextAction |
اختياريّ. في حال تحديد الإجراء، يضيف الإجراء التالي سمة إلى استجابة التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة. يعمل سمة الإجراء التالي على توسيع كل خطوة في مسار الإحالة الناجحة إلى القيم الفريدة للإجراء التالي. على سبيل المثال، سيؤدي الإجراء التالي للسمة يتوافق الإجراء التالي فقط مع |
funnelVisualizationType |
اختياريّ. يتحكّم نوع التمثيل البصري لمسار الإحالة الناجحة في السمات المتوفّرة في ردّ التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة. إذا لم يتم تحديد قيمة، سيتم استخدام السمة |
segments[] |
اختياريّ. تكوينات الشرائح. الشرائح هي مجموعات فرعية من بيانات الموقع. في تقرير مسار الإحالة الناجحة الذي يتضمّن شرائح، يتم تقييم مسار الإحالة الناجحة في كل شريحة. ينتج عن كل مقطع محدد في هذا الطلب صف منفصل في الاستجابة؛ في الإجابة، يتم تحديد كل قسم باسمه. مَعلمة الشرائح اختيارية. تقتصر الطلبات على 4 أقسام. |
limit |
اختياريّ. عدد الصفوف المطلوب عرضها. في حال عدم تحديد قيمة الحقل، سيتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 250,000 صف كحدٍ أقصى لكل طلب، بغض النظر عن عدد الصفوف التي تطلبها. يجب أن تكون قيمة ويمكن أن تعرض واجهة برمجة التطبيقات أيضًا صفوفًا أقل من قيمة |
dimensionFilter |
اختياريّ. تسمح لك فلاتر السمات بطلب قيم سمات معيّنة فقط في التقرير. ولمزيد من المعلومات، يُرجى الاطّلاع على إنشاء تقرير: فلاتر السمات للحصول على أمثلة. لا يمكن استخدام المقاييس في هذا الفلتر. |
returnPropertyQuota |
اختياريّ. تبديل ما إذا كان سيتم عرض الحالة الحالية لحصة هذا الموقع على "إحصاءات Google". يتم عرض الحصة في PropertyQuota. |
نص الاستجابة
تتضمّن استجابة تقرير مسار الإحالة الناجحة تقريرَين فرعيَين. إنّ التقريرَين الفرعيَين هما مزيجان مختلفان من السمات والمقاييس.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "funnelTable": { object ( |
الحقول | |
---|---|
funnelTable |
جدول مسار الإحالة الناجحة هو تقرير يتضمّن الخطوة في مسار الإحالة الناجحة والشريحة وسمة التقسيم والمستخدمين النشطين ومعدّل الإكمال ومعدّل العزوف ومعدّل العزوف. لا تتوفّر سمة الشريحة في هذه الاستجابة إلا في حال طلب شريحة. لا تتوفّر سمة التقسيم في هذه الاستجابة إلا إذا تم طلبها. |
funnelVisualization |
التمثيل البصري لمسار الإحالة الناجحة هو تقرير يتضمّن الخطوة في مسار الإحالة الناجحة والشريحة والتاريخ وسمة الإجراء التالي والمستخدمين النشطين. لا تتوفّر سمة الشريحة في هذه الاستجابة إلا في حال طلب شريحة. لا تتوفّر سمة التاريخ في هذه الاستجابة إلا إذا تم طلبها من خلال نوع مسار الإحالة الناجحة " |
propertyQuota |
حالة حصة هذا الموقع على "إحصاءات Google" بما في ذلك هذا الطلب. |
kind |
يحدد نوع المورد الذي ينتمي إليه هذه الرسالة. تكون قيمة |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
مسار الإحالة الناجحة
تضبط هذه السياسة مسار الإحالة الناجحة في طلب تقرير مسار الإحالة الناجحة. يقدِّم مسار الإحالة الناجحة تقارير عن المستخدِمين أثناء مرورهم بسلسلة من الخطوات.
يتيح لك استكشاف خطوات المستخدمين إمكانية الاطّلاع على تمثيل بصري للخطوات التي يتّخذها المستخدمون لإكمال مهمة وبالتالي التعرُّف بشكل سريع على مدى نجاحهم أو فشلهم في كل خطوة. مثلاً، كيف يتحوّل العملاء المحتملون إلى متسوّقين ثم مشترين؟ كيف يتحوّل المشترون لمرة واحدة إلى مشترين يكرّرون عملية الشراء؟ باستخدام هذه المعلومات، يمكنك تحسين رحلات العملاء غير الفعّالة أو التي تم التخلي عنها.
تمثيل JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
الحقول | |
---|---|
isOpenFunnel |
في مسار الإحالة الناجحة المفتوح، يمكن للمستخدمين الدخول إلى المسار في أي خطوة، وفي مسار الإحالة الناجحة المغلق، على المستخدمين الدخول إلى المسار في الخطوة الأولى. اختياريّ. وفي حال عدم تحديد قيمة هذه السمة، يتم استخدام مسار إحالة ناجحة مغلق. |
steps[] |
الخطوات المتسلسلة لمسار الإحالة الناجحة هذا |
FunnelStep
تحدِّد الخطوات تجربة المستخدِم التي تريد قياسها. تحتوي الخطوات على شرط واحد أو أكثر يجب أن يستوفيه المستخدمون ليتم تضمينهم في تلك الخطوة من رحلة مسار الإحالة الناجحة.
تمثيل JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
الحقول | |
---|---|
name |
الاسم المميز لهذه الخطوة. وفي حال عدم تحديد هذه الخطوات، ستتم تسمية الخطوات باسم مفهرَس واحد (على سبيل المثال "0. "، "1. "، وما إلى ذلك). يحدّد هذا الاسم قيمة السلسلة التي تعرضها السمة |
isDirectlyFollowedBy |
إذا كانت القيمة هي true، يجب أن تتبع هذه الخطوة الخطوة السابقة مباشرةً. وإذا كانت القيمة false، قد تكون هناك أحداث بين الخطوة السابقة وهذه الخطوة. وفي حال عدم تحديد هذه القيمة، يتم التعامل مع السمة |
filterExpression |
الشرط الذي يجب أن يستوفيه المستخدمون ليتم تضمينه في هذه الخطوة من رحلة مسار الإحالة الناجحة. |
withinDurationFromPriorStep |
في حال تحديد هذه الخطوة، يجب إكمالها خلال مدة إكمال الخطوة السابقة. وتشمل إنّ مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
FunnelFilterExpression
تعبّر عن مجموعات فلاتر مسار الإحالة الناجحة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد expr . حدِّد نوع فلتر واحدًا لـ FunnelFilterExpression . يمكن أن يكون expr واحدًا فقط مما يلي: |
|
andGroup |
علاقة FunnelFilter Expression في |
orGroup |
ترتبط علاقة FunnelFilterExpression في |
notExpression |
ليس FunnelFilterExpression ليس بقيمة |
funnelFieldFilter |
فلتر مسار الإحالة الناجحة لسمة أو مقياس معيّن |
funnelEventFilter |
ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا. |
FunnelFilterExpressionList
قائمة بتعبيرات فلاتر مسارات الإحالات الناجحة
تمثيل JSON |
---|
{
"expressions": [
{
object ( |
الحقول | |
---|---|
expressions[] |
قائمة تعبيرات فلاتر مسار الإحالة الناجحة. |
FunnelFieldFilter
تعبير لفلترة قيم السمات أو المقاييس
تمثيل JSON |
---|
{ "fieldName": string, // Union field |
الحقول | |
---|---|
fieldName |
اسم السمة أو اسم المقياس. |
حقل الاتحاد one_filter . حدِّد نوعًا واحدًا من الفلاتر. يمكن أن يكون one_filter واحدًا فقط مما يلي: |
|
stringFilter |
الفلتر المرتبط بالسلاسل |
inListFilter |
فلتر لقيم القائمة. |
numericFilter |
فلتر للقيم الرقمية أو قيم التاريخ. |
betweenFilter |
عامل تصفية للقيم بين قيمتين. |
FunnelEventFilter
ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا.
تمثيل JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
الحقول | |
---|---|
eventName |
يطابق هذا الفلتر الأحداث لاسم الحدث الفردي هذا. يجب إدخال اسم الحدث. |
funnelParameterFilterExpression |
في حال تحديد هذا الفلتر، يتطابق مع الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلاتر المَعلمات. داخل تعبير فلتر المَعلمات، تتوفّر فلاتر المَعلمات فقط. |
FunnelParameterFilterExpression
تعبّر عن مجموعات فلاتر مسار الإحالة الناجحة استنادًا إلى المَعلمات.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد expr . حدِّد نوع فلتر واحدًا لـ FunnelParameterFilterExpression . يمكن أن يكون expr واحدًا فقط مما يلي: |
|
andGroup |
ترتبط علاقة FunnelparamFilterExpression في |
orGroup |
ترتبط علاقة FunnelparamFilterExpression في |
notExpression |
ليس FunnelparamFilterExpression ليس قيمة |
funnelParameterFilter |
فلتر مَعلمات مسار الإحالة الناجحة الأساسي |
FunnelParameterFilterExpressionList
قائمة بتعبيرات فلاتر مَعلمات مسار الإحالة الناجحة
تمثيل JSON |
---|
{
"expressions": [
{
object ( |
الحقول | |
---|---|
expressions[] |
قائمة تعبيرات فلاتر مَعلمات مسار الإحالة الناجحة |
FunnelParameterFilter
تعبير لفلترة قيم المَعلمات في مسار إحالة ناجحة
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد one_parameter . الحقل الذي تتم تصفيته. يمكن أن يكون one_parameter واحدًا فقط مما يلي: |
|
eventParameterName |
سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة الحدث المحدّدة. يتم تسجيل مَعلمات الحدث كمَعلمات للحدث. تتضمّن مَعلمات الأحداث حقولاً مثلfirebase_screen و "العملة". لا يمكن استخدام مَعلمات الأحداث إلّا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter. |
itemParameterName |
سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة السلعة المحدّدة. يتم تسجيل مَعلمات السلع كمَعلمات في مصفوفة السلع. تتضمّن مَعلمات العناصر حقولاً مثل "item_name" و "item_category". لا يمكن استخدام مَعلمات العناصر إلا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter. لا تتوفّر مَعلمات السلع إلا في أحداث التجارة الإلكترونية. للمزيد من المعلومات عن أحداث التجارة الإلكترونية، اطّلِع على دليل قياس التجارة الإلكترونية. |
حقل الاتحاد one_filter . حدِّد نوعًا واحدًا من الفلاتر. يمكن أن يكون one_filter واحدًا فقط مما يلي: |
|
stringFilter |
الفلتر المرتبط بالسلاسل |
inListFilter |
فلتر لقيم القائمة. |
numericFilter |
فلتر للقيم الرقمية أو قيم التاريخ. |
betweenFilter |
عامل تصفية للقيم بين قيمتين. |
FunnelBreakdown
تضيف التصنيفات التفصيلية سمة إلى ردّ التقرير الفرعي لجدول مسار الإحالة الناجحة.
تمثيل JSON |
---|
{
"breakdownDimension": {
object ( |
الحقول | |
---|---|
breakdownDimension |
عمود السمات الذي تمّت إضافته إلى ردّ التقرير الفرعي لجدول مسار الإحالة الناجحة. وتقسّم سمة التقسيم كل خطوة في مسار الإحالة الناجحة. يجب إدخال قيمة |
limit |
الحد الأقصى لعدد القيم المختلفة لسمة التصنيف التفصيلي المطلوب عرضها في الردّ. يتم استخدام |
FunnelNextAction
تحدّد الإجراءات التالية قيمة البُعد بعد أن يكمل المستخدم خطوة ما ولكن قبل أن يحقق المستخدم نفسه الخطوة التالية. على سبيل المثال، إذا كانت قيمة nextActionDimension
هي eventName
، ستعرِض السمة nextActionDimension
في صف الخطوة i
في مسار الإحالة الناجحة الحدث الأول بعد الحدث الذي أدّى إلى تأهيل المستخدِم للخطوة رقم i
ولكن قبل تحقيق المستخدِم للخطوة i+1
في مسار الإحالة الناجحة.
تمثيل JSON |
---|
{
"nextActionDimension": {
object ( |
الحقول | |
---|---|
nextActionDimension |
عمود السمة الذي تمّت إضافته إلى ردّ التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة. تعرِض سمة الإجراء التالي قيمة السمة التالية لهذه السمة بعد أن يصل المستخدِم إلى الخطوة يتوافق تطبيق " |
limit |
الحد الأقصى لعدد القيم المختلفة لسمة التصنيف التفصيلي المطلوب عرضها في الردّ. يتم استخدام |
FunnelVisualizationType
تتحكّم هذه السياسة في السمات المتوفّرة في ردّ التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة.
عمليات التعداد | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
نوع غير محدَّد. |
STANDARD_FUNNEL |
مسار إحالة ناجحة عادي (متقدّم). لن يحتوي التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة في الردّ على التاريخ. |
TRENDED_FUNNEL |
مسار الإحالة الناجحة بشكل رسم بياني خطي. سيتضمّن التقرير الفرعي للتمثيل البصري لمسار الإحالة الناجحة في الردّ سمة التاريخ. |
تقسيم
الشريحة هي مجموعة فرعية من بيانات "إحصاءات Google". على سبيل المثال، من بين المجموعة الكاملة من مستخدِمي موقعك، قد تتألف إحدى الشرائح من المستخدِمين من بلد معيّن أو مدينة معيّنة. ويمكن أن تتألف شريحة أخرى من المستخدِمين الذين يشترون خط منتجات معيّنًا أو يزورون جزءًا محددًا من موقعك أو يشغّلون أحداثًا معيّنة في تطبيقك.
لمزيد من المعلومات، اطّلِع على أداة إنشاء الشرائح في "إحصاءات Google 4".
تمثيل JSON |
---|
{ "name": string, // Union field |
الحقول | |
---|---|
name |
اسم هذه الشريحة. وفي حال عدم تحديد ذلك، يُطلق على الشرائح اسم "شريحة". يحدّد هذا الاسم قيمة السلسلة التي تعرضها السمة |
حقل الاتحاد one_segment_scope . تم تحديد الشريحة في نطاق واحد. يمكن أن يكون one_segment_scope واحدًا فقط مما يلي: |
|
userSegment |
شرائح المستخدِمين هي مجموعات فرعية من المستخدِمين الذين تفاعلوا مع موقعك الإلكتروني أو تطبيقك. |
sessionSegment |
شرائح الجلسات هي مجموعات فرعية من الجلسات التي حدثت على موقعك الإلكتروني أو تطبيقك. |
eventSegment |
شرائح الأحداث هي مجموعات فرعية من الأحداث التي تم تشغيلها على موقعك الإلكتروني أو تطبيقك. |
UserSegment
شرائح المستخدِمين هي مجموعات فرعية من المستخدِمين الذين تفاعلوا مع موقعك الإلكتروني أو تطبيقك. على سبيل المثال، المستخدمون الذين سبق لهم الشراء. المستخدمين الذين أضافوا سلعًا إلى سلات التسوق، لكن لم يكملوا عملية الشراء.
تمثيل JSON |
---|
{ "userInclusionCriteria": { object ( |
الحقول | |
---|---|
userInclusionCriteria |
تُحدِّد المستخدِمين الذين يتم تضمينهم في هذه الشريحة. اختياريّ. |
exclusion |
تحدِّد المستخدِمين المستبعَدين في هذه الشريحة. اختياريّ. |
UserSegmentCriteria
يطابق المستخدِم أحد المعايير إذا كانت أحداثه تستوفي الشروط الواردة في المعايير.
تمثيل JSON |
---|
{ "andConditionGroups": [ { object ( |
الحقول | |
---|---|
andConditionGroups[] |
ويتطابق المستخدم مع هذه المعايير إذا طابقَ المستخدم كلّاً من |
andSequenceGroups[] |
ويتطابق المستخدم مع هذه المعايير إذا طابقَ هذا المستخدم كلاً من |
UserSegmentConditionGroup
تخبر الشروط "إحصاءات Google" بالبيانات التي يجب تضمينها في الشريحة أو استبعادها منها.
تمثيل JSON |
---|
{ "conditionScoping": enum ( |
الحقول | |
---|---|
conditionScoping |
يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع مجموعة الشروط. يحدِّد هذا النطاق عدد الأحداث التي يتم تقييم اختياريّ. وفي حال عدم تحديد قيمة هذه السمة، يتم استخدام السمة |
segmentFilterExpression |
يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات. |
UserCriteriaScoping
يحدِّد النطاق الأحداث التي يتم وضعها في الاعتبار عند تقييم ما إذا كان المستخدِم يستوفي إحدى المعايير.
عمليات التعداد | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
تحديد نطاق معايير غير محدّدة يُرجى عدم التحديد. |
USER_CRITERIA_WITHIN_SAME_EVENT |
في حال استيفاء المعايير ضمن حدث واحد، يتطابق المستخدم مع المعايير. |
USER_CRITERIA_WITHIN_SAME_SESSION |
في حال استيفاء المعايير خلال جلسة واحدة، يتطابق المستخدم مع المعايير. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
إذا استوفى المستخدم المعايير بواسطة أي أحداث للمستخدم، يطابق المستخدم المعايير. |
SegmentFilterExpression
تعبّر عن مجموعات فلاتر الشرائح.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد expr . حدِّد نوع فلتر واحدًا لـ SegmentFilterExpression . يمكن أن يكون expr واحدًا فقط مما يلي: |
|
andGroup |
علاقة SegmentFilter Expression في الدالة |
orGroup |
علاقة SegmentFilterExpression في الدالة |
notExpression |
سمة SegmentFilterExpression ليست من |
segmentFilter |
فلتر قسم أساسي. |
segmentEventFilter |
ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا. |
SegmentFilterExpressionList
قائمة بتعبيرات فلاتر الشرائح.
تمثيل JSON |
---|
{
"expressions": [
{
object ( |
الحقول | |
---|---|
expressions[] |
قائمة تعبيرات فلاتر الشرائح |
SegmentFilter
تعبير لفلترة قيم السمات أو المقاييس
تمثيل JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
الحقول | |
---|---|
fieldName |
اسم السمة أو اسم المقياس. |
filterScoping |
تُحدِّد نطاق الفلتر. |
حقل الاتحاد one_filter . حدِّد نوع فلتر واحدًا لـ Filter . يمكن أن يكون one_filter واحدًا فقط مما يلي: |
|
stringFilter |
الفلتر المرتبط بالسلاسل |
inListFilter |
فلتر لقيم القائمة. |
numericFilter |
فلتر للقيم الرقمية أو قيم التاريخ. |
betweenFilter |
عامل تصفية للقيم بين قيمتين. |
SegmentFilterScoping
تحدد النطاقات كيفية توافق الأبعاد يجب مراعاة مقاييس الأحداث المتعددة عند تقييم فلتر شرائح.
تمثيل JSON |
---|
{ "atAnyPointInTime": boolean } |
الحقول | |
---|---|
atAnyPointInTime |
إذا كانت لا تعمل مَعلمة لا يمكن تحديد إذا كان نطاق المعايير هو |
SegmentEventFilter
ينشئ فلترًا يطابق الأحداث لاسم حدث واحد. في حال تحديد تعبير فلتر مَعلمات، تتطابق فقط مجموعة فرعية من الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا.
تمثيل JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
الحقول | |
---|---|
eventName |
يطابق هذا الفلتر الأحداث لاسم الحدث الفردي هذا. يجب إدخال اسم الحدث. |
segmentParameterFilterExpression |
في حال تحديد هذا الفلتر، يتطابق مع الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلاتر المَعلمات. داخل تعبير فلتر المَعلمات، تتوفّر فلاتر المَعلمات فقط. |
SegmentParameterFilterExpression
تعبّر عن مجموعات فلتر الشرائح على المَعلمات.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد expr . حدِّد نوع فلتر واحدًا لـ SegmentParameterFilterExpression . يمكن أن يكون expr واحدًا فقط مما يلي: |
|
andGroup |
علاقة SegmentElementFilterExpression في الدالة |
orGroup |
السمة SegmentElementFilterExpression في الدالة |
notExpression |
سمة SegmentمعلَمةFilterExpression ليست من |
segmentParameterFilter |
فلتر أساسي لمَعلمات الشريحة |
SegmentParameterFilterExpressionList
قائمة بتعبيرات فلاتر مَعلمات الشرائح
تمثيل JSON |
---|
{
"expressions": [
{
object ( |
الحقول | |
---|---|
expressions[] |
قائمة تعبيرات فلاتر مَعلمات الشرائح |
SegmentParameterFilter
تعبير لفلترة قيم المَعلمات في إحدى الشرائح
تمثيل JSON |
---|
{ "filterScoping": { object ( |
الحقول | |
---|---|
filterScoping |
تُحدِّد نطاق الفلتر. |
حقل الاتحاد one_parameter . الحقل الذي تتم تصفيته. يمكن أن يكون one_parameter واحدًا فقط مما يلي: |
|
eventParameterName |
سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة الحدث المحدّدة. يتم تسجيل مَعلمات الحدث كمَعلمات للحدث. تتضمّن مَعلمات الأحداث حقولاً مثلfirebase_screen و "العملة". لا يمكن استخدام مَعلمات الأحداث إلّا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter. |
itemParameterName |
سيتم تقييم هذا الفلتر استنادًا إلى مَعلمة السلعة المحدّدة. يتم تسجيل مَعلمات السلع كمَعلمات في مصفوفة السلع. تتضمّن مَعلمات العناصر حقولاً مثل "item_name" و "item_category". لا يمكن استخدام مَعلمات العناصر إلا في الشرائح مسارات الإحالة الناجحة ولا يمكن استخدامها إلا في فلتر تابع من EventFilter. يجب استخدام مَعلمة حدث أو عنصر في فلتر تابع من EventFilter. لا تتوفّر مَعلمات السلع إلا في أحداث التجارة الإلكترونية. للمزيد من المعلومات عن أحداث التجارة الإلكترونية، اطّلِع على دليل قياس التجارة الإلكترونية. |
حقل الاتحاد one_filter . حدِّد نوعًا واحدًا من الفلاتر. يمكن أن يكون one_filter واحدًا فقط مما يلي: |
|
stringFilter |
الفلتر المرتبط بالسلاسل |
inListFilter |
فلتر لقيم القائمة. |
numericFilter |
فلتر للقيم الرقمية أو قيم التاريخ. |
betweenFilter |
عامل تصفية للقيم بين قيمتين. |
SegmentParameterFilterScoping
تحدِّد النطاقات كيفية مراعاة الأحداث المتعددة عند تقييم فلتر مَعلمات الشريحة.
تمثيل JSON |
---|
{ "inAnyNDayPeriod": string } |
الحقول | |
---|---|
inAnyNDayPeriod |
تجمع المَعلمة خلال الفترة المحدّدة من الأيام قبل تطبيق الفلتر. لا تتوفَّر هذه الميزة إلّا إذا كان نطاق المعايير هو على سبيل المثال، إذا كانت قيمة لا يتم تمديد النطاق الزمني لغرض وجود فترة N يوم كاملة بالقرب من بداية النطاق الزمني. على سبيل المثال، إذا كان التقرير عن الفترة من 2021-11-01 إلى 2021-11-10 و وتكون السمة |
UserSegmentSequenceGroup
حدِّد الشروط التي يجب أن تحدث بترتيب معيّن ليصبح المستخدِم عضوًا في الشريحة.
تمثيل JSON |
---|
{ "sequenceScoping": enum ( |
الحقول | |
---|---|
sequenceScoping |
يجب استيفاء جميع خطوات التسلسل في النطاق لكي يطابق المستخدم التسلسل. على سبيل المثال، إذا كان اختياريّ. وفي حال عدم تحديد قيمة هذه السمة، يتم استخدام السمة |
sequenceMaximumDuration |
وتحدِّد الفترة الزمنية التي يجب أن يحدث فيها التسلسل بالكامل. على سبيل المثال، 30 دقيقة. وتشمل تكون السمة مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
userSequenceSteps[] |
تمثّل هذه السمة تسلسلًا مُرتبًا لخطوات الشرط. يجب أن تكمل أحداث المستخدم كل خطوة حتى يتطابق المستخدم مع |
UserSequenceStep
شرط يجب أن يحدث بترتيب الخطوات المحدّد حتى يتطابق هذا المستخدم مع التسلسل.
تمثيل JSON |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
الحقول | |
---|---|
isDirectlyFollowedBy |
إذا كانت القيمة هي true، يجب أن يكون الحدث الذي يستوفي هذه الخطوة هو الحدث التالي بعد وقوع الحدث في الخطوة الأخيرة. إذا كانت القيمة "خطأ"، فإنّ هذه الخطوة تتبع الخطوة السابقة بشكل غير مباشر. على سبيل المثال، قد تكون هناك أحداث بين الخطوة السابقة وهذه الخطوة. يجب أن يكون |
stepScoping |
يجب استيفاء هذه الخطوة في التسلسل من أجل مطابقة المستخدم للتسلسل. على سبيل المثال، إذا كانت اختياريّ. في حال عدم تحديد هذه السمة، يستخدم |
segmentFilterExpression |
يطابق أحد المستخدمين خطوة التسلسل هذه إذا تطابقت أحداثه مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات. |
UserSegmentExclusion
تُحدِّد المستخدِمين المستبعَدين في هذه الشريحة.
تمثيل JSON |
---|
{ "userExclusionDuration": enum ( |
الحقول | |
---|---|
userExclusionDuration |
تحدِّد هذه السياسة مدة استمرار الاستبعاد إذا تطابق مستخدم مع اختياريّ. في حال عدم تحديد قيمة، يتم استخدام |
userExclusionCriteria |
إذا استوفى مستخدم هذا الشرط، سيتم استبعاد المستخدم من العضوية في شريحة |
UserExclusionDuration
لسرد خيارات مدة الاستبعاد إذا تطابق مستخدم مع userExclusionCriteria
.
عمليات التعداد | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
مدة الاستبعاد غير محدّدة. يُرجى عدم التحديد. |
USER_EXCLUSION_TEMPORARY |
استبعاد المستخدِمين مؤقتًا من الشريحة خلال الفترات التي يستوفي فيها المستخدِم شرط userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
استبعاد المستخدِمين من الشريحة نهائيًا إذا استوفى المستخدِم شرط userExclusionCriteria في أي وقت. |
SessionSegment
شرائح الجلسات هي مجموعات فرعية من الجلسات التي حدثت على موقعك الإلكتروني أو تطبيقك: على سبيل المثال، جميع الجلسات التي نشأت من حملة إعلانية معيّنة.
تمثيل JSON |
---|
{ "sessionInclusionCriteria": { object ( |
الحقول | |
---|---|
sessionInclusionCriteria |
تحدد الجلسات المضمّنة في هذه الشريحة. اختياريّ. |
exclusion |
تحدد الجلسات المستبعدة في هذه الشريحة. اختياريّ. |
SessionSegmentCriteria
تتطابق الجلسة مع أحد المعايير إذا كانت أحداث الجلسة تستوفي الشروط الواردة في المعايير.
تمثيل JSON |
---|
{
"andConditionGroups": [
{
object ( |
الحقول | |
---|---|
andConditionGroups[] |
تتطابق الجلسة مع هذا المعيار إذا تطابقت الجلسة مع كلّ من |
SessionSegmentConditionGroup
تخبر الشروط "إحصاءات Google" بالبيانات التي يجب تضمينها في الشريحة أو استبعادها منها.
تمثيل JSON |
---|
{ "conditionScoping": enum ( |
الحقول | |
---|---|
conditionScoping |
يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع مجموعة الشروط. يحدِّد هذا النطاق عدد الأحداث التي يتم تقييم اختياريّ. في حال عدم تحديد قيمة، يتم استخدام |
segmentFilterExpression |
يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات. |
SessionCriteriaScoping
يحدِّد النطاق الأحداث التي يتم وضعها في الاعتبار عند تقييم ما إذا كانت الجلسة تستوفي أحد المعايير.
عمليات التعداد | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
تحديد نطاق معايير غير محدّدة يُرجى عدم التحديد. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
وإذا تم استيفاء المعايير ضمن حدث واحد، ستتطابق الجلسة مع المعايير. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
إذا تم استيفاء المعايير خلال جلسة واحدة، تتطابق الجلسة مع المعايير. |
SessionSegmentExclusion
تُحدِّد الجلسات التي يتم استبعادها في هذه الشريحة.
تمثيل JSON |
---|
{ "sessionExclusionDuration": enum ( |
الحقول | |
---|---|
sessionExclusionDuration |
تحدِّد هذه السياسة مدة استمرار الاستبعاد إذا تطابقت إحدى الجلسات مع اختياريّ. في حال عدم تحديد قيمة، يتم استخدام |
sessionExclusionCriteria |
وإذا استوفت جلسة هذا الشرط، يتم استبعاد الجلسة من العضوية في شريحة |
SessionExclusionDuration
لسرد خيارات مدة الاستبعاد إذا كانت الجلسة تطابق sessionExclusionCriteria
.
عمليات التعداد | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
مدة الاستبعاد غير محدّدة. يُرجى عدم التحديد. |
SESSION_EXCLUSION_TEMPORARY |
استبعاد الجلسات مؤقتًا من الشريحة خلال الفترات التي تستوفي فيها الجلسة شرط sessionExclusionCriteria |
SESSION_EXCLUSION_PERMANENT |
استبعاد الجلسات نهائيًا من الشريحة إذا استوفت الجلسة شرط sessionExclusionCriteria في أي وقت. |
EventSegment
شرائح الأحداث هي مجموعات فرعية من الأحداث التي تم تشغيلها على موقعك الإلكتروني أو تطبيقك. على سبيل المثال، جميع أحداث الشراء التي تمّت في موقع جغرافي معيّن أحداث app_exception التي حدثت على نظام تشغيل محدَّد.
تمثيل JSON |
---|
{ "eventInclusionCriteria": { object ( |
الحقول | |
---|---|
eventInclusionCriteria |
تحدد الأحداث التي يتم تضمينها في هذه الشريحة. اختياريّ. |
exclusion |
تحدِّد الأحداث المستثناة في هذه الشريحة. اختياريّ. |
EventSegmentCriteria
يتطابق الحدث مع أحد المعايير إذا كان الحدث يستوفي الشروط المحدّدة.
تمثيل JSON |
---|
{
"andConditionGroups": [
{
object ( |
الحقول | |
---|---|
andConditionGroups[] |
يتطابق حدث مع هذه المعايير إذا كان الحدث يتطابق مع كلٍ من |
EventSegmentConditionGroup
تخبر الشروط "إحصاءات Google" بالبيانات التي يجب تضمينها في الشريحة أو استبعادها منها.
تمثيل JSON |
---|
{ "conditionScoping": enum ( |
الحقول | |
---|---|
conditionScoping |
يجب أن تكون القيمة اختياريّ. في حال عدم تحديد قيمة، يتم استخدام |
segmentFilterExpression |
يتم تضمين البيانات أو استبعادها من الشريحة استنادًا إلى ما إذا كانت تتطابق مع هذا التعبير. تعبر التعبيرات عن المعايير المتعلقة بالبُعد و/أو المقاييس و/أو المعلمات. |
EventCriteriaScoping
يحدِّد النطاق الأحداث التي يتمّ وضعها في الاعتبار عند تقييم ما إذا كان الحدث يستوفي أحد المعايير.
عمليات التعداد | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
تحديد نطاق معايير غير محدّدة يُرجى عدم التحديد. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
فإذا تم استيفاء المعايير داخل حدث واحد، فإن الحدث يطابق المعايير. |
EventSegmentExclusion
لتحديد الأحداث التي يتم استثناؤها في هذه الشريحة.
تمثيل JSON |
---|
{ "eventExclusionDuration": enum ( |
الحقول | |
---|---|
eventExclusionDuration |
يجب أن تكون قيمة اختياريّ. في حال عدم تحديد قيمة، يتم استخدام |
eventExclusionCriteria |
إذا استوفى حدث هذا الشرط، سيتم استبعاد الحدث من العضوية في شريحة " |
EventExclusionDuration
لتعداد الخيارات لمدة الاستثناء إذا كان حدث تطابق eventExclusionCriteria
.
عمليات التعداد | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
مدة الاستبعاد غير محدّدة. يُرجى عدم التحديد. |
EVENT_EXCLUSION_PERMANENT |
استبعاد الأحداث نهائيًا من الشريحة إذا استوفى الحدث شرط eventExclusionCriteria في أي وقت. |
FunnelSubReport
تتضمّن تقارير مسارات الإحالات الناجحة الفرعية قيم بيانات السمات والمقاييس. على سبيل المثال، وصل 12 مستخدمًا إلى الخطوة الثانية من مسار الإحالة الناجحة.
تمثيل JSON |
---|
{ "dimensionHeaders": [ { object ( |
الحقول | |
---|---|
dimensionHeaders[] |
يصف أعمدة السمات. وتتضمّن تقارير مسارات الإحالات الناجحة دائمًا سمة الخطوة في مسار الإحالة الناجحة في الردود على التقارير الفرعية. وقد تتوفّر سمات إضافية في الردّ إذا لزم الأمر، مثل البيانات التفصيلية والتواريخ والإجراءات التالية. |
metricHeaders[] |
تصف أعمدة المقاييس. تتضمّن تقارير مسارات الإحالات الناجحة دائمًا المستخدمين النشطين في الردود على التقارير الفرعية. يتضمّن جدول مسار الإحالة الناجحة مقاييس إضافية مثل معدّل الإكمال، ومعدّل المغادرة، ومعدّل التراجع. |
rows[] |
صفوف مجموعات قيم السمات وقيم المقاييس في التقرير |
metadata |
البيانات الوصفية لتقرير مسار الإحالة الناجحة |
FunnelResponseMetadata
تتضمّن البيانات الوصفية للاستجابة في تقرير مسار الإحالة الناجحة معلومات إضافية عن تقرير مسار الإحالة الناجحة.
تمثيل JSON |
---|
{
"samplingMetadatas": [
{
object ( |
الحقول | |
---|---|
samplingMetadatas[] |
إذا كانت نتائج تقرير مسار الإحالة الناجحة مستنِدة إلى عيّنات، يصف هذا المقياس النسبة المئوية للأحداث التي تم استخدامها في تقرير مسار الإحالة الناجحة هذا. تتم تعبئة ومع ذلك، إذا لم يتم أخذ عينات من النتائج، لن يتم تحديد هذا الحقل. |
SamplingMetadata
إذا كانت نتائج تقرير مسار الإحالة الناجحة مستنِدة إلى عيّنات، توضِّح هذه البيانات الوصفية النسبة المئوية للأحداث التي تم استخدامها في تقرير مسار الإحالة الناجحة هذا لنطاق زمني. أخذ العينات هو ممارسة تحليل مجموعة فرعية من جميع البيانات للكشف عن معلومات ذات مغزى في المجموعة الأكبر من البيانات.
تمثيل JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
الحقول | |
---|---|
samplesReadCount |
إجمالي عدد الأحداث التي تمت قراءتها في هذا التقرير المستند إلى عينات في نطاق زمني معيّن. هذا هو حجم المجموعة الفرعية لبيانات هذا الموقع التي تم تحليلها في تقرير مسار الإحالة الناجحة هذا. |
samplingSpaceSize |
إجمالي عدد الأحداث المتاحة في بيانات هذا الموقع والتي كان من الممكن تحليلها في تقرير مسار الإحالة الناجحة هذا لنطاق زمني يكشف أخذ العينات عن المعلومات المفيدة حول مجموعة البيانات الأكبر، وهذا هو حجم مجموعة البيانات الأكبر. لاحتساب النسبة المئوية للبيانات المتاحة التي تم استخدامها في تقرير مسار الإحالة الناجحة هذا، احسب |
PropertyQuota
الحالة الحالية لجميع الحصص لهذا الموقع على "إحصاءات Google". في حال استنفاد أي حصة لأحد المواقع، ستعرض جميع الطلبات المُرسَلة إلى ذلك الموقع أخطاء "تم استنفاد الموارد".
تمثيل JSON |
---|
{ "tokensPerDay": { object ( |
الحقول | |
---|---|
tokensPerDay |
يمكن لمواقع "إحصاءات Google" العادية استخدام ما يصل إلى 200,000 رمز مميّز في اليوم. يمكن لمواقع "إحصاءات 360" استخدام 2,000,000 رمز مميّز في اليوم. تستهلك معظم الطلبات أقل من 10 رموز مميّزة. |
tokensPerHour |
يمكن لمواقع "إحصاءات Google" العادية استخدام ما يصل إلى 40,000 رمز مميّز في الساعة. يمكن لمواقع "إحصاءات 360" استخدام 400,000 رمز مميّز في الساعة. يستهلك طلب واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميزة، ويتم خصم هذا الرقم من جميع الحصص كل ساعة ويومية ولكل مشروع. |
concurrentRequests |
يمكن لمواقع "إحصاءات Google" العادية إرسال ما يصل إلى 10 طلبات متزامنة. يمكن لمواقع "إحصاءات 360" استخدام ما يصل إلى 50 طلبًا متزامنًا. |
serverErrorsPerProjectPerHour |
يمكن أن تتضمّن مواقع "إحصاءات Google" العادية وأزواج المشاريع على السحابة الإلكترونية ما يصل إلى 10 أخطاء في الخادم في الساعة. يمكن أن تسجِّل مواقع "إحصاءات 360" والمشاريع على السحابة الإلكترونية ما يصل إلى 50 خطأ في الخادم في الساعة. |
potentiallyThresholdedRequestsPerHour |
يمكن لمواقع "إحصاءات Google" إرسال ما يصل إلى 120 طلبًا بسمات يُحتمَل أن يتم تطبيق حدود عليها في الساعة. في الطلب المجمّع، يتم احتساب كل طلب تقرير بشكل فردي لهذه الحصة إذا كان الطلب يحتوي على سمات يُحتمل أن تكون قد بلغت الحدّ الأدنى. |
tokensPerProjectPerHour |
يمكن لمواقع "إحصاءات Google" استخدام ما يصل إلى 35% من رموزها المميّزة لكلّ مشروع في الساعة. ويبلغ هذا الحد بالنسبة إلى مواقع "إحصاءات Google" العادية ما يصل إلى 14,000 رمز مميّز لكلّ مشروع في الساعة، ويمكن لمواقع "إحصاءات 360" استخدام 140,000 رمز مميّز لكلّ مشروع في الساعة. يستهلك طلب واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميزة، ويتم خصم هذا الرقم من جميع الحصص كل ساعة ويومية ولكل مشروع. |
QuotaStatus
الحالة الحالية لمجموعة حصص معيّنة.
تمثيل JSON |
---|
{ "consumed": integer, "remaining": integer } |
الحقول | |
---|---|
consumed |
الحصة التي يستهلكها هذا الطلب. |
remaining |
الحصة المتبقية بعد هذا الطلب. |