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

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

CohortReportSettings

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

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

boolean

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