CohortSpec

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

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

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

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

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