مواصفات المجموعات النموذجية لتقرير المجموعة النموذجية.
تنشئ تقارير المجموعات النموذجية سلسلة زمنية للحفاظ على المستخدمين في المجموعة النموذجية. على سبيل المثال، يمكنك اختيار المجموعة النموذجية للمستخدمين الذين تم اكتسابهم في الأسبوع الأول من أيلول (سبتمبر) ومتابعة تلك المجموعة النموذجية خلال الأسابيع الستة التالية. يتم تحديد المستخدمين الذين تم اكتسابهم في الأسبوع الأول من المجموعة النموذجية لشهر أيلول (سبتمبر) في عنصر cohort
. عند اتّباع هذه المجموعة النموذجية خلال الأسابيع الستة المقبلة، يتم تحديد ذلك في عنصر cohortsRange
.
للحصول على أمثلة، يُرجى الاطّلاع على أمثلة على تقارير المجموعات النموذجية.
يمكن أن يعرض الردّ على التقرير سلسلة زمنية أسبوعية يوضِّح فيها أن تطبيقك احتفظ بنسبة 60% من هذه المجموعة النموذجية بعد ثلاثة أسابيع و25% من هذه المجموعة النموذجية بعد ستة أسابيع. يمكن حساب هاتين النسبتين باستخدام المقياس "cohortActiveUsers/cohortTotalUsers
"، وسيتم استخدامهما باعتبارهما صفين منفصلين في التقرير.
تمثيل JSON |
---|
{ "cohorts": [ { object ( |
الحقول | |
---|---|
cohorts[] |
تحدِّد معايير الاختيار لتجميع المستخدمين في مجموعات نموذجية. وتحدِّد معظم تقارير المجموعات النموذجية مجموعة نموذجية واحدة فقط. وفي حال تحديد مجموعات نموذجية متعدّدة، يمكن التعرّف على كل مجموعة نموذجية في التقرير حسب اسمها. |
cohortsRange |
تتبع تقارير المجموعات النموذجية المجموعات النموذجية على مدار نطاق زمني ممتد لإعداد التقارير. يحدّد هذا النطاق مدة إزاحة لمتابعة المجموعات النموذجية بعدها. |
cohortReportSettings |
الإعدادات الاختيارية لتقرير المجموعة النموذجية. |
المجموعة النموذجية
تحدد معايير اختيار المجموعة النموذجية. المجموعة النموذجية هي مجموعة من المستخدمين تجمعهم خاصية مشتركة. على سبيل المثال، ينتمي المستخدمون الذين لديهم firstSessionDate
نفسه إلى المجموعة النموذجية نفسها.
تمثيل JSON |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
الحقول | |
---|---|
name |
يحدّد اسمًا لهذه المجموعة النموذجية. وتتم قيمة السمة " |
dimension |
السمة التي تستخدمها المجموعة النموذجية. مطلوبة وهي متوافقة مع |
dateRange |
تختار المجموعة النموذجية المستخدمين الذين يقع تاريخ الاتصال الأول لهم بين تاريخ البدء وتاريخ الانتهاء المحدَّدين في في طلب المجموعة النموذجية، يجب تحديد قيمة ويجب أن تتماشى سمة |
CohortsRange
تحدِّد هذه السياسة النطاق الزمني لإعداد التقارير الموسَّع لتقرير المجموعة النموذجية. تُحدِّد مدّة الإزاحة لمتابعة المجموعات النموذجية بعدها.
تمثيل JSON |
---|
{
"granularity": enum ( |
الحقول | |
---|---|
granularity |
مطلوبة. الدقة المستخدَمة لتفسير |
startOffset |
تحدّد إذا كانت قيمة إذا كانت قيمة إذا كانت قيمة |
endOffset |
مطلوبة. تحدّد إذا كانت قيمة إذا كانت قيمة إذا كانت قيمة |
درجة الدقة
الدقة المستخدَمة لتفسير startOffset
وendOffset
للنطاق الزمني الموسَّع لإعداد التقارير لتقرير المجموعة النموذجية.
عمليات التعداد | |
---|---|
GRANULARITY_UNSPECIFIED |
يجب عدم تحديدها مطلقًا. |
DAILY |
الدقة اليومية. تُستخدم عادةً إذا كانت قيمة dateRange للمجموعة النموذجية هي يوم واحد وكان الطلب يحتوي على cohortNthDay . |
WEEKLY |
الدقة الأسبوعية. تُستخدم عادةً إذا كانت قيمة dateRange للمجموعة النموذجية هي أسبوع (يبدأ من يوم الأحد وينتهي يوم السبت) ويحتوي الطلب على cohortNthWeek . |
MONTHLY |
الدقة الشهرية. يشيع استخدامها إذا كانت المدة dateRange للمجموعة النموذجية هي شهر وكان الطلب يتضمّن cohortNthMonth . |
CohortReportSettings
الإعدادات الاختيارية لتقرير المجموعة النموذجية.
تمثيل JSON |
---|
{ "accumulate": boolean } |
الحقول | |
---|---|
accumulate |
إذا كانت القيمة true، يتم تجميع النتيجة من يوم اللمس الأول حتى يوم الانتهاء. غير متاح في |