CohortSpec

Specyfikacja kohort na potrzeby raportu dotyczącego kohorty.

Raporty dotyczące kohort tworzą ciąg czasowy utrzymania użytkowników w kohorcie. Możesz na przykład wybrać kohortę użytkowników, którzy zostali pozyskani w pierwszym tygodniu września, i śledzić ją przez kolejne 6 tygodni. Wybór użytkowników pozyskanych w pierwszym tygodniu kohorty wrześniowej odbywa się w obiekcie cohort. W obiekcie cohortsRange określa się obserwowanie tej kohorty przez następne 6 tygodni.

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

Odpowiedź w raporcie może przedstawiać tygodniowy ciąg czasowy, w którym Twoja aplikacja utrzymała 60% z tej kohorty po 3 tygodniach, a 25% – po 6 tygodniach. Te 2 wartości procentowe można obliczyć jako dane cohortActiveUsers/cohortTotalUsers i są one oddzielnymi wierszami w raporcie.

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 kohortach.

Większość raportów dotyczących kohort definiuje tylko jedną kohortę. Jeśli określisz wiele kohort, każda z nich będzie można rozpoznać w raporcie po nazwie.
cohortsRange

object (CohortsRange)

Raporty dotyczące kohort obejmują kohorty w rozszerzonym zakresie dat. Ten zakres określa czas przesunięcia, przez który należy ś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, którzy mają taką samą wartość (firstSessionDate), należą do tej samej kohorty.

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

string

Przypisuje nazwę do tej kohorty. W odpowiedzi raportu wartość wymiaru cohort jest przypisywana tej nazwie. Jeśli jest ustawiony, nie może zaczynać się od cohort_ ani RESERVED_. Jeśli zasada jest nieskonfigurowana, kohorty są nazywane zgodnie z ich indeksem liczonym od zera: cohort_0, cohort_1 itd.
dimension

string

Wymiar używany przez kohortę. Wymagany i obsługuje tylko 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 reguła dateRange nie określa pełnego zakresu dat danych zdarzenia, które znajdują się w raporcie dotyczącym kohorty. W raporcie dotyczącym kohorty pole dateRange jest poszerzane o poziom szczegółowości i przesunięcia występujące w raporcie cohortsRange; dane zdarzeń z rozszerzonego zakresu dat raportowania są dostępne w raporcie dotyczącym kohorty.

W żądaniu dotyczącym kohorty ten atrybut dateRange jest wymagany, a element dateRanges w elemencie RunReportRequest lub RunPivotReportRequest musi być nieokreślony.

Ten element dateRange powinien zwykle odpowiadać szczegółowości kohorty. Jeśli CohortsRange używa szczegółowości na poziomie dziennym, wartość w polu dateRange może wynosić 1 dzień. Jeśli funkcja CohortsRange używa szczegółowości tygodniowej, ten element dateRange można wyrównać do granicy tygodnia, zaczynając od niedzieli i kończąc w sobotę. Jeśli w zasadzie CohortsRange używany jest poziom szczegółowości miesięczny, ten element dateRange może zostać wyrównany do miesiąca, począwszy od pierwszego, a kończy w ostatnim dniu miesiąca.

CohortsRange

Konfiguruje rozszerzony zakres dat raportowania na potrzeby raportu dotyczącego kohorty. Określa czas przesunięcia, po którym następuje śledzenie kohort.

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

enum (Granularity)

Wymagane. Szczegółowość używana do interpretacji danych startOffset i endOffset w rozszerzonym zakresie dat raportu dotyczącego kohorty.
startOffset

integer

startOffset określa datę rozpoczęcia rozszerzonego zakresu dat raportowania w raporcie dotyczącym kohorty. startOffset ma zwykle wartość 0, aby raporty zawierały dane z pozyskania kohorty.

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

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

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

integer

Wymagane. endOffset określa datę zakończenia rozszerzonego zakresu dat raportowania raportu dotyczącego kohorty. Wartość endOffset może być dowolną dodatnią liczbą całkowitą, ale często wynosi od 5 do 10, aby raporty zawierały dane o kohorcie z kilku kolejnych okresów szczegółowości.

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

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

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

Szczegółowość

Szczegółowość używana do interpretacji danych startOffset i endOffset w rozszerzonym zakresie dat raportu dotyczącego kohorty.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Nie należy go nigdy określać.
DAILY Szczegółowość dzienna. Zwykle używany, gdy dateRange kohorty dotyczy jednego dnia, a żądanie zawiera cohortNthDay.
WEEKLY Szczegółowość tygodniowa. Zwykle jest używany, jeśli wartość dateRange kohorty trwa tydzień (rozpoczyna się w niedzielę, a kończy w sobotę), a żądanie zawiera cohortNthWeek.
MONTHLY Szczegółowość miesięczna. Zwykle używany, jeśli wartość dateRange kohorty obejmuje 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 (prawda), kumuluje wynik od dnia pierwszego kontaktu do dnia końcowego. Nieobsługiwane w tych krajach: RunReportRequest.