REST Resource: properties.reportTasks

Ressource: ReportTask

Eine bestimmte Berichtskonfiguration.

JSON-Darstellung 
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
Felder
name

string

Nur Ausgabe. ID. Der Ressourcenname der Berichtsaufgabe, der bei der Erstellung zugewiesen wurde. Format: „properties/{property}/reportTasks/{reportTask}“
reportDefinition

object (ReportDefinition)

Optional. Eine Berichtsdefinition zum Abrufen von Berichtsdaten, die die Struktur eines Berichts beschreibt. Sie enthält in der Regel die Felder, die im Bericht enthalten sein sollen, und die Kriterien, mit denen die Daten gefiltert werden.
reportMetadata

object (ReportMetadata)

Nur Ausgabe. Die Bericht-Metadaten für eine bestimmte Berichtsaufgabe, die Informationen zu einem Bericht enthalten. Er enthält in der Regel die folgenden Informationen: den Ressourcennamen des Berichts, den Status des Berichts, den Zeitstempel, zu dem der Bericht erstellt wurde usw.

ReportDefinition

Die Definition, wie ein Bericht ausgeführt werden soll.

JSON-Darstellung 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "samplingLevel": enum (SamplingLevel)
}
Felder
dimensions[]

object (Dimension)

Optional. Die angeforderten und angezeigten Dimensionen.
metrics[]

object (Metric)

Optional. Die angeforderten und angezeigten Messwerte.
dateRanges[]

object (DateRange)

Optional. Zeiträume der zu lesenden Daten. Wenn mehrere Zeiträume angefordert werden, enthält jede Antwortzeile einen nullbasierten Index für den Zeitraum. Wenn sich zwei Zeiträume überschneiden, werden die Ereignisdaten für die überschneidenden Tage in die Antwortzeilen für beide Zeiträume aufgenommen. In einer Kohortenanfrage muss dateRanges nicht angegeben werden.
dimensionFilter

object (FilterExpression)

Optional. Mit Dimensionsfiltern können Sie nur bestimmte Dimensionswerte im Bericht anfordern. Weitere Informationen Messwerte können in diesem Filter nicht verwendet werden.
metricFilter

object (FilterExpression)

Optional. Die Filterklausel für Messwerte. Wird nach dem Aggregieren der Zeilen des Berichts angewendet, ähnlich der SQL-HAVING-Klausel. Dimensionen können in diesem Filter nicht verwendet werden.
offset

string (int64 format)

Optional. Die Anzahl der Zeilen der Startzeile aus dem Google Analytics-Speicher. Die erste Zeile wird als Zeile 0 gezählt.

Beim Erstellen einer Berichtsaufgabe definieren die Parameter offset und limit die Teilmenge der Datenzeilen aus dem Google Analytics-Speicher, die in den generierten Bericht aufgenommen werden sollen. Wenn beispielsweise insgesamt 300.000 Zeilen im Google Analytics-Speicher vorhanden sind, enthält die erste Berichtsaufgabe möglicherweise die ersten 10.000 Zeilen mit einem Limit von 10.000 und einem Offset von 0. Anschließend könnte eine weitere Berichtsaufgabe die nächsten 10.000 Zeilen mit einem Limit von 10.000 und einem Offset von 10.000 abdecken.
limit

string (int64 format)

Optional. Die Anzahl der Zeilen, die im Bericht zurückgegeben werden sollen. Wenn nicht angegeben, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Sie anfordern. limit muss positiv sein.

Die API kann auch weniger Zeilen als die angeforderten limit zurückgeben, wenn es nicht so viele Dimensionswerte wie die limit gibt. Für die Dimension country gibt es beispielsweise weniger als 300 mögliche Werte. Wenn Sie also nur Berichte zu country erstellen, können Sie nicht mehr als 300 Zeilen erhalten, auch wenn Sie limit auf einen höheren Wert festlegen.
metricAggregations[]

enum (MetricAggregation)

