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 นี้อาจเป็นเพียงวันเดียว หาก 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 ของกลุ่มประชากรตามรุ่นคือ 1 วันและคําขอมี cohortNthDay
WEEKLY รายละเอียดระดับรายสัปดาห์ ใช้กันโดยทั่วไปหาก dateRange ของกลุ่มประชากรตามรุ่นมีระยะเวลา 1 สัปดาห์ (เริ่มตั้งแต่วันอาทิตย์และสิ้นสุดในวันเสาร์) และคำขอมี cohortNthWeek
MONTHLY รายละเอียดรายเดือน ใช้กันโดยทั่วไปหาก dateRange ของกลุ่มประชากรตามรุ่นมีระยะเวลา 1 เดือนและคําขอมี cohortNthMonth

CohortReportSettings

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

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

boolean

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