CohortSpec

Specyfikacja kohort na potrzeby raportu dotyczącego kohorty.

Raporty kohortowe tworzą serię czasową danych o utrzymaniu użytkowników w kohortach. Możesz na przykład wybrać grupę użytkowników pozyskanych w pierwszym tygodniu września i śledzić ją przez kolejne 6 tygodni. Wybór użytkowników pozyskanych w pierwszym tygodniu września jest określony w obiekcie cohort. Dane o tych grupach na kolejne 6 tygodni są podawane w obiekcie cohortsRange.

Przykłady znajdziesz w artykule Przykłady raportu dotyczącego kohorty.

Odpowiedź w raporcie może zawierać tygodniową serię czasową, w której np. po 3 tygodniach aplikacja zachowała 60% tej grupy odbiorców, a po 6 tygodniach – 25%. Te 2 wartości procentowe można obliczyć na podstawie danych cohortActiveUsers/cohortTotalUsers i będą one widoczne w raporcie w oddzielnych wierszach.

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

object (Cohort)

Określa kryteria wyboru użytkowników do grup.

Większość raportów dotyczących kohort definiuje tylko jedną kohortą. Jeśli zdefiniujesz kilka grup, każda z nich może być rozpoznawana w raporcie po nazwie.
cohortsRange

object (CohortsRange)

Raporty dotyczące kohorty obejmują kohorty w rozszerzonym zakresie dat raportowania. Ten zakres określa przesunięcie czasu, które ma być stosowane do grup odbiorców.
cohortReportSettings

object (CohortReportSettings)

Opcjonalne ustawienia raportu dotyczącego kohorty.

Kohorta

Określa kryteria wyboru kohorty. Kohorta jest grupą użytkowników mających wspólną cechę. Na przykład użytkownicy z tym samym firstSessionDate należą do tej samej kohorty.

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

string

Przypisuje nazwę tej kohorcie. Wymiar cohort ma w odpowiedzi na raport tę nazwę. Jeśli jest ustawiony, nie może się zaczynać od cohort_ ani RESERVED_. Jeśli nie zostanie ustawiony, kohorty będą nazywane według indeksu o wartości 0, cohort_0, cohort_1 itd.
dimension

string

Wymiar używany przez kohortę. Wymagane i obsługuje tylko firstSessionDate.
dateRange

object (DateRange)

Kohorta wybiera użytkowników, których data pierwszego kontaktu mieści się w zakresie daty rozpoczęcia i zakończenia zdefiniowanych w dateRange. W tym dateRange nie jest podany pełny zakres dat danych o zdarzeniach, które są dostępne w raporcie grup. W raporcie kohorty ten dateRange jest rozszerzony o poziom szczegółowości i odstęp występujący w raporcie cohortsRange. W raporcie kohorty są widoczne dane o zdarzeniach z rozszerzonego zakresu dat raportowania.

W żądaniu dotyczącej grupy musisz podać wartość dateRange, a wartość dateRanges w kolumnie RunReportRequest lub RunPivotReportRequest musi być nieokreślona.

Wartość dateRange powinna być dopasowana do szczegółowości kohorty. Jeśli CohortsRange używa szczegółowości na poziomie dni, ten dateRange może być pojedynczym dniem. Jeśli CohortsRange używa tygodniowej rozdzielczości, ta dateRange może być dopasowana do granicy tygodnia, rozpoczynając się w niedzielę i kończąc w sobotę. Jeśli CohortsRange używa granularności miesięcznej, ta dateRange może być dopasowana do miesiąca, rozpoczynając się pierwszego dnia i kończąc ostatniego dnia miesiąca.

CohortsRange

Konfiguruje rozszerzony zakres dat raportowania na potrzeby raportu dotyczącego kohorty. Określa przesunięcie długości okresu, w którym mają być śledzone kohorty.

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

enum (Granularity)

Wymagane. Dokładność, która służy do interpretacji wartości startOffset i endOffset w przypadku rozszerzonego zakresu dat raportowania w raporcie dotyczącym kohorty.
startOffset

integer

startOffset określa datę rozpoczęcia rozszerzonego zakresu dat raportowania w przypadku raportu dotyczącego kohorty. Wartość startOffset jest zwykle ustawiana na 0, aby raporty zawierały dane od momentu pozyskania kohorty.

Jeśli granularity to DAILY, startDate rozszerzonego zakresu dat raportowania to startDate kohorty plus startOffset dni.

Jeśli granularity to WEEKLY, startDate rozszerzonego zakresu dat raportowania to startDate kohorty plus startOffset * 7 dni.

Jeśli granularity to MONTHLY, startDate rozszerzonego zakresu dat raportowania to startDate kohorty plus startOffset * 30 dni.
endOffset

integer

Wymagane. endOffset określa datę końcową rozszerzonego zakresu dat raportowania w przypadku raportu dotyczącego grup odbiorców. Wartość endOffset może być dowolną dodatnią liczbą całkowitą, ale zwykle wynosi od 5 do 10, aby raporty zawierały dane o grupie użytkowników na kolejne okresy o zmiennej szczegółowości.

Jeśli granularity to DAILY, endDate rozszerzonego zakresu dat raportowania to endDate kohorty plus endOffset dni.

Jeśli granularity to WEEKLY, endDate rozszerzonego zakresu dat raportowania to endDate kohorty plus endOffset * 7 dni.

Jeśli granularity to MONTHLY, endDate rozszerzonego zakresu dat raportowania to endDate kohorty plus endOffset * 30 dni.

Szczegółowość

Dokładność, która służy do interpretacji wartości startOffset i endOffset w przypadku rozszerzonego zakresu dat raportowania w raporcie dotyczącym kohorty.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Nigdy nie należy go podawać.
DAILY Szczegółowość dzienna. Jest często używana, jeśli dateRange w przypadku kohorty to 1 dzień, a żądanie zawiera cohortNthDay.
WEEKLY szczegółowość tygodniowa, Jest często używany, jeśli dateRange kohorty obejmuje tydzień (od niedzieli do soboty), a żądanie zawiera cohortNthWeek.
MONTHLY Miesięczny stopień szczegółowości. Jest często używany, 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ść true, kumuluje wynik od dnia pierwszego kontaktu do dnia zakończenia. Nieobsługiwane w RunReportRequest.