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 می توان با یک ماه تراز کرد که از اول شروع می شود و در آخرین روز ماه به پایان می رسد.

محدوده همگروهی

محدوده تاریخ گزارش گسترده را برای گزارش گروهی پیکربندی می کند. مدت زمان افست را برای دنبال کردن همگروه ها مشخص می کند.

نمایندگی 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 باشد، استفاده می‌شود.

CohortReport Settings

تنظیمات اختیاری یک گزارش گروهی

نمایندگی JSON
{
  "accumulate": boolean
}
فیلدها
accumulate

boolean

اگر درست باشد، نتیجه را از روز اول لمس تا روز پایان جمع می‌کند. در RunReportRequest پشتیبانی نمی شود.