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.