CohortSpec

مواصفات المجموعات النموذجية لتقرير المجموعة النموذجية.

تُنشئ تقارير المجموعات النموذجية سلسلة زمنية للاحتفاظ بالمستخدمين في المجموعة النموذجية. على سبيل المثال، يمكنك اختيار المجموعة النموذجية من المستخدِمين الذين تم اكتسابهم في الأسبوع الأول من شهر أيلول (سبتمبر)، ومتابعة تلك المجموعة النموذجية على مدار الأسابيع الستة التالية. يتم تحديد اختيار المستخدمين المكتسَبين في المجموعة النموذجية من الأسبوع الأول من أيلول (سبتمبر) في العنصر cohort. وبعد هذه المجموعة النموذجية للأسابيع الستة التالية، يتم تحديدها في العنصر cohortsRange.

للحصول على أمثلة، يُرجى الاطّلاع على أمثلة تقارير المجموعات النموذجية.

يمكن أن تعرض استجابة التقرير سلسلة زمنية أسبوعية تفيد بأن تطبيقك قد احتفظ بنسبة 60% من هذه المجموعة النموذجية بعد ثلاثة أسابيع و25% من هذه المجموعة النموذجية بعد ستة أسابيع. يمكن حساب هاتَين النسبتَين المئوية باستخدام المقياس "cohortActiveUsers/cohortTotalUsers" وسيكونان صفَين منفصلَين في التقرير.

تمثيل JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
الحقول
cohorts[]

object (Cohort)

تُحدِّد معايير الاختيار لتجميع المستخدمين في مجموعات نموذجية.

وتُحدِّد معظم تقارير المجموعات النموذجية مجموعة نموذجية واحدة فقط. في حال تحديد مجموعات نموذجية متعددة، يمكن التعرّف على كل مجموعة نموذجية في التقرير حسب اسمها.
cohortsRange

object (CohortsRange)

تتبع تقارير المجموعات النموذجية المجموعات النموذجية على مدار نطاق زمني موسع لإعداد التقارير. يحدّد هذا النطاق مدة إزاحة لمتابعة المجموعات النموذجية خلالها.
cohortReportSettings

object (CohortReportSettings)

إعدادات اختيارية لتقرير المجموعة النموذجية.

المجموعة النموذجية

تحدد معايير اختيار المجموعة النموذجية. المجموعة النموذجية هي مجموعة من المستخدمِين لهم سمة مشترَكة. على سبيل المثال، ينتمي المستخدمون الذين لديهم سمة firstSessionDate نفسها إلى المجموعة النموذجية نفسها.

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

string

يعيّن اسمًا لهذه المجموعة النموذجية. يتمّ تحديد قيمة السمة cohort لهذا الاسم في ردّ التقرير. وفي حال ضبطها، لا يمكن أن تبدأ بـ cohort_ أو RESERVED_. وفي حال ترك هذه السياسة بدون ضبط، تتم تسمية المجموعات النموذجية حسب الفهرس المستند إلى صفر cohort_0 وcohort_1 وما إلى ذلك.
dimension

string

السمة التي تستخدمها المجموعة النموذجية. مطلوبة ولا تتوافق إلا مع firstSessionDate.
dateRange

object (DateRange)

وتختار المجموعة النموذجية المستخدمين الذين يقع تاريخ اللمس الأول بين تاريخ البدء وتاريخ الانتهاء المحدّدين في dateRange. لا تحدِّد dateRange هذه النطاق الزمني الكامل لبيانات الأحداث الواردة في تقرير مجموعة نموذجية. في تقرير المجموعة النموذجية، يتم توسيع dateRange حسب الدقة والإزاحة الواردة في cohortsRange. أن تكون بيانات الأحداث للنطاق الزمني الموسَّع لإعداد التقارير متوفّرة في تقرير مجموعة نموذجية.

في طلب المجموعة النموذجية، تكون السمة dateRange مطلوبة، ويجب عدم تحديد dateRanges في RunReportRequest أو RunPivotReportRequest.

