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

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