CohortSpec

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

דוחות 'קבוצות בעלות מאפיינים משותפים' יוצרים סדרה כרונולוגית של שימור משתמשים בקבוצה. לדוגמה, אפשר לבחור את הקבוצה בעלת המאפיינים המשותפים של המשתמשים שצורפו בשבוע הראשון של ספטמבר ולעקוב אחרי הקבוצה הזו במשך ששת השבועות הבאים. בחירת המשתמשים שצורפו בקבוצה בעלת המאפיינים המשותפים בשבוע הראשון של ספטמבר מצוין באובייקט cohort. מעקב אחר הקבוצה הזו בששת השבועות הבאים מצוין באובייקט cohortsRange.

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

התשובה בדוח עשויה לכלול סדרה זמנית שבועית, שבה מוצגים, למשל, נתונים על כך שהאפליקציה שלכם שמרה על 60% מהקבוצה הזו אחרי שלושה שבועות ועל 25% מהקבוצה הזו אחרי שישה שבועות. אפשר לחשב את שני האחוזים האלה באמצעות המדד cohortActiveUsers/cohortTotalUsers, והם יופיעו בשורות נפרדות בדוח.

ייצוג ב-JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
שדות
cohorts[]

object (Cohort)

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

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

object (CohortsRange)

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

הגדרת טווח התאריכים המורחב לדיווח בדוח 'קבוצת משתמשים בעלת מאפיינים משותפים'. מציין את משך ההשהיה (offset) לצורך מעקב אחרי קבוצות האנשים.

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

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

CohortReportSettings

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

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

boolean

אם הערך הוא True, התוצאה מצטברת מיום החשיפה הראשון ליום הסיום. לא נתמך ב-RunReportRequest.