يجب أن يتماشى نوع dateRange هذا بشكل عام مع دقة المجموعة النموذجية. إذا كان CohortsRange يستخدم الدقة اليومية، يمكن أن تكون قيمة dateRange هذه يومًا واحدًا. في حال استخدام CohortsRange الدقة الأسبوعية، يمكن محاذاة dateRange مع حد أسبوع، بدءًا من الأحد وينتهي السبت. إذا كان CohortsRange يستخدم الدقة الشهرية، يمكن محاذاة dateRange مع شهر، بدءًا من أول يوم وينتهي في اليوم الأخير من الشهر.

CohortsRange

تضبط هذه السياسة النطاق الزمني الموسَّع لإعداد التقارير في تقرير مجموعة نموذجية. يُحدِّد مدة معادلة لمتابعة المجموعات النموذجية.

تمثيل JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
الحقول
granularity

enum (Granularity)

مطلوب. الدقة المستخدَمة لتفسير startOffset وendOffset للنطاق الزمني الموسَّع لإعداد التقارير في تقرير مجموعة نموذجية
startOffset

integer

تحدّد السمة startOffset تاريخ بدء النطاق الزمني الموسَّع لإعداد التقارير لأحد تقارير المجموعة النموذجية. يتم ضبط startOffset عادةً على 0 بحيث تحتوي التقارير على بيانات منذ اكتساب المجموعة النموذجية فصاعدًا.

إذا كانت قيمة granularity هي DAILY، يكون startDate في النطاق الزمني الموسَّع لإعداد التقارير هو startDate من المجموعة النموذجية بالإضافة إلى startOffset يوم.

إذا كانت قيمة granularity هي WEEKLY، يكون startDate في النطاق الزمني الموسَّع لإعداد التقارير هو startDate من المجموعة النموذجية بالإضافة إلى startOffset * 7 يوم.

إذا كانت قيمة granularity هي MONTHLY، يكون startDate في النطاق الزمني الموسَّع لإعداد التقارير هو startDate من المجموعة النموذجية بالإضافة إلى startOffset * 30 يوم.
endOffset

integer

مطلوب. تحدّد السمة endOffset تاريخ انتهاء النطاق الزمني الموسَّع لإعداد التقارير في تقرير مجموعة نموذجية. يمكن أن يكون endOffset أي عدد صحيح موجب ولكن يتم ضبطه عادةً على من 5 إلى 10 بحيث تحتوي التقارير على بيانات في المجموعة النموذجية خلال الفترات الزمنية العديدة التالية التي تتطلّب الدقة.

إذا كانت قيمة granularity هي DAILY، يكون endDate في النطاق الزمني الموسَّع لإعداد التقارير هو endDate من المجموعة النموذجية بالإضافة إلى endOffset يوم.

إذا كانت قيمة granularity هي WEEKLY، يكون endDate في النطاق الزمني الموسَّع لإعداد التقارير هو endDate من المجموعة النموذجية بالإضافة إلى endOffset * 7 يوم.

إذا كانت قيمة granularity هي MONTHLY، يكون endDate في النطاق الزمني الموسَّع لإعداد التقارير هو endDate من المجموعة النموذجية بالإضافة إلى endOffset * 30 يوم.

الدقة

الدقة المستخدَمة لتفسير startOffset وendOffset للنطاق الزمني الموسَّع لإعداد التقارير في تقرير مجموعة نموذجية

عمليات التعداد
GRANULARITY_UNSPECIFIED لا يجب تحديدها مطلقًا.
DAILY الدقة اليومية. ويشيع استخدام هذه السمة إذا كانت السمة dateRange للمجموعة النموذجية هي يوم واحد وكان الطلب يحتوي على السمة cohortNthDay.
WEEKLY الدقة الأسبوعية. ويشيع استخدام هذه السمة إذا كانت مدة dateRange للمجموعة النموذجية أسبوعًا (تبدأ يوم الأحد وتنتهي يوم السبت) ويتضمّن الطلب cohortNthWeek.
MONTHLY الدقة الشهرية. ويشيع استخدام هذه السمة إذا كانت مدة السمة dateRange للمجموعة النموذجية هي شهر وكان الطلب يحتوي على cohortNthMonth.

CohortReportSettings

الإعدادات الاختيارية لتقرير المجموعة النموذجية.

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

boolean

إذا كانت القيمة هي "صحيح"، يتم تجميع النتائج من يوم اللمس الأول إلى يوم الانتهاء. غير متاح في RunReportRequest.