CohortSpec

ข้อกำหนดของกลุ่มประชากรตามรุ่นสำหรับรายงานกลุ่มประชากรตามรุ่น

รายงานกลุ่มประชากรตามรุ่นจะสร้างอนุกรมเวลาของการคงผู้ใช้ไว้สำหรับกลุ่มประชากรตามรุ่น เช่น คุณอาจเลือกกลุ่มประชากรตามรุ่นของผู้ใช้ที่ได้มาในสัปดาห์แรกของเดือนกันยายน และติดตามกลุ่มประชากรตามรุ่นนั้นในอีก 6 สัปดาห์ การเลือกผู้ใช้ที่ได้มาในสัปดาห์แรกของกลุ่มประชากรตามรุ่นในเดือนกันยายนจะแสดงในออบเจ็กต์ cohort ระบบได้ระบุกลุ่มประชากรตามรุ่นดังกล่าวในช่วง 6 สัปดาห์ถัดไปไว้ในออบเจ็กต์ cohortsRange

โปรดดูตัวอย่างต่อไปนี้ที่หัวข้อตัวอย่างรายงานกลุ่มประชากรตามรุ่น

การตอบกลับของรายงานอาจแสดงอนุกรมเวลารายสัปดาห์ที่สมมติว่าแอปของคุณรักษา 60% ของกลุ่มประชากรตามรุ่นนี้หลังจากผ่านไป 3 สัปดาห์และ 25% ของกลุ่มประชากรตามรุ่นนี้หลังจากผ่านไป 6 สัปดาห์ เปอร์เซ็นต์ 2 ค่านี้คำนวณได้โดยใช้เมตริก 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 ของกลุ่มประชากรตามรุ่นมีระยะเวลา 1 สัปดาห์ (เริ่มในวันอาทิตย์และสิ้นสุดในวันเสาร์) และคำขอมี cohortNthWeek
MONTHLY รายละเอียดรายเดือน ใช้กันโดยทั่วไปหาก dateRange ของกลุ่มประชากรตามรุ่นมีระยะเวลา 1 เดือนและคำขอมี cohortNthMonth

CohortReportSettings

การตั้งค่าที่ไม่บังคับของรายงานกลุ่มประชากรตามรุ่น

การแสดง JSON 
{
  "accumulate": boolean
}
ช่อง
accumulate

boolean

หากเป็น "จริง" จะรวบรวมผลลัพธ์ตั้งแต่วันที่แตะครั้งแรกไปจนถึงวันที่สิ้นสุด ไม่รองรับใน RunReportRequest