CohortSpec

Specyfikacja kohort w raporcie dotyczącym kohorty.

Raporty dotyczące kohorty tworzą serię czasową utrzymania użytkowników w kohorcie. Możesz np. wybrać kohortę użytkowników pozyskanych w pierwszym tygodniu września i śledzić tę kohortę przez kolejne 6 tygodni. Wybór użytkowników pozyskanych w pierwszym tygodniu września jest określony w obiekcie cohort. Kohorta na kolejne 6 tygodni jest określona w obiekcie cohortsRange.

Przykłady znajdziesz w artykule Przykłady raportów dotyczących kohorty.

Odpowiedź w raporcie może zawierać cotygodniowy ciąg czasowy, w którym aplikacja utrzymała 60% tej kohorty po 3 tygodniach i 25% tej kohorty po 6 tygodniach. Te 2 wartości procentowe mogą być obliczane według danych cohortActiveUsers/cohortTotalUsers i znajdują się w oddzielnych wierszach raportu.

Zapis JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Pola
cohorts[]

object (Cohort)

Określa kryteria wyboru służące do grupowania użytkowników w kohorty.

Większość raportów dotyczących kohorty definiuje tylko jedną kohortę. Jeśli określisz wiele kohort, każda z nich zostanie rozpoznana w raporcie po jej nazwie.
cohortsRange

object (CohortsRange)

Raporty dotyczące kohorty uwzględniają kohorty w rozszerzonym zakresie dat. Ten zakres określa czas przesunięcia, aby śledzić kohorty.
cohortReportSettings

object (CohortReportSettings)

Opcjonalne ustawienia raportu dotyczącego kohorty.

Kohorta

Określa kryteria wyboru kohorty. Kohorta to grupa użytkowników, którzy mają wspólną cechę. Na przykład użytkownicy z takim samym atrybutem firstSessionDate należą do tej samej kohorty.

Zapis JSON 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Pola
name

string

Przypisuje nazwę do tej kohorty. Wymiar cohort otrzymuje tę nazwę w odpowiedzi na raport. Jeśli jest ustawione, nie może zaczynać się od cohort_ ani RESERVED_. Jeśli nie jest ustawiony, kohorty są nazwane według indeksu zerowego cohort_0, cohort_1 itd.
dimension

string

Wymiar używany przez kohortę. Wymagana i obsługiwana tylko w przypadku języka firstSessionDate.
dateRange

object (DateRange)

Kohorta wybiera użytkowników, których data pierwszego kontaktu przypada między datą rozpoczęcia a datą zakończenia określoną w dateRange. Ta wartość dateRange nie określa pełnego zakresu dat danych zdarzenia zawartych w raporcie dotyczącym kohorty. W raporcie dotyczącym kohorty wartość dateRange jest rozszerzona o stopień szczegółowości i przesunięcie występujące w kolumnie cohortsRange. Dane zdarzeń z rozszerzonego zakresu dat raportowania są dostępne w raporcie dotyczącym kohorty.

W żądaniu dotyczącym kohorty pole dateRange jest wymagane, a pole dateRanges w RunReportRequest lub RunPivotReportRequest musi być nieokreślone.

Ten parametr dateRange powinien być zwykle dopasowany do szczegółowości kohorty. Jeśli CohortsRange używa szczegółowości dziennie, dateRange może oznaczać 1 dzień. Jeśli funkcja CohortsRange używa szczegółowości tygodniowej, ten parametr dateRange można wyrównać do granicy tygodnia, zaczynając od niedzieli i kończąc w sobotę. Jeśli funkcja CohortsRange używa szczegółowości miesięcznej, wartość dateRange można wyrównać do miesiąca, zaczynając od pierwszego do ostatniego dnia miesiąca.

CohortsRange

Konfiguruje rozszerzony zakres dat w raporcie dotyczącym kohorty. Określa czas przesunięcia, aby śledzić kohorty.

Zapis JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Pola
granularity

enum (Granularity)

To pole jest wymagane. Szczegółowość używana do interpretacji startOffset i endOffset w rozszerzonym zakresie dat raportowania w raporcie dotyczącym kohorty.
startOffset

integer

startOffset określa datę rozpoczęcia rozszerzonego zakresu dat raportowania na potrzeby raportu dotyczącego kohorty. startOffset ma zwykle wartość 0, aby raporty zawierały dane dotyczące pozyskania kohorty w przyszłości.

Jeśli granularity to DAILY, wartość startDate w rozszerzonym zakresie dat raportowania to startDate kohorty plus startOffset dni.

Jeśli granularity to WEEKLY, wartość startDate w rozszerzonym zakresie dat raportowania to startDate kohorty plus startOffset * 7 dni.

Jeśli granularity to MONTHLY, wartość startDate w rozszerzonym zakresie dat raportowania to startDate kohorty plus startOffset * 30 dni.
endOffset

integer

To pole jest wymagane. endOffset określa datę zakończenia rozszerzonego zakresu dat w raporcie dotyczącym kohorty. endOffset może być dowolną dodatnią liczbą całkowitą, ale zwykle jest ustawiona na 5–10, aby raporty zawierały dane o kohorcie z kilku kolejnych okresów szczegółowości.

Jeśli granularity to DAILY, wartość endDate w rozszerzonym zakresie dat raportowania to endDate kohorty plus endOffset dni.

Jeśli granularity to WEEKLY, wartość endDate w rozszerzonym zakresie dat raportowania to endDate kohorty plus endOffset * 7 dni.

Jeśli granularity to MONTHLY, wartość endDate w rozszerzonym zakresie dat raportowania to endDate kohorty plus endOffset * 30 dni.

Szczegółowość

Szczegółowość używana do interpretacji startOffset i endOffset w rozszerzonym zakresie dat raportowania w raporcie dotyczącym kohorty.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Nigdy nie należy określać.
DAILY Szczegółowość dzienna. Zwykle używana, jeśli dateRange kohorty to 1 dzień, a żądanie zawiera cohortNthDay.
WEEKLY Szczegółowość tygodniowa. Zwykle używany, jeśli dateRange kohorty obejmuje tydzień (rozpoczynający się w niedzielę, a kończący w sobotę) i żądanie zawiera wartość cohortNthWeek.
MONTHLY Szczegółowość miesięczna. Zwykle używana, jeśli dateRange kohorty trwa miesiąc, a żądanie zawiera cohortNthMonth.

CohortReportSettings

Opcjonalne ustawienia raportu dotyczącego kohorty.

Zapis JSON 
{
  "accumulate": boolean
}
Pola
accumulate

boolean

Jeśli ma wartość prawda, kumuluje wynik od pierwszego dnia kontaktu do dnia końcowego. Nieobsługiwane w RunReportRequest.