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 בטווח התאריכים של הדיווח המורחב על דוח על קבוצה בעלת מאפיינים משותפים.

טיפוסים בני מנייה (enums)
GRANULARITY_UNSPECIFIED אין לציין אף פעם.
DAILY רמת פירוט יומית. בדרך כלל הערך הזה משמש אם המאפיין dateRange של קבוצה בעלת מאפיינים משותפים הוא יום אחד והבקשה מכילה cohortNthDay.
WEEKLY רמת פירוט שבועית. לרוב, המאפיין 'dateRange' של הקבוצה בעלת המאפיינים המשותפים נמשך שבוע (מתחיל ביום ראשון ומסתיים בשבת) והבקשה כוללת cohortNthWeek.
MONTHLY רמת פירוט חודשית. בדרך כלל משמש אם המאפיין dateRange של הקבוצה בעלת המאפיינים המשותפים נמשך חודש והבקשה כוללת cohortNthMonth.

CohortReportSettings

הגדרות אופציונליות של דוח על קבוצה בעלת מאפיינים משותפים.

ייצוג JSON 
{
  "accumulate": boolean
}
שדות
accumulate

boolean

אם הערך הוא true, המערכת צוברת את התוצאה מיום המגע הראשון עד ליום הסיום. אין תמיכה בRunReportRequest.