CohortSpec
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مواصفات المجموعات النموذجية لتقرير المجموعة النموذجية.
تنشئ تقارير المجموعات النموذجية سلسلة زمنية للحفاظ على المستخدمين في المجموعة النموذجية. على سبيل المثال، يمكنك اختيار المجموعة النموذجية للمستخدمين الذين تم اكتسابهم في الأسبوع الأول من أيلول (سبتمبر) ومتابعة تلك المجموعة النموذجية خلال الأسابيع الستة التالية. يتم تحديد المستخدمين الذين تم اكتسابهم في الأسبوع الأول من المجموعة النموذجية لشهر أيلول (سبتمبر) في عنصر cohort
. عند اتّباع هذه المجموعة النموذجية خلال الأسابيع الستة المقبلة، يتم تحديد ذلك في عنصر cohortsRange
.
للحصول على أمثلة، يُرجى الاطّلاع على أمثلة على تقارير المجموعات النموذجية.
يمكن أن يعرض الردّ على التقرير سلسلة زمنية أسبوعية يوضِّح فيها أن تطبيقك احتفظ بنسبة 60% من هذه المجموعة النموذجية بعد ثلاثة أسابيع و25% من هذه المجموعة النموذجية بعد ستة أسابيع. يمكن حساب هاتين النسبتين باستخدام المقياس "cohortActiveUsers/cohortTotalUsers
"، وسيتم استخدامهما باعتبارهما صفين منفصلين في التقرير.
الحقول |
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 .
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-05-02 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]