CohortSpec

Die Spezifikation von Kohorten für einen Kohortenbericht.

In Kohortenberichten wird eine Zeitreihe der Nutzerbindung für die Kohorte erstellt. Sie können beispielsweise die Kohorte der Nutzer auswählen, die in der ersten Septemberwoche gewonnen wurden, und diese Kohorte dann in den nächsten sechs Wochen beobachten. Die Auswahl der Nutzer, die in der ersten Septemberwoche gewonnen wurden, wird im cohort-Objekt angegeben. Die Beobachtung dieser Kohorte für die nächsten sechs Wochen wird im cohortsRange-Objekt angegeben.

Beispiele finden Sie unter Beispiele für Kohortenberichte.

Die Berichtsantwort kann eine wöchentliche Zeitreihe enthalten, in der beispielsweise dargestellt wird, dass Ihre App nach drei Wochen 60% und nach sechs Wochen 25% dieser Kohorte beibehalten hat. Diese beiden Prozentsätze können mit dem Messwert cohortActiveUsers/cohortTotalUsers berechnet werden und werden im Bericht in separaten Zeilen aufgeführt.

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

object (Cohort)

Hiermit werden die Auswahlkriterien für die Gruppierung von Nutzern in Kohorten definiert.

In den meisten Kohortenberichten wird nur eine einzige Kohorte definiert. Wenn mehrere Kohorten angegeben werden, können sie im Bericht anhand ihres Namens erkannt werden.
cohortsRange

object (CohortsRange)

In Kohortenberichten werden Kohorten über einen erweiterten Berichtszeitraum beobachtet. In diesem Bereich wird ein Zeitversatz angegeben, über den die Kohorten beobachtet werden sollen.
cohortReportSettings

object (CohortReportSettings)

Optionale Einstellungen für einen Kohortenbericht.

Kohorte

Hier werden die Kriterien für die Kohortenauswahl definiert. Eine Kohorte ist eine Gruppe von Nutzern mit einem gemeinsamen Merkmal. Beispielsweise gehören Nutzer mit demselben firstSessionDate zur selben Kohorte.

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

string

Dieser Kohorte wird ein Name zugewiesen. Der Wert der Dimension cohort wird in einer Berichtsantwort mit diesem Namen angegeben. Wenn festgelegt, darf der Wert nicht mit cohort_ oder RESERVED_ beginnen. Wenn diese Option nicht festgelegt ist, werden Kohorten nach ihrem Index (cohort_0, cohort_1 usw.) benannt, der bei null beginnt.
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 der ersten Interaktion zwischen dem Start- und Enddatum liegt, das in der dateRange definiert ist. Diese dateRange gibt nicht den vollständigen Zeitraum der Ereignisdaten an, die in einem Kohortenbericht enthalten sind. In einem Kohortenbericht wird dieser dateRange um die Detaillierung und den Offset in der cohortsRange erweitert. Ereignisdaten für den erweiterten Berichtszeitraum sind in einem Kohortenbericht enthalten.

In einer Kohortenanfrage ist diese dateRange erforderlich und die dateRanges in der RunReportRequest oder RunPivotReportRequest darf nicht angegeben sein.

Diese dateRange sollte im Allgemeinen mit der Granularität der Kohorte übereinstimmen. Wenn für CohortsRange die tägliche Granularität verwendet wird, kann dieser dateRange ein einzelner Tag sein. Wenn für CohortsRange die wöchentliche Granularität verwendet wird, kann dieser dateRange an einer Wochengrenze ausgerichtet werden, die am Sonntag beginnt und am Samstag endet. Wenn für CohortsRange die monatliche Detailebene verwendet wird, kann diese dateRange auf einen Monat ausgerichtet werden, der am ersten und am letzten Tag des Monats endet.

CohortsRange

Hiermit wird der erweiterte Berichtszeitraum für einen Kohortenbericht konfiguriert. Gibt einen zeitlichen Versatz an, über den die Kohorten beobachtet werden sollen.

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

enum (Granularity)

Erforderlich. Die Detaillierung, mit der startOffset und endOffset für den erweiterten Berichtszeitraum in einem Kohortenbericht interpretiert werden.
startOffset

integer

startOffset gibt das Startdatum des erweiterten Berichtszeitraums für einen Kohortenbericht an. startOffset wird in der Regel auf „0“ festgelegt, damit Berichte Daten ab der Akquisition der Kohorte enthalten.

Wenn granularity = DAILY ist, entspricht das startDate des erweiterten Berichtszeitraums dem startDate der Kohorte plus startOffset Tage.

Wenn granularity = WEEKLY ist, entspricht das startDate des erweiterten Berichtszeitraums dem startDate der Kohorte plus startOffset * 7 Tage.

Wenn granularity = MONTHLY ist, entspricht das startDate des erweiterten Berichtszeitraums dem 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, wird aber in der Regel auf 5 bis 10 festgelegt, damit Berichte Daten zur Kohorte für die nächsten Zeiträume mit höherer Detaillierung enthalten.

Wenn granularity = DAILY ist, entspricht das endDate des erweiterten Berichtszeitraums dem endDate der Kohorte plus endOffset Tage.

Wenn granularity = WEEKLY ist, entspricht das endDate des erweiterten Berichtszeitraums dem endDate der Kohorte plus endOffset * 7 Tage.

Wenn granularity = MONTHLY ist, entspricht das endDate des erweiterten Berichtszeitraums dem endDate der Kohorte plus endOffset * 30 Tage.

Detaillierungsgrad

Die Detaillierung, mit der startOffset und endOffset für den erweiterten Berichtszeitraum in einem Kohortenbericht interpretiert werden.

Enums
GRANULARITY_UNSPECIFIED Sollte niemals angegeben werden.
DAILY Tägliche Granularität. Wird häufig verwendet, wenn die dateRange der Kohorte ein einzelner Tag ist und die Anfrage cohortNthDay enthält.
WEEKLY Wöchentliche Detaillierung. Wird häufig verwendet, wenn die dateRange der Kohorte eine Woche lang ist (beginnend am Sonntag und endend am Samstag) und die Anfrage cohortNthWeek enthält.
MONTHLY Monatliche Detaillierung. Wird häufig verwendet, wenn die dateRange der Kohorte einen Monat lang ist und die Anfrage cohortNthMonth enthält.

CohortReportSettings

Optionale Einstellungen für einen Kohortenbericht.

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

boolean

Wenn „wahr“ festgelegt ist, wird das Ergebnis vom Tag der ersten Interaktion bis zum Enddatum erfasst. Nicht unterstützt in RunReportRequest.