CohortSpec

Die Spezifikation von Kohorten für einen Kohortenbericht.

Kohortenberichte erstellen eine Zeitreihe zur Nutzerbindung für die Kohorte. Sie können beispielsweise die Kohorte der Nutzer 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 Septemberwoche akquiriert wurden, wird im cohort-Objekt festgelegt. Die nachfolgende Kohorte für die nächsten sechs Wochen wird im cohortsRange-Objekt angegeben.

Beispiele finden Sie unter Beispiele für Kohortenberichte.

Die Antwort im Bericht könnte eine wöchentliche Zeitreihe enthalten, bei der beispielsweise 60% der Kohorte nach drei Wochen und 25% nach sechs Wochen festgehalten sind. Diese beiden Prozentsätze können mit dem Messwert cohortActiveUsers/cohortTotalUsers berechnet werden und sind im Bericht separate Zeilen.

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.

Die meisten Kohortenberichte definieren nur eine einzelne Kohorte. Wenn mehrere Kohorten angegeben sind, kann jede Kohorte im Bericht anhand ihres Namens erkannt werden.
cohortsRange

object (CohortsRange)

Kohortenberichte beziehen sich auf Kohorten über einen längeren Berichtszeitraum. Dieser Bereich gibt einen Versatzzeitraum für die Kohorten an.
cohortReportSettings

object (CohortReportSettings)

Optionale Einstellungen für einen Kohortenbericht.

Kohorte

Definiert ein Auswahlkriterium für die Kohorte. Eine Kohorte ist eine Gruppe von Nutzern 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 auf diesen Namen gewertet. Wenn festgelegt, darf 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 der ersten Interaktion zwischen dem in der dateRange definierten Start- und dem Enddatum liegt. Mit dateRange wird nicht der gesamte Zeitraum der Ereignisdaten in einem Kohortenbericht angegeben. In einem Kohortenbericht wird dieser dateRange um den Detaillierungsgrad und den Offset in der cohortsRange erweitert. Kohortenbericht enthält Ereignisdaten für den erweiterten Berichtzeitraum.

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

Dieser Wert (dateRange) sollte sich im Allgemeinen auf den Detaillierungsgrad der Kohorte beziehen. Wenn CohortsRange den Detaillierungsgrad auf Tagesbasis verwendet, kann diese dateRange ein einzelner Tag sein. Wenn CohortsRange einen wöchentlichen Detaillierungsgrad verwendet, kann dieser dateRange auf eine Wochengrenze ausgerichtet werden, die am Sonntag beginnt und am Samstag endet. Wenn CohortsRange einen monatlichen Detaillierungsgrad verwendet, kann diese dateRange auf einen Monat ausgerichtet werden, beginnend am ersten Tag und endet am letzten Tag des Monats.

CohortsRange

Mit dieser Richtlinie wird der erweiterte Berichtszeitraum für einen Kohortenbericht konfiguriert. Gibt die Abweichungsdauer für die Kohorten an.

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

enum (Granularity)

Erforderlich. Der Detaillierungsgrad, der zur Interpretation von startOffset und endOffset für den erweiterten Berichtszeitraum für einen Kohortenbericht verwendet wird.
startOffset

integer

startOffset gibt das Startdatum des erweiterten Berichtszeitraums für einen Kohortenbericht an. startOffset ist normalerweise auf 0 gesetzt, sodass Berichte Daten ab der Akquisition der Kohorte enthalten.

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

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

Wenn granularity den Wert MONTHLY hat, beträgt 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, wird aber normalerweise auf 5 bis 10 festgelegt, sodass Berichte Daten zur Kohorte für die nächsten Detaillierungszeiträume enthalten.

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

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

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

Detaillierungsgrad

Der Detaillierungsgrad, der zur Interpretation von startOffset und endOffset für den erweiterten Berichtszeitraum für einen Kohortenbericht verwendet wird.

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

CohortReportSettings

Optionale Einstellungen eines Kohortenberichts.

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

boolean

Falls wahr, wird das Ergebnis vom ersten Berührungstag bis zum Endtag erfasst. Wird in RunReportRequest nicht unterstützt.