Optional. Aggregation von Messwerten. Aggregierte Messwerte werden in Zeilen angezeigt, in denen „dimensionValues“ auf „RESERVED_(MetricAggregation)“ festgelegt ist.
orderBys[]

object (OrderBy)

Optional. Gibt an, wie Zeilen in der Antwort sortiert werden.
currencyCode

string

Optional. Ein Währungscode im ISO4217-Format, z. B. „AED“, „USD“ oder „JPY“. Wenn das Feld leer ist, wird die Standardwährung der Property verwendet.
cohortSpec

object (CohortSpec)

Optional. Die Kohortengruppe, die dieser Anfrage zugeordnet ist. Wenn in der Anfrage eine Kohortengruppe vorhanden ist, muss die Dimension „Kohorte“ vorhanden sein.
keepEmptyRows

boolean

Optional. Wenn „false“ oder nicht angegeben, wird jede Zeile mit allen Messwerten gleich 0 nicht zurückgegeben. Wenn „true“, werden diese Zeilen zurückgegeben, sofern sie nicht separat durch einen Filter entfernt werden.

Unabhängig von dieser keepEmptyRows-Einstellung können in einem Bericht nur Daten angezeigt werden, die von der Google Analytics-Property erfasst wurden.

Wenn für eine Property beispielsweise nie ein purchase-Ereignis protokolliert wird, enthält eine Abfrage für die Dimension eventName und den Messwert eventCount keine Zeile mit eventName: „purchase“ und eventCount: 0.
samplingLevel

enum (SamplingLevel)

Optional. Die Stichprobenebene des Berichts.

Dimension

Dimensionen sind Attribute Ihrer Daten. So gibt die Dimension „Stadt“ beispielsweise den Ort an, von dem ein Ereignis stammt. Dimensionswerte in Berichtsantworten sind Strings, z. B. „Paris“ oder „New York“.

JSON-Darstellung 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Felder
name

string

Der Name der Dimension. Eine Liste der Dimensionsnamen, die von Core Reporting-Methoden wie runReport und batchRunReports unterstützt werden, finden Sie unter API-Dimensionen. Eine Liste der von der Methode runRealtimeReport unterstützten Dimensionsnamen finden Sie unter Echtzeitdimensionen. Eine Liste der von der Methode runFunnelReport unterstützten Dimensionsnamen finden Sie unter Trichterdimensionen.

Wenn dimensionExpression angegeben ist, kann name ein beliebiger String innerhalb des zulässigen Zeichensatzes sein. Wenn beispielsweise dimensionExpression die Werte von country und city zusammenführt, könnten Sie diese Dimension countryAndCity nennen. Die von Ihnen ausgewählten Dimensionsnamen müssen dem regulären Ausdruck ^[a-zA-Z0-9_]$ entsprechen.

Auf Dimensionen wird in dimensionFilter, orderBys, dimensionExpression und pivots über name verwiesen.
dimensionExpression

object (DimensionExpression)

Eine Dimension kann das Ergebnis eines Ausdrucks aus mehreren Dimensionen sein. Beispiel: Dimension „Land, Stadt“: concatenate(country, „, “, city).

DimensionExpression

Wird verwendet, um eine Dimension auszudrücken, die das Ergebnis einer Formel aus mehreren Dimensionen ist. Beispiele für die Verwendung: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
Felder
Geben Sie einen Typ von Dimensionsausdruck für DimensionExpression an. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
lowerCase

object (CaseExpression)

Wird verwendet, um einen Dimensionswert in Kleinbuchstaben zu konvertieren.
upperCase

object (CaseExpression)

Wird verwendet, um einen Dimensionswert in Großbuchstaben umzuwandeln.
concatenate

object (ConcatenateExpression)

Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zusammenzufassen. Beispiel: Dimension „Land, Stadt“: concatenate(country, „, “, city).
Ende der sich gegenseitig ausschließenden Felder.

CaseExpression

Wird verwendet, um einen Dimensionswert in einen einzelnen Fall zu konvertieren.

JSON-Darstellung 
{
  "dimensionName": string
}
Felder
dimensionName

string

Name einer Dimension. Der Name muss sich auf einen Namen im Feld „dimensions“ der Anfrage beziehen.

ConcatenateExpression

Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zusammenzufassen.

JSON-Darstellung 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Felder
dimensionNames[]

string

Namen von Dimensionen. Die Namen müssen sich auf Namen im Feld „dimensions“ der Anfrage beziehen.
delimiter

string

Das Trennzeichen zwischen Dimensionsnamen.

Trennzeichen sind oft einzelne Zeichen wie „|“ oder „,“, können aber auch längere Strings sein. Wenn ein Dimensionswert das Trennzeichen enthält, sind beide in der Antwort ohne Unterscheidung vorhanden. Wenn beispielsweise der Wert für Dimension 1 „US,FR“, der Wert für Dimension 2 „JP“ und das Trennzeichen „,“ ist, enthält die Antwort „US,FR,JP“.

Messwert

Die quantitativen Messungen eines Berichts. Der Messwert eventCount ist beispielsweise die Gesamtzahl der Ereignisse. Anfragen dürfen bis zu 10 Messwerte enthalten.

JSON-Darstellung 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Felder
name

string

Der Name des Messwerts. Eine Liste der Messwertnamen, die von Core Reporting-Methoden wie runReport und batchRunReports unterstützt werden, finden Sie unter API-Messwerte. Eine Liste der Messwertnamen, die von der Methode runRealtimeReport unterstützt werden, finden Sie unter Echtzeitmesswerte. Eine Liste der von der runFunnelReport-Methode unterstützten Messwertnamen finden Sie unter Trichtermesswerte.

Wenn expression angegeben ist, kann name ein beliebiger String innerhalb des zulässigen Zeichensatzes sein. Wenn expression beispielsweise screenPageViews/sessions ist, könnten Sie den Namen des Messwerts als viewsPerSession bezeichnen. Die von Ihnen ausgewählten Messwertnamen müssen dem regulären Ausdruck ^[a-zA-Z0-9_]$ entsprechen.

Auf Messwerte wird von name in metricFilter, orderBys und dem Messwert expression verwiesen.
expression

string

Ein mathematischer Ausdruck für abgeleitete Messwerte. Der Messwert „Ereignisanzahl pro Nutzer“ ist beispielsweise eventCount/totalUsers.
invisible

boolean

Gibt an, ob ein Messwert in der Antwort des Berichts unsichtbar ist. Wenn ein Messwert unsichtbar ist, wird in der Antwort keine Spalte für ihn erstellt. Er kann aber in metricFilter, orderBys oder einem Messwert expression verwendet werden.

DateRange

Eine zusammenhängende Gruppe von Tagen: startDate, startDate + 1, ..., endDate. Es sind bis zu vier Zeiträume zulässig.

JSON-Darstellung 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Felder
startDate

string

Das Startdatum (angegebener Tag ist eingeschlossen) für die Abfrage im Format YYYY-MM-DD. Darf nicht nach dem endDate liegen. Das Format NdaysAgo, yesterday oder today wird ebenfalls akzeptiert. In diesem Fall wird das Datum anhand der Berichtszeitzone der Property abgeleitet.
endDate

string

Das Enddatum (letzter Tag eingeschlossen) für die Abfrage im Format YYYY-MM-DD. Darf nicht vor dem startDate liegen. Das Format NdaysAgo, yesterday oder today wird ebenfalls akzeptiert. In diesem Fall wird das Datum anhand der Berichtszeitzone der Property abgeleitet.
name

string

Weist diesem Zeitraum einen Namen zu. Die Dimension dateRange wird in einer Antwort auf einen Bericht auf diesen Namen festgelegt. Wenn festgelegt, darf der Wert nicht mit date_range_ oder RESERVED_ beginnen. Wenn nicht festgelegt, werden Zeiträume anhand ihres nullbasierten Index in der Anfrage benannt: date_range_0, date_range_1 usw.

FilterExpression

Zum Ausdrücken von Dimensions- oder Messwertfiltern. Die Felder in demselben FilterExpression müssen entweder alle Dimensionen oder alle Messwerte sein.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of mutually exclusive fields.
}
Felder
Geben Sie einen Filterausdruckstyp für FilterExpression an. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
andGroup

object (FilterExpressionList)

Die FilterExpressions in andGroup haben eine AND-Beziehung.
orGroup

object (FilterExpressionList)

Die FilterExpressions in orGroup haben eine OR-Beziehung.
notExpression

object (FilterExpression)

Der FilterExpression ist NICHT vom Typ notExpression.
filter

object (Filter)

Ein einfacher Filter. In demselben FilterExpression müssen alle Feldnamen des Filters entweder Dimensionen oder Messwerte sein.
Ende der sich gegenseitig ausschließenden Felder.

FilterExpressionList

Eine Liste von Filterausdrücken.

JSON-Darstellung 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Felder
expressions[]

object (FilterExpression)

Eine Liste von Filterausdrücken.

Filter

Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.

JSON-Darstellung 
{
  "fieldName": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // End of mutually exclusive fields.
}
Felder
fieldName

string

Der Name der Dimension oder des Messwerts. Muss ein Name sein, der in Dimensionen oder Messwerten definiert ist.
Geben Sie einen Filtertyp für Filter an. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
stringFilter

object (StringFilter)

Filter für zusammenhängende Strings.
inListFilter

object (InListFilter)

Ein Filter für Werte in der Liste.
numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.
betweenFilter

object (BetweenFilter)

Ein Filter für einen Bereich zwischen zwei Werten.
emptyFilter

object (EmptyFilter)

Ein Filter für leere Werte wie (not set)- und ""-Werte.
Ende der sich gegenseitig ausschließenden Felder.

StringFilter

Filter für String

JSON-Darstellung 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Felder
matchType

enum (MatchType)

Der Übereinstimmungstyp für diesen Filter.
value

string

Der Stringwert, der für den Abgleich verwendet wird.
caseSensitive

boolean

Wenn der Wert „true“ lautet, wird bei dem Stringwert zwischen Groß- und Kleinschreibung unterschieden.

MatchType

Der Übereinstimmungstyp eines String-Filters

Enums
MATCH_TYPE_UNSPECIFIED Ohne Angabe
EXACT Genaue Übereinstimmung des Stringwerts.
BEGINS_WITH Beginnt mit dem Stringwert.
ENDS_WITH Endet mit dem Stringwert.
CONTAINS Enthält den Stringwert.
FULL_REGEXP Vollständige Übereinstimmung des regulären Ausdrucks mit dem Stringwert.
PARTIAL_REGEXP Teilweise Übereinstimmung des regulären Ausdrucks mit dem Stringwert.

InListFilter

Das Ergebnis muss eine Liste von Stringwerten sein.

JSON-Darstellung 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Felder
values[]

string

Die Liste der Stringwerte. Darf nicht leer sein.
caseSensitive

boolean

Wenn der Wert „true“ lautet, wird bei dem Stringwert zwischen Groß- und Kleinschreibung unterschieden.

NumericFilter

Filter für numerische Werte oder Datumswerte.

JSON-Darstellung 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Felder
operation

enum (Operation)

Der Vorgangstyp für diesen Filter.
value

object (NumericValue)

Ein numerischer Wert oder ein Datumswert.

Vorgang

Der Vorgang, der auf einen numerischen Filter angewendet wird

Enums
OPERATION_UNSPECIFIED Nicht angegeben
EQUAL Gleich
LESS_THAN Weniger als
LESS_THAN_OR_EQUAL kleiner als oder gleich
GREATER_THAN größer als
GREATER_THAN_OR_EQUAL größer als oder gleich

NumericValue

Eine Zahl darstellen.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "int64Value": string,
  "doubleValue": number
  // End of mutually exclusive fields.
}
Felder
Einer der folgenden numerischen Werte. Die folgenden Felder schließen sich gegenseitig aus. In einer Antwort wird höchstens eines der Felder festgelegt:
int64Value

string (int64 format)

Ganzzahlwert
doubleValue

number

Doppelter Wert
Ende der sich gegenseitig ausschließenden Felder.

BetweenFilter

Um anzugeben, dass das Ergebnis zwischen zwei Zahlen liegen muss (einschließlich).

JSON-Darstellung 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Felder
fromValue

object (NumericValue)

Beginnt mit dieser Nummer.
toValue

object (NumericValue)

Endet mit dieser Nummer.

EmptyFilter

Dieser Typ hat keine Felder.

Nach leeren Werten filtern Entspricht Dimensionswerten, die ""- oder (not set)-Werte sind. Mit diesem Filter können Sie Zeilen mit fehlenden oder nicht ausgefüllten Dimensionswerten abgleichen oder ihn mit notExpression kombinieren, um sie aus einem Bericht auszuschließen, ohne separat nach "" und (not set) zu filtern.

MetricAggregation

Stellt die Aggregation von Messwerten dar.

Enums
METRIC_AGGREGATION_UNSPECIFIED Nicht angegebener Operator.
TOTAL SUM-Operator.
MINIMUM Operator für das Minimum.
MAXIMUM Maximaler Operator.
COUNT Count-Operator

OrderBy

Mit „Order bys“ wird festgelegt, wie Zeilen in der Antwort sortiert werden. Wenn Sie beispielsweise Zeilen nach absteigender Ereignisanzahl sortieren, ist das eine andere Sortierung als wenn Sie Zeilen nach dem Ereignisnamen sortieren.

JSON-Darstellung 
{
  "desc": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of mutually exclusive fields.
}
Felder
desc

boolean

Wenn „true“, wird in absteigender Reihenfolge sortiert.
Geben Sie einen Typ von „order by“ für OrderBy an. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
metric

object (MetricOrderBy)

Sortiert Ergebnisse nach den Werten eines Messwerts.
dimension

object (DimensionOrderBy)

Sortiert Ergebnisse nach den Werten einer Dimension.
Ende der sich gegenseitig ausschließenden Felder.

MetricOrderBy

Sortiert nach Messwerten.

JSON-Darstellung 
{
  "metricName": string
}
Felder
metricName

string

Ein Messwertname in der Anfrage, nach dem sortiert werden soll.

DimensionOrderBy

Sortiert nach Dimensionswerten.

JSON-Darstellung 
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
Felder
dimensionName

string

Ein Dimensionsname in der Anfrage, nach dem sortiert werden soll.
orderType

enum (OrderType)

Steuert die Regel für die Reihenfolge von Dimensionswerten.

OrderType

Regel zum Sortieren der String-Dimensionswerte.

Enums
ORDER_TYPE_UNSPECIFIED Nicht angegeben
ALPHANUMERIC Alphanumerische Sortierung nach Unicode-Codepunkt. Beispiel: „2“ < „A“ < „X“ < „b“ < „z“.
CASE_INSENSITIVE_ALPHANUMERIC Alphanumerische Sortierung ohne Berücksichtigung der Groß-/Kleinschreibung nach Unicode-Codepunkt in Kleinbuchstaben. Beispiel: „2“ < „A“ < „b“ < „X“ < „z“.
NUMERIC Dimensionswerte werden vor dem Sortieren in Zahlen umgewandelt. Bei der NUMERIC-Sortierung gilt beispielsweise „25“ < „100“ und bei der ALPHANUMERIC-Sortierung „100“ < „25“. Nicht numerische Dimensionswerte haben alle den gleichen Sortierwert, der unter allen numerischen Werten liegt.

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 in den nächsten sechs Wochen beobachten. Die Auswahl der Nutzer, die in der ersten Woche der September-Kohorte gewonnen wurden, wird im cohort-Objekt angegeben. Die Nachbeobachtung dieser Kohorte in den nächsten sechs Wochen wird im cohortsRange-Objekt angegeben.

Beispiele finden Sie unter Beispiele für Kohortenberichte.

In der Antwort des Berichts könnte eine wöchentliche Zeitreihe angezeigt werden, in der beispielsweise zu sehen ist, dass 60% dieser Kohorte nach drei Wochen und 25% nach sechs Wochen in Ihrer App aktiv sind. Diese beiden Prozentsätze können mit dem Messwert cohortActiveUsers/cohortTotalUsers berechnet werden und werden in separaten Zeilen im Bericht angezeigt.

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

object (Cohort)

Definiert die Auswahlkriterien, um Nutzer in Kohorten zu gruppieren.

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

object (CohortsRange)

In Kohortenberichten werden Kohorten über einen längeren Berichtszeitraum hinweg verfolgt. In diesem Bereich wird eine Offset-Dauer angegeben, über die die Kohorten beobachtet werden sollen.
cohortReportSettings

object (CohortReportSettings)

Optionale Einstellungen für einen Kohortenbericht.

Kohorte

Definiert ein Kriterium für die Kohortenauswahl. 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

Weist dieser Kohorte einen Namen zu. Die Dimension cohort wird in einer Antwort auf einen Bericht auf diesen Namen festgelegt. Wenn festgelegt, darf der Wert nicht mit cohort_ oder RESERVED_ beginnen. Wenn nicht festgelegt, werden Kohorten nach ihrem nullbasierten Index benannt: cohort_0, cohort_1 usw.
dimension

string

Dimension, die von der Kohorte verwendet wird. Erforderlich und unterstützt nur firstSessionDate.
dateRange

object (DateRange)

In der Kohorte werden Nutzer ausgewählt, deren erstes Touchpoint-Datum zwischen dem Start- und Enddatum liegt, das in dateRange definiert ist. dateRange gibt nicht den vollständigen Zeitraum der Ereignisdaten an, die in einem Kohortenbericht enthalten sind. In einem Kohortenbericht wird dieser Zeitraum dateRange durch die Granularität und den Offset im cohortsRange verlängert. Ereignisdaten für den verlängerten Berichtszeitraum sind in einem Kohortenbericht verfügbar.

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

Dieser dateRange sollte in der Regel auf die Granularität der Kohorte abgestimmt sein. Wenn für CohortsRange die tägliche Granularität verwendet wird, kann dateRange ein einzelner Tag sein. Wenn für CohortsRange die wöchentliche Granularität verwendet wird, kann dateRange an einer Woche ausgerichtet werden, die am Sonntag beginnt und am Samstag endet. Wenn CohortsRange eine monatliche Granularität verwendet, kann dateRange an einen Monat angepasst werden, der am ersten und am letzten Tag des Monats beginnt und endet.

CohortsRange

Konfiguriert den erweiterten Zeitraum für einen Kohortenbericht. Gibt eine Offset-Dauer an, über die die Kohorten beobachtet werden sollen.

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

enum (Granularity)

Erforderlich. Der Detaillierungsgrad, der zum Interpretieren von startOffset und endOffset für den erweiterten Berichtszeitraum eines Kohortenberichts verwendet wird.
startOffset

integer

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

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

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

Wenn granularity gleich MONTHLY ist, ist das startDate des erweiterten Berichtszeitraums das 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 der entsprechenden Granularität enthalten.

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

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

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

Detaillierungsgrad

Der Detaillierungsgrad, der zum Interpretieren von startOffset und endOffset für den erweiterten Berichtszeitraum eines Kohortenberichts verwendet wird.

Enums
GRANULARITY_UNSPECIFIED Sollte nie angegeben werden.
DAILY Täglicher Detaillierungsgrad. Wird häufig verwendet, wenn der dateRange der Kohorte ein einzelner Tag ist und die Anfrage cohortNthDay enthält.
WEEKLY Wöchentliche Detaillierung. Wird häufig verwendet, wenn der dateRange der Kohorte eine Woche lang ist (beginnend am Sonntag und endend am Samstag) und die Anfrage cohortNthWeek enthält.
MONTHLY Monatlicher Detaillierungsgrad. Wird häufig verwendet, wenn der 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 Tag der Berührung bis zum Enddatum kumuliert. Wird in RunReportRequest nicht unterstützt.

SamplingLevel

Kategorien von Stichprobenebenen für die Anfragen.

Enums
SAMPLING_LEVEL_UNSPECIFIED Nicht definierter Typ.
LOW Wendet eine Stichprobengröße von 10 Millionen auf Standard-Properties und 100 Millionen auf Google Analytics 360-Properties an.
MEDIUM Exklusiv für Google Analytics 360-Properties mit einer Stichprobenebene von 1 Milliarde.
UNSAMPLED Exklusiv für Google Analytics 360-Properties. Explorative Gesamtdatenanalysen sind genauer und können Informationen aufdecken, die bei standardmäßigen Verfahren nicht verfügbar sind. Weitere Informationen finden Sie unter https://support.google.com/analytics/answer/10896953.

ReportMetadata

Die Bericht-Metadaten für eine bestimmte Berichtsaufgabe.

JSON-Darstellung 
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
Felder
creationQuotaTokensCharged

integer

Nur Ausgabe. Die Gesamtzahl der Kontingent-Tokens, die bei der Erstellung des Berichts berechnet wurden. Da diese Anzahl von Tokens auf Aktivitäten im Status CREATING basiert, ist die Gebühr für diese Tokens festgelegt, sobald eine Berichtsaufgabe in den Status ACTIVE oder FAILED wechselt.
state

enum (State)

Nur Ausgabe. Der aktuelle Status dieser Berichtsaufgabe.
beginCreatingTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem reportTasks.create aufgerufen wurde und der Bericht den Status CREATING erreicht hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
taskRowCount

integer

Nur Ausgabe. Die Gesamtzahl der Zeilen im Berichtsergebnis. Dieses Feld wird ausgefüllt, wenn der Status aktiv ist. Sie können taskRowCount für die Paginierung innerhalb des vorhandenen Berichts verwenden.
errorMessage

string

Nur Ausgabe. Eine Fehlermeldung wird angezeigt, wenn beim Erstellen einer Berichtsaufgabe ein Fehler auftritt.
totalRowCount

integer

Nur Ausgabe. Die Gesamtzahl der Zeilen im Google Analytics-Speicher. Wenn Sie zusätzliche Datenzeilen abfragen möchten, die über den aktuellen Bericht hinausgehen, können Sie eine neue Berichtsaufgabe auf Grundlage von totalRowCount starten.

taskRowCount steht für die Anzahl der Zeilen, die sich speziell auf den aktuellen Bericht beziehen, während totalRowCount die Gesamtzahl der Zeilen für alle Daten umfasst, die aus dem Google Analytics-Speicher abgerufen werden.

Angenommen, der aktuelle Bericht hat einen taskRowCount-Wert von 20. Dann werden die Daten aus den ersten 20 Zeilen angezeigt. Gleichzeitig ist totalRowCount = 30, was darauf hinweist, dass Daten für alle 30 Zeilen vorhanden sind. Mit taskRowCount können Sie durch die ersten 20 Zeilen blättern. Wenn Sie den Bericht erweitern und Daten aus allen 30 Zeilen einbeziehen möchten, können Sie mit totalRowCount eine neue Berichtsaufgabe erstellen, um auf den vollständigen Datensatz mit 30 Zeilen zuzugreifen.

Bundesland

Der Verarbeitungsstatus.

Enums
STATE_UNSPECIFIED Der Status „Nicht angegeben“ wird nie verwendet.
CREATING Der Bericht wird gerade erstellt und ist in Zukunft verfügbar. Die Erstellung erfolgt unmittelbar nach dem Aufruf von „CreateReport“.
ACTIVE Der Bericht wurde vollständig erstellt und kann abgefragt werden.
FAILED Der Bericht konnte nicht erstellt werden.

Methoden

create

 Startet die Erstellung einer Berichtsaufgabe.

get

 Ruft Bericht-Metadaten zu einer bestimmten Berichtsaufgabe ab.

list

 Listet alle Berichtsaufgaben für eine Property auf.

query

 Ruft den Inhalt einer Berichtsaufgabe ab.