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_ ไม่ได้ หากไม่ได้ตั้งค่า กลุ่มประชากรตามรุ่นจะตั้งชื่อตามดัชนีที่อิงตาม 0 cohort_0, cohort_1 เป็นต้น
dimension

string

มิติข้อมูลที่กลุ่มประชากรตามรุ่นใช้ จำเป็นและรองรับเฉพาะ firstSessionDate
dateRange

object (DateRange)

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

ในคำขอกลุ่มประชากรตามรุ่น คุณต้องระบุ dateRange นี้ และไม่ได้ระบุ dateRanges ใน RunReportRequest หรือ RunPivotReportRequest

โดยทั่วไป dateRange นี้ควรสอดคล้องกับรายละเอียดของกลุ่มประชากรตามรุ่น หาก CohortsRange ใช้รายละเอียดแบบรายวัน dateRange นี้อาจเป็นแบบ 1 วัน หาก 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