CohortSpec

Die Angabe von Kohorten für einen Kohortenbericht.

In Kohortenberichten wird eine Zeitreihe zur Nutzerbindung für die Kohorte erstellt. Sie können beispielsweise die Kohorte von Nutzern auswählen, die in der ersten Septemberwoche akquiriert wurden, und dieser Kohorte in den nächsten sechs Wochen folgen. Die Auswahl der Nutzer, die in der ersten September-Kohorte gewonnen wurden, werden im cohort-Objekt festgelegt. Die nachfolgenden Kohorten für die nächsten sechs Wochen werden im cohortsRange-Objekt angegeben.

Beispiele finden Sie unter Beispiele für Kohortenberichte.

Die Antwort auf den Bericht könnte eine wöchentliche Zeitreihe enthalten, in der beispielsweise 60% dieser Kohorte nach drei Wochen und 25% der Kohorte nach sechs Wochen beibehalten wurden. Diese beiden Prozentsätze können mit dem Messwert cohortActiveUsers/cohortTotalUsers berechnet werden und werden im Bericht als separate Zeilen dargestellt.

JSON-Darstellung 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Felder
cohorts[]

object (Cohort)

Definiert die Auswahlkriterien für die Gruppierung von Nutzern in Kohorten.

In den meisten Kohortenberichten wird nur eine Kohorte definiert. Wenn mehrere Kohorten angegeben sind, kann jede im Bericht anhand ihres Namens erkannt werden.
cohortsRange

object (CohortsRange)

Kohortenberichte folgen Kohorten über einen längeren Berichtszeitraum. Dieser Bereich gibt einen Versatzzeitraum an, der auf die Kohorten angewendet wird.
cohortReportSettings

object (CohortReportSettings)

Optionale Einstellungen für einen Kohortenbericht.

Cohort

Definiert ein Kohortenauswahlkriterium. Eine Kohorte ist eine Gruppe von Nutzenden mit einem gemeinsamen Merkmal. Beispielsweise gehören Nutzer mit derselben firstSessionDate zur selben Kohorte.

JSON-Darstellung 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Felder
name

string

Weist dieser Kohorte einen Namen zu. Die Dimension „cohort“ wird in einer Berichtsantwort mit diesem Namen bewertet. Wenn festgelegt, darf sie nicht mit cohort_ oder RESERVED_ beginnen. Wenn nicht festgelegt, werden Kohorten nach ihrem nullbasierten Index cohort_0, cohort_1 usw. benannt.
dimension

string

Von der Kohorte verwendete Dimension. Erforderlich und unterstützt nur firstSessionDate.
dateRange

object (DateRange)

Für die Kohorte werden Nutzer ausgewählt, deren Datum des ersten Kontakts zwischen dem in der dateRange festgelegten Start- und dem Enddatum liegt. Dieses dateRange gibt nicht den gesamten Zeitraum der Ereignisdaten an, die in einem Kohortenbericht enthalten sind. In einem Kohortenbericht wird diese dateRange durch den Detaillierungsgrad und den Versatz der cohortsRange erweitert. Ereignisdaten für den erweiterten Berichtszeitraum sind in einem Kohortenbericht enthalten.

In einer Kohortenanfrage ist diese dateRange erforderlich und die dateRanges im RunReportRequest oder RunPivotReportRequest muss nicht angegeben werden.

Der Messwert „dateRange“ sollte im Allgemeinen am Detaillierungsgrad der Kohorte angepasst werden. Wenn CohortsRange die tägliche Granularität verwendet, kann die dateRange ein einzelner Tag sein. Wenn CohortsRange den wöchentlichen Detaillierungsgrad verwendet, kann diese dateRange an eine Wochengrenze ausgerichtet werden, von Sonntag bis Samstag. Wenn für CohortsRange der Detaillierungsgrad auf Monatsbasis verwendet wird, kann die dateRange auf einen Monat ausgerichtet werden, beginnend am ersten Tag bis zum letzten Tag des Monats.

CohortsRange

Mit dieser Richtlinie wird der erweiterte Berichtszeitraum für einen Kohortenbericht konfiguriert. Gibt einen Versatzzeitraum an, der auf die Kohorten angewendet wird.

JSON-Darstellung 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Felder
granularity

enum (Granularity)

Erforderlich. Der Detaillierungsgrad, mit dem startOffset und endOffset für den erweiterten Berichtszeitraum für einen Kohortenbericht interpretiert werden.
startOffset

integer

startOffset gibt das Startdatum des erweiterten Berichtszeitraums für einen Kohortenbericht an. startOffset ist häufig auf 0 gesetzt, damit Berichte Daten ab der Erfassung der Kohorte enthalten.

Wenn granularity den Wert DAILY hat, entspricht der startDate des erweiterten Berichtszeitraums startDate der Kohorte plus startOffset Tage.

Wenn granularity den Wert WEEKLY hat, entspricht der startDate des erweiterten Berichtszeitraums startDate der Kohorte plus startOffset * 7 Tage.

Wenn granularity den Wert MONTHLY hat, entspricht der startDate des erweiterten Berichtszeitraums startDate der Kohorte plus startOffset * 30 Tage.
endOffset

integer

Erforderlich. endOffset gibt das Enddatum des erweiterten Berichtszeitraums für einen Kohortenbericht an. endOffset kann eine beliebige positive Ganzzahl sein, ist aber im Allgemeinen auf einen Wert zwischen 5 und 10 festgelegt, sodass die Berichte Daten zur Kohorte für die jeweils nächsten Zeiträume enthalten.

Wenn granularity den Wert DAILY hat, entspricht der endDate des erweiterten Berichtszeitraums endDate der Kohorte plus endOffset Tage.

Wenn granularity den Wert WEEKLY hat, entspricht der endDate des erweiterten Berichtszeitraums endDate der Kohorte plus endOffset * 7 Tage.

Wenn granularity den Wert MONTHLY hat, entspricht der endDate des erweiterten Berichtszeitraums endDate der Kohorte plus endOffset * 30 Tage.

Detaillierungsgrad

Der Detaillierungsgrad, mit dem startOffset und endOffset für den erweiterten Berichtszeitraum für einen Kohortenbericht interpretiert werden.

Enums
GRANULARITY_UNSPECIFIED Sollte nie angegeben werden.
DAILY Tägliche Leseeinheit. Wird häufig verwendet, wenn das dateRange der Kohorte ein einzelner Tag ist und die Anfrage cohortNthDay enthält.
WEEKLY Wöchentlicher Detaillierungsgrad. Wird häufig verwendet, wenn das dateRange der Kohorte eine Woche dauert (beginnt am Sonntag und endet am Samstag) und die Anfrage cohortNthWeek enthält.
MONTHLY Monatlicher Detaillierungsgrad. Wird häufig verwendet, wenn das dateRange der Kohorte einen Monat lang ist und die Anfrage cohortNthMonth enthält.

CohortReportSettings

Optionale Einstellungen eines Kohortenberichts.

JSON-Darstellung 
{
  "accumulate": boolean
}
Felder
accumulate

boolean

Bei „true“ wird das Ergebnis vom ersten Berührungstag bis zum letzten Tag erfasst. In RunReportRequest nicht unterstützt.