Method: properties.runFunnelReport

Gibt einen benutzerdefinierten Trichterbericht mit Ihren Google Analytics-Ereignisdaten zurück. Die von der API zurückgegebenen Daten liegen als Tabelle mit Spalten für die angeforderten Dimensionen und Messwerte vor.

Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden. Wie werden z. B. aus potenziellen Kunden Besucher und letztendlich Käufer? Wie werden Neukunden zu Bestandskunden? Anhand dieser Informationen können Sie dann entsprechende Optimierungen vornehmen. Weitere Informationen

Diese Methode wird in der Alpha-Entwicklungsphase eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Über Feedback zu Google Analytics Data API-Trichterberichten können Sie uns Feedback zu dieser API geben.

HTTP-Anfrage

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
property

string

Eine Google Analytics GA4-Property-ID, deren Ereignisse erfasst werden. Wird im URL-Pfad und nicht im Text angegeben. Weitere Informationen dazu, wo Sie die Property-ID finden Innerhalb einer Batchanfrage sollte dieses Attribut entweder nicht angegeben werden oder mit dem Attribut auf Batchebene übereinstimmen.

Beispiel: properties/1234

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Felder
dateRanges[]

object (DateRange)

Datumsbereiche der zu lesenden Daten. Wenn mehrere Zeiträume angefordert werden, enthält jede Antwortzeile einen nullbasierten Zeitraumindex. Wenn sich zwei Zeiträume überschneiden, werden die Ereignisdaten für die sich überschneidenden Tage in den Antwortzeilen für beide Zeiträume aufgeführt.

funnel

object (Funnel)

Die Konfiguration des Trichters für diese Anfrage. Diese Trichterkonfiguration ist erforderlich.

funnelBreakdown

object (FunnelBreakdown)

Wenn angegeben, wird durch diese Aufschlüsselung der Antwort des Teilberichts zur Trichtertabelle eine Dimension hinzugefügt. Mit dieser Aufschlüsselungsdimension wird jeder Trichterschritt auf die eindeutigen Werte der Aufschlüsselungsdimension erweitert. Bei einer Aufschlüsselung nach der Dimension „deviceCategory“ werden beispielsweise Zeilen für mobile, tablet, desktop und die Summe erstellt.

funnelNextAction

object (FunnelNextAction)

Wenn angegeben, wird mit „Nächste Aktion“ der Antwort des Teilberichts zur Trichtervisualisierung eine Dimension hinzugefügt. Mit der Dimension „Nächste Aktion“ wird jeder Trichterschritt zu den eindeutigen Werten der nächsten Aktion erweitert. Bei einer nächsten Aktion der Dimension eventName werden beispielsweise Zeilen für mehrere Ereignisse (z. B. session_start und click) sowie die Gesamtsumme erstellt.

Die nächste Aktion unterstützt nur eventName und die meisten Seiten-/Bildschirmdimensionen wie pageTitle und pagePath.

funnelVisualizationType

enum (FunnelVisualizationType)

Mit dem Typ „Trichtervisualisierung“ werden die Dimensionen in der Antwort des Teilberichts zur Trichtervisualisierung gesteuert. Falls nichts angegeben wird, wird STANDARD_FUNNEL verwendet.

segments[]

object (Segment)

Die Konfigurationen von Segmenten. Segmente sind Teilmengen der Daten einer Property. In einem Trichterbericht mit Segmenten wird der Trichter in jedem Segment ausgewertet.

Jedes in dieser Anfrage angegebene Segment generiert eine separate Zeile in der Antwort. In der Antwort wird jedes Segment mit seinem Namen identifiziert.

Der Segmentparameter ist optional. Anfragen sind auf vier Segmente beschränkt.

limit

string (int64 format)

Die Anzahl der zurückzugebenden Zeilen. Wenn kein Wert angegeben ist, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen Sie anfordern. limit muss positiv sein.

Die API kann auch weniger Zeilen als die angeforderte Anzahl von limit zurückgeben, wenn nicht so viele Dimensionswerte wie limit vorhanden sind.

dimensionFilter

object (FilterExpression)

Mit Dimensionsfiltern können Sie nach bestimmten Dimensionswerten im Bericht fragen. Weitere Informationen finden Sie unter Bericht erstellen: Dimensionsfilter. Messwerte können in diesem Filter nicht verwendet werden.

returnPropertyQuota

boolean

Gibt an, ob der aktuelle Status des Kontingents dieser Analytics-Property zurückgegeben werden soll. Das Kontingent wird in PropertyQuota zurückgegeben.

Antworttext

Die Antwort zum Trichterbericht enthält zwei Unterberichte. Die beiden untergeordneten Berichte sind unterschiedliche Kombinationen von Dimensionen und Messwerten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Felder
funnelTable

object (FunnelSubReport)

Die Trichtertabelle ist ein Bericht, der den Trichterschritt, das Segment, die Aufschlüsselungsdimension, die aktiven Nutzer, die Abschlussrate, die Ausstiege und die Ausstiegsrate enthält.

Die Segmentdimension ist nur in dieser Antwort vorhanden, wenn ein Segment angefordert wurde. Die Aufschlüsselungsdimension ist in dieser Antwort nur vorhanden, wenn sie angefordert wurde.

funnelVisualization

object (FunnelSubReport)

Die Trichtervisualisierung ist ein Bericht mit Schritt im Trichter, Segment, Datum, Dimension „Nächste Aktion“ und aktiven Nutzern.

Die Segmentdimension ist nur in dieser Antwort vorhanden, wenn ein Segment angefordert wurde. Die Datumsdimension ist in dieser Antwort nur vorhanden, wenn sie über den Trichtertyp TRENDED_FUNNEL angefordert wurde. Die Dimension „Nächste Aktion“ ist nur dann in der Antwort vorhanden, wenn sie angefordert wurde.

propertyQuota

object (PropertyQuota)

Der Kontingentstatus dieser Analytics-Property, einschließlich dieser Anfrage.

kind

string

Gibt an, um welche Art von Ressource diese Nachricht geht. Diese kind ist immer der feste String "analyticsData#runFunnelReport". Dies ist hilfreich, um zwischen Antworttypen in JSON zu unterscheiden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

DateRange

Aufeinanderfolgende Tage: startDate, startDate + 1, ..., endDate. Anfragen sind für bis zu vier Zeiträume zulässig.

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

string

Das einschließende Startdatum für die Abfrage im Format YYYY-MM-DD. Darf nicht nach endDate liegen. Das Format NdaysAgo, yesterday oder today wird ebenfalls akzeptiert. In diesem Fall wird das Datum aus der Zeitzone für Berichte der Property abgeleitet.

endDate

string

Das einschließende Enddatum für die Abfrage im Format YYYY-MM-DD. Darf nicht vor startDate liegen. Das Format NdaysAgo, yesterday oder today wird ebenfalls akzeptiert. In diesem Fall wird das Datum aus der Zeitzone für Berichte der Property abgeleitet.

name

string

Weist diesem Zeitraum einen Namen zu. Die Dimension „dateRange“ wird in einer Berichtsantwort als dieser Name bewertet. Wenn festgelegt, darf sie nicht mit date_range_ oder RESERVED_ beginnen. Wenn nicht festgelegt, werden Zeiträume nach ihrem nullbasierten Index in der Anfrage benannt: date_range_0, date_range_1 usw.

Trichter

Konfiguriert den Trichter in einer Trichterberichtsanfrage. In einem Trichter werden Daten zu Nutzern in einer Abfolge von Schritten erfasst.

Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden. Wie werden z. B. aus potenziellen Kunden Besucher und letztendlich Käufer? Wie werden Neukunden zu Bestandskunden? Anhand dieser Informationen können Sie dann entsprechende Optimierungen vornehmen.

JSON-Darstellung
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
Felder
isOpenFunnel

boolean

In einem offenen Trichter können Nutzer den Trichter bei jedem Schritt betreten. Bei einem geschlossenen Trichter muss er im ersten Schritt betreten werden. Optional. Wenn nicht angegeben, wird ein geschlossener Trichter verwendet.

steps[]

object (FunnelStep)

Die sequenziellen Schritte dieses Trichters.

Trichterschritt

Mit Schritten wird der Kaufprozess definiert, den Sie analysieren möchten. Schritte enthalten eine oder mehrere Bedingungen, die Ihre Nutzer erfüllen müssen, um in diesem Schritt des Trichterpfads aufgenommen zu werden.

JSON-Darstellung
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Felder
name

string

Der eindeutige Name für diesen Schritt. Wenn kein Wert angegeben ist, werden die Schritte mit einem auf 1 basierenden indexierten Namen benannt (z. B. „0. ", "1. „ usw.). Mit diesem Namen wird der Stringwert definiert, der von der Dimension funnelStepName zurückgegeben wird. Wenn Sie beispielsweise im dritten Trichterschritt der Anfrage name = Purchase angeben, erhalten Sie in der Antwort des Trichterberichts den Wert 3. Purchase.

isDirectlyFollowedBy

boolean

Wenn dieser Wert „true“ ist, muss dieser Schritt direkt auf den vorherigen Schritt folgen. Bei „false“ können zwischen dem vorherigen und diesem Schritt Ereignisse auftreten. Wenn keine Vorgabe erfolgt, wird isDirectlyFollowedBy als „false“ behandelt.

filterExpression

object (FunnelFilterExpression)

Die Bedingung, die Ihre Nutzer erfüllen müssen, um in diesen Schritt des Trichterprozesses aufgenommen zu werden.

withinDurationFromPriorStep

string (Duration format)

Wenn angegeben, muss dieser Schritt innerhalb der Dauer nach Abschluss des vorherigen Schritts abgeschlossen werden. withinDurationFromPriorStep umfasst den Endpunkt im Detaillierungsgrad von Mikrosekunden. Beispielsweise kann eine Dauer von 5 Sekunden bei 4,9 oder 5 Sekunden abgeschlossen werden, aber nicht bei 5 Sekunden und 1 Mikrosekunde.

withinDurationFromPriorStep ist optional. Wenn nicht angegeben, können die Schritte nach einer beliebigen Zeitdauer getrennt werden.

Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

FunnelFilterExpression

Drückt Kombinationen von Trichterfiltern aus.

JSON-Darstellung
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
Felder
Union-Feld expr. Geben Sie eine Filterart für FunnelFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in andGroup hat eine AND-Beziehung.

orGroup

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in orGroup hat eine OR-Beziehung.

notExpression

object (FunnelFilterExpression)

FunnelFilterExpression ist NICHT notExpression.

funnelFieldFilter

object (FunnelFieldFilter)

Ein Trichterfilter für eine Dimension oder einen Messwert.

funnelEventFilter

object (FunnelEventFilter)

Erstellt einen Filter, der Ereignisse eines einzelnen Ereignisnamens zurückgibt. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.

FunnelFilterExpressionList

Eine Liste mit Trichterfilterausdrücken.

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

object (FunnelFilterExpression)

Die Liste der Trichterfilterausdrücke.

FunnelFieldFilter

Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.

JSON-Darstellung
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Felder
fieldName

string

Name der Dimension oder des Messwerts

Union-Feld one_filter. Geben Sie einen Filtertyp an. Für one_filter ist nur einer der folgenden Werte zulässig:
stringFilter

object (StringFilter)

Filter in Bezug auf Strings.

inListFilter

object (InListFilter)

Ein Filter für Listenwerte.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

StringFilter

Filter für String

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

enum (MatchType)

Die Keyword-Option für diesen Filter.

value

string

Der für den Abgleich verwendete Stringwert.

caseSensitive

boolean

Wenn „true“, wird beim Stringwert die Groß-/Kleinschreibung beachtet.

MatchType

Der Übereinstimmungstyp eines Stringfilters

Enums
MATCH_TYPE_UNSPECIFIED Ohne Angabe
EXACT Genaue Übereinstimmung mit dem Stringwert.
BEGINS_WITH Beginnt mit dem Stringwert.
ENDS_WITH Er endet mit dem Stringwert.
CONTAINS Enthält den Stringwert.
FULL_REGEXP Vollständige Übereinstimmung für den regulären Ausdruck mit dem Stringwert.
PARTIAL_REGEXP Teilübereinstimmung für den regulären Ausdruck mit dem Stringwert.

InListFilter

Das Ergebnis muss in einer Liste von Stringwerten enthalten sein.

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

string

Die Liste der Stringwerte. Das Feld darf nicht leer sein.

caseSensitive

boolean

Wenn „true“, wird beim Stringwert die Groß-/Kleinschreibung beachtet.

Numerischer Filter

Filter für numerische 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

Für eine Zahl.

JSON-Darstellung
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Felder
Union-Feld one_value. Einer der numerischen Werte one_value kann nur einer der folgenden Werte sein:
int64Value

string (int64 format)

Ganzzahlwert

doubleValue

number

Doppelter Wert

Zwischen Filter

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

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

object (NumericValue)

Beginnt mit dieser Zahl.

toValue

object (NumericValue)

Endet mit dieser Nummer.

FunnelEventFilter (Trichter-Ereignisfilter)

Erstellt einen Filter, der Ereignisse eines einzelnen Ereignisnamens zurückgibt. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.

JSON-Darstellung
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Felder
eventName

string

Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich.

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Wenn angegeben, werden mit diesem Filter Ereignisse abgeglichen, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.

Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar.

FunnelParameterFilterExpression

Drückt Kombinationen von Trichterfiltern für Parameter aus.

JSON-Darstellung
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Felder
Union-Feld expr. Geben Sie eine Filterart für FunnelParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (FunnelParameterFilterExpressionList)

Die Parameter „FunnelParameterFilterExpression“ in andGroup haben eine UND-Beziehung.

orGroup

object (FunnelParameterFilterExpressionList)

Die Parameter „FunnelParameterFilterExpression“ in orGroup haben eine ODER-Beziehung.

notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression ist NICHT von notExpression.

funnelParameterFilter

object (FunnelParameterFilter)

Ein einfacher Trichterparameterfilter.

FunnelParameterFilterExpressionList

Eine Liste mit Ausdrücken für Trichterparameter.

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

object (FunnelParameterFilterExpression)

Die Liste der Filterausdrücke für Trichterparameter.

FunnelParameterFilter

Ein Ausdruck zum Filtern von Parameterwerten in einem Trichter.

JSON-Darstellung
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Felder
Union-Feld one_parameter. Das Feld, das gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig:
eventParameterName

string

Dieser Filter wird anhand des angegebenen Ereignisparameters ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Ereignisparameter umfassen Felder wie „firebase_screen“ und „currency“.

Ereignisparameter können nur in Segmenten und Trichtern und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden.

itemParameterName

string

Dieser Filter wird anhand des angegebenen „item“-Parameters ausgewertet. Artikelparameter werden als Parameter im Element-Array protokolliert. Zu den Artikelparametern gehören Felder wie „item_name“ und „item_category“.

Artikelparameter können nur in Segmenten und Trichtern und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden.

Artikelparameter sind nur für E-Commerce-Ereignisse verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie im Leitfaden E-Commerce messen.

Union-Feld one_filter. Geben Sie einen Filtertyp an. Für one_filter ist nur einer der folgenden Werte zulässig:
stringFilter

object (StringFilter)

Filter in Bezug auf Strings.

inListFilter

object (InListFilter)

Ein Filter für Listenwerte.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

Trichteraufschlüsselung

Bei der Aufschlüsselung wird der Antwort auf den Teilbericht der Trichtertabelle eine Dimension hinzugefügt.

JSON-Darstellung
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Felder
breakdownDimension

object (Dimension)

Die Spalte „Dimension“, die zur Antwort auf den Teilbericht der Trichtertabelle hinzugefügt wurde. Die Dimension „Aufschlüsselung“ schlüsselt jeden Schritt im Trichter auf. Ein gültiger breakdownDimension ist erforderlich, wenn funnelBreakdown angegeben ist.

limit

string (int64 format)

Die maximale Anzahl unterschiedlicher Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden soll. Ein limit von 5 wird verwendet, wenn kein Limit angegeben ist. Der Grenzwert muss größer als null sein und darf 15 nicht überschreiten.

Dimension

Dimensionen sind Attribute Ihrer Daten. Die Dimension „Stadt“ gibt beispielsweise den Ort an, von dem ein Ereignis ausgeht. Dimensionswerte in Berichtsantworten sind Strings. Für die Stadt kann beispielsweise „Paris“ oder „New York“ angegeben sein.

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

string

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

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

In dimensionFilter, orderBys, dimensionExpression und pivots wird mit name auf die Dimensionen verwiesen.

dimensionExpression

object (DimensionExpression)

Eine Dimension kann das Ergebnis eines Ausdrucks mit mehreren Dimensionen sein. Beispiel: Die Dimension „Land, Stadt“: verketten(Land, „, „, Stadt).

DimensionExpression

Wird verwendet, um eine Dimension auszudrücken, die das Ergebnis einer Formel aus mehreren Dimensionen ist. Anwendungsbeispiele: 1) Kleinbuchstaben(Dimension) 2) Verketten(Dimension1, Symbol, Abmessung2).

JSON-Darstellung
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Felder
Union-Feld one_expression. Geben Sie einen Typ des Dimensionsausdrucks für DimensionExpression an. Für one_expression ist nur einer der folgenden Werte zulässig:
lowerCase

object (CaseExpression)

Damit wird ein Dimensionswert in Kleinbuchstaben umgewandelt.

upperCase

object (CaseExpression)

Damit wird ein Dimensionswert in Großbuchstaben umgewandelt.

concatenate

object (ConcatenateExpression)

Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zu kombinieren. Beispiel: Die Dimension „Land, Stadt“: verketten(Land, „, „, Stadt).

CaseExpression

Damit wird ein Dimensionswert in einen einzelnen Fall umgewandelt.

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

string

Name einer Dimension. Der Name muss sich auf einen Namen im Dimensionsfeld der Anfrage beziehen.

Verkettenausdruck

Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zu kombinieren.

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

string

Namen der Dimensionen. Die Namen müssen sich auf Namen im Dimensionsfeld der Anfrage beziehen.

delimiter

string

Das Trennzeichen zwischen den Dimensionsnamen.

Als Trennzeichen werden häufig einzelne Zeichen wie „|“ oder „“ verwendet. Es kann sich aber auch um längere Strings handeln. Wenn ein Dimensionswert das Trennzeichen enthält, sind beide Antworten ohne Unterscheidung vorhanden. Wenn beispielsweise der Wert von Dimension 1 „US,FR“, der Wert der Dimension 2 „JP“ und das Trennzeichen = „,“ ist, enthält die Antwort „US,FR,JP“.

TrichterNächsteAktion

Die nächsten Aktionen geben den Wert für eine Dimension an, nachdem der Nutzer einen Schritt erreicht hat, aber bevor er den nächsten Schritt erreicht hat. Beispiel: Wenn nextActionDimension den Wert eventName hat, gibt nextActionDimension in der Zeile i. Trichterschritts das erste Ereignis nach dem Ereignis zurück, durch das der Nutzer zum i. Trichterschritt, aber vor dem i+1. Schritt im Trichter qualifiziert wurde.

JSON-Darstellung
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Felder
nextActionDimension

object (Dimension)

Die Dimensionsspalte, die der Antwort auf den Teilbericht zur Trichtervisualisierung hinzugefügt wurde. Die Dimension „Nächste Aktion“ gibt den nächsten Dimensionswert dieser Dimension zurück, nachdem der Nutzer den i. Schritt im Trichter erreicht hat.

nextActionDimension unterstützt derzeit nur eventName und die meisten Seiten-/Bildschirmgrößen wie pageTitle und pagePath. nextActionDimension darf kein Dimensionsausdruck sein.

limit

string (int64 format)

Die maximale Anzahl unterschiedlicher Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden soll. Ein limit von 5 wird verwendet, wenn kein Limit angegeben ist. Der Grenzwert muss größer als null sein und darf 5 nicht überschreiten.

FunnelVisualizationType

Damit werden die Dimensionen in der Antwort des Teilberichts zur Trichtervisualisierung gesteuert.

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nicht definierter Typ.
STANDARD_FUNNEL Ein standardmäßiger (abgestufter) Trichter. Der Teilbericht zur Trichtervisualisierung in der Antwort enthält kein Datum.
TRENDED_FUNNEL Ein Trichter mit Trend (Liniendiagramm) Der Teilbericht „Trichtervisualisierung“ in der Antwort enthält die Dimension „Datum“.

Segment

Ein Segment ist eine Teilmenge Ihrer Analytics-Daten. Beispielsweise könnten Nutzer aus demselben Land oder Ort ein Segment all Ihrer Nutzer sein. Oder Sie segmentieren nach Nutzern, die Artikel einer Produktlinie kaufen, einen bestimmten Bereich Ihrer Website besuchen oder dasselbe Ereignis in Ihrer App auslösen.

Weitere Informationen finden Sie unter GA4-Segmentierungstool.

JSON-Darstellung
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
Felder
name

string

Der Name für dieses Segment. Wenn keine Vorgabe erfolgt, werden Segmente als „Segment“ bezeichnet. Mit diesem Namen wird der Stringwert definiert, der von der Dimension segment zurückgegeben wird. Die Dimension segment stellt Segmentnamen die 1-basierte Indexnummer des Segments in der Anfrage voran, z. B. „1. Segment", "2. Segment“ usw.).

Union-Feld one_segment_scope. Ein Segment wird in einem Umfang angegeben. Für one_segment_scope ist nur einer der folgenden Werte zulässig:
userSegment

object (UserSegment)

Nutzersegmente sind Teilmengen von Nutzern, die mit Ihrer Website oder App interagiert haben.

sessionSegment

object (SessionSegment)

Sitzungssegmente sind Teilmengen der Sitzungen, die auf Ihrer Website oder in Ihrer App stattgefunden haben.

eventSegment

object (EventSegment)

Ereignissegmente sind Teilmengen von Ereignissen, die auf Ihrer Website oder in Ihrer App ausgelöst wurden.

Nutzersegment

Nutzersegmente sind Teilmengen von Nutzern, die mit Ihrer Website oder App interagiert haben, z. B. Nutzer, die bereits einen Kauf abgeschlossen haben oder die Artikel in den Einkaufswagen gelegt, aber keinen Kauf abgeschlossen haben.

JSON-Darstellung
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Felder
userInclusionCriteria

object (UserSegmentCriteria)

Definiert, welche Nutzer in dieses Segment aufgenommen werden. Optional.

exclusion

object (UserSegmentExclusion)

Legt fest, welche Nutzer in diesem Segment ausgeschlossen werden. Optional.

NutzerSegmentkriterien

Ein Nutzer erfüllt ein Kriterium, wenn die Ereignisse des Nutzers die Bedingungen in dem Kriterium erfüllen.

JSON-Darstellung
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Felder
andConditionGroups[]

object (UserSegmentConditionGroup)

Ein Nutzer erfüllt diese Kriterien, wenn er jeder dieser andConditionGroups und jeder der andSequenceGroups erfüllt. andConditionGroups kann leer sein, wenn andSequenceGroups angegeben ist.

andSequenceGroups[]

object (UserSegmentSequenceGroup)

Ein Nutzer erfüllt diese Kriterien, wenn er jeder dieser andSequenceGroups und jeder der andConditionGroups erfüllt. andSequenceGroups kann leer sein, wenn andConditionGroups angegeben ist.

UserSegmentConditionGroup

Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.

JSON-Darstellung
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Felder
conditionScoping

enum (UserCriteriaScoping)

Die Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Gültigkeitsbereich wird definiert, über wie viele Ereignisse segmentFilterExpression ausgewertet wird, bevor eine Übereinstimmung mit der Bedingungsgruppe festgestellt wird. Bei conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION wird der Ausdruck beispielsweise für alle Ereignisse in einer Sitzung ausgewertet. Anschließend wird ermittelt, ob die Bedingungsgruppe für diesen Nutzer erfüllt oder nicht. Bei conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT wird der Ausdruck beispielsweise für ein einzelnes Ereignis ausgewertet. Anschließend wird ermittelt, ob die Bedingungsgruppe für diesen Nutzer erfüllt ist oder nicht.

Optional. Wenn nicht angegeben, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt.

Umfang der Nutzerkriterien

Der Umfang gibt an, welche Ereignisse bei der Bewertung, ob ein Nutzer ein Kriterium erfüllt, berücksichtigt werden.

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebener Kriterienumfang. Keine Angabe.
USER_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt der Nutzer die Kriterien.
USER_CRITERIA_WITHIN_SAME_SESSION Wenn die Kriterien innerhalb einer Sitzung erfüllt sind, erfüllt der Nutzer die Kriterien.
USER_CRITERIA_ACROSS_ALL_SESSIONS Wenn ein Ereignis die Kriterien für den Nutzer erfüllt, erfüllt der Nutzer die Kriterien.

SegmentFilterExpression

Drückt Kombinationen von Segmentfiltern aus.

JSON-Darstellung
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
Felder
Union-Feld expr. Geben Sie eine Filterart für SegmentFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (SegmentFilterExpressionList)

Die SegmentFilterExpression in andGroup hat eine AND-Beziehung.

orGroup

object (SegmentFilterExpressionList)

Die SegmentFilterExpression in orGroup hat eine OR-Beziehung.

notExpression

object (SegmentFilterExpression)

SegmentFilterExpression ist NICHT notExpression.

segmentFilter

object (SegmentFilter)

Ein einfacher Segmentfilter.

segmentEventFilter

object (SegmentEventFilter)

Erstellt einen Filter, der Ereignisse eines einzelnen Ereignisnamens zurückgibt. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.

SegmentFilterExpressionList

Eine Liste mit Segmentfilterausdrücken.

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

object (SegmentFilterExpression)

Die Liste der Segmentfilterausdrücke

Segmentfilter

Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.

JSON-Darstellung
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Felder
fieldName

string

Name der Dimension oder des Messwerts

filterScoping

object (SegmentFilterScoping)

Gibt den Umfang für den Filter an.

Union-Feld one_filter. Geben Sie eine Filterart für Filter an. Für one_filter ist nur einer der folgenden Werte zulässig:
stringFilter

object (StringFilter)

Filter in Bezug auf Strings.

inListFilter

object (InListFilter)

Ein Filter für Listenwerte.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

Segmentfilter

Über Bereiche legen Sie fest, wie die Dimensionen und Messwerte mehrerer Ereignisse bei der Auswertung eines Segmentfilters berücksichtigt werden.

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

boolean

Wenn atAnyPointInTime auf „true“ gesetzt ist, wird der Filter für alle Ereignisse als „true“ ausgewertet, wenn für jedes Ereignis im Zeitraum der Anfrage „true“ ausgegeben wird.

Durch diesen atAnyPointInTime-Parameter wird der Zeitraum der Ereignisse im Bericht nicht erweitert. Wenn atAnyPointInTime „true“ ist, werden bei der Auswertung dieses Filters nur Ereignisse innerhalb des Berichtszeitraums berücksichtigt.

Diese atAnyPointInTime kann nur angegeben werden, wenn der Kriteriumsbereich ACROSS_ALL_SESSIONS ist und nicht in Sequenzen angegeben werden kann.

Wenn der Kriterienumfang ACROSS_ALL_SESSIONS ist, wird atAnyPointInTime = „false“ verwendet, falls nicht angegeben.

SegmentEventFilter

Erstellt einen Filter, der Ereignisse eines einzelnen Ereignisnamens zurückgibt. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.

JSON-Darstellung
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Felder
eventName

string

Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich.

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Wenn angegeben, werden mit diesem Filter Ereignisse abgeglichen, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.

Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar.

SegmentParameterFilterExpression

Drückt Kombinationen des Segmentfilters für Parameter aus.

JSON-Darstellung
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Felder
Union-Feld expr. Geben Sie eine Filterart für SegmentParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression in andGroup hat eine AND-Beziehung.

orGroup

object (SegmentParameterFilterExpressionList)

Die SegmentParameterFilterExpression in orGroup hat eine OR-Beziehung.

notExpression

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression ist NICHT notExpression.

segmentParameterFilter

object (SegmentParameterFilter)

Ein einfacher Segmentparameter-Filter.

SegmentParameterFilterExpressionList

Eine Liste mit Segmentparameter-Filterausdrücken.

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

object (SegmentParameterFilterExpression)

Die Liste der Filterausdrücke für Segmentparameter.

SegmentParameterFilter

Ein Ausdruck zum Filtern von Parameterwerten in einem Segment.

JSON-Darstellung
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Felder
filterScoping

object (SegmentParameterFilterScoping)

Gibt den Umfang für den Filter an.

Union-Feld one_parameter. Das Feld, das gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig:
eventParameterName

string

Dieser Filter wird anhand des angegebenen Ereignisparameters ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Ereignisparameter umfassen Felder wie „firebase_screen“ und „currency“.

Ereignisparameter können nur in Segmenten und Trichtern und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden.

itemParameterName

string

Dieser Filter wird anhand des angegebenen „item“-Parameters ausgewertet. Artikelparameter werden als Parameter im Element-Array protokolliert. Zu den Artikelparametern gehören Felder wie „item_name“ und „item_category“.

Artikelparameter können nur in Segmenten und Trichtern und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden.

Artikelparameter sind nur für E-Commerce-Ereignisse verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie im Leitfaden E-Commerce messen.

Union-Feld one_filter. Geben Sie einen Filtertyp an. Für one_filter ist nur einer der folgenden Werte zulässig:
stringFilter

object (StringFilter)

Filter in Bezug auf Strings.

inListFilter

object (InListFilter)

Ein Filter für Listenwerte.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

SegmentParameterFilterScoping

Mit Bereichsparametern wird festgelegt, wie mehrere Ereignisse bei der Auswertung eines Segmentparameterfilters berücksichtigt werden.

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

string (int64 format)

Kumuliert den Parameter über den angegebenen Zeitraum von Tagen, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Kriterienumfang ACROSS_ALL_SESSIONS oder WITHIN_SAME_SESSION ist. Wird nur unterstützt, wenn der Parameter event_count ist.

Beispiel: Wenn inAnyNDayPeriod den Wert „3“ hat, der „eventName“ „purchase“, der Ereignisparameter „event_count“ und das Filterkriterium größer als 5 ist, wird mit diesem Filter die Ereignisanzahl der Kaufereignisse im Berichtszeitraum an drei aufeinanderfolgenden Tagen erfasst. Ein Nutzer erfüllt die Kriterien dieses Filters, um in dieses Segment aufgenommen zu werden, wenn seine Anzahl an Kaufereignissen innerhalb von drei aufeinanderfolgenden Tagen größer als 5 ist. Dabei werden beispielsweise die Zeiträume 2021-11-01 bis 2021-11-03, 2021-11-04 bis 2021-11-04, 2021-11-05 bis 2021-11-05 usw. berücksichtigt.

Der Zeitraum wird nicht erweitert, um ein volles N-Tage-Fenster kurz vor Beginn des Zeitraums zu haben. Wenn ein Bericht beispielsweise für den Zeitraum vom 01.11.2021 bis zum 10.11.2021 und inAnyNDayPeriod = 3 erstellt wird, wird der Zeitraum von zwei Tagen faktisch verkürzt, da keine Ereignisdaten außerhalb des Berichtszeitraums gelesen werden. Beispiel: Die ersten vier Zeiträume lauten 2021-11-01 bis 2021-11-01, 2021-11-02, 2021-11-01 bis 2021-11-03 und 2021-11-02 bis 2.

inAnyNDayPeriod ist optional. Wenn nicht angegeben, wird segmentParameterFilter auf jedes Ereignis einzeln angewendet.

NutzerSegmentSequenzgruppe

Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge auftreten müssen, damit der User Mitglied beim Segment wird.

JSON-Darstellung
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
Felder
sequenceScoping

enum (UserCriteriaScoping)

Alle Sequenzschritte müssen im Bereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Beispiel: Bei sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION müssen alle Sequenzschritte innerhalb einer Sitzung abgeschlossen werden, damit der Nutzer der Sequenz entspricht. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT wird nicht unterstützt.

Optional. Wenn nicht angegeben, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.

sequenceMaximumDuration

string (Duration format)

Definiert den Zeitraum, in dem die gesamte Sequenz stattfinden muss, z. B. 30 Minuten. sequenceMaximumDuration umfasst den Endpunkt im Detaillierungsgrad von Mikrosekunden. Eine Sequenz mit einer maximalen Dauer von 5 Sekunden kann beispielsweise nach 4,9 oder 5 Sekunden abgeschlossen werden, aber nicht nach 5 Sekunden und 1 Mikrosekunde.

sequenceMaximumDuration ist optional. Wenn nicht angegeben, können Sequenzen in einem beliebigen Zeitraum abgeschlossen werden.

Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

userSequenceSteps[]

object (UserSequenceStep)

Eine geordnete Abfolge von Bedingungsschritten. Die Ereignisse eines Nutzers müssen alle Schritte abschließen, damit der Nutzer dem UserSegmentSequenceGroup entspricht.

UserSequenceStep

Eine Bedingung, die in der angegebenen Schrittreihenfolge eintreten muss, damit dieser Nutzer der Sequenz entspricht.

JSON-Darstellung
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Felder
isDirectlyFollowedBy

boolean

Bei „true“ muss das Ereignis, das diesen Schritt erfüllt, das nächste Ereignis nach dem Ereignis sein, das den letzten Schritt erfüllt. Bei „false“ folgt dieser Schritt indirekt dem vorherigen Schritt. Beispielsweise können zwischen dem vorherigen und diesem Schritt Ereignisse auftreten. isDirectlyFollowedBy muss für den ersten Schritt „false“ sein.

stepScoping

enum (UserCriteriaScoping)

Dieser Sequenzschritt muss im Bereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Beispiel: Bei sequenceScoping = WITHIN_SAME_SESSION müssen diese Sequenzschritte innerhalb einer Sitzung abgeschlossen werden, damit der Nutzer der Sequenz entspricht. stepScoping = ACROSS_ALL_SESSIONS ist nur zulässig, wenn sequenceScoping = ACROSS_ALL_SESSIONS.

Optional. Wenn nicht angegeben, verwendet stepScoping denselben UserCriteriaScoping wie sequenceScoping.

segmentFilterExpression

object (SegmentFilterExpression)

Ein Nutzer stimmt mit diesem Sequenzschritt überein, wenn seine Ereignisse mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt.

Ausschluss von Nutzersegmenten

Gibt an, welche Nutzer in diesem Segment ausgeschlossen werden.

JSON-Darstellung
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Felder
userExclusionDuration

enum (UserExclusionDuration)

Gibt an, wie lange ein Ausschluss gelten soll, wenn ein Nutzer mit userExclusionCriteria übereinstimmt.

Optional. Wenn nicht angegeben, wird userExclusionDuration von USER_EXCLUSION_TEMPORARY verwendet.

userExclusionCriteria

object (UserSegmentCriteria)

Erfüllt ein Nutzer diese Bedingung, wird er von der Mitgliedschaft im Segment für userExclusionDuration ausgeschlossen.

NutzerAusschlussdauer

Listet Optionen auf, die bestimmen, wie lange ein Ausschluss bestehen bleibt, wenn ein Nutzer mit userExclusionCriteria übereinstimmt.

Enums
USER_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Keine Angabe.
USER_EXCLUSION_TEMPORARY Nutzer vorübergehend aus dem Segment ausschließen, wenn sie die Bedingung userExclusionCriteria erfüllen.
USER_EXCLUSION_PERMANENT Nutzer, die die Bedingung userExclusionCriteria erfüllen, werden dauerhaft aus dem Segment ausgeschlossen.

Sitzungssegment

Sitzungssegmente sind Teilmengen der Sitzungen, die auf Ihrer Website oder in Ihrer App stattgefunden haben: etwa alle Sitzungen, die aus einer bestimmten Werbekampagne stammen.

JSON-Darstellung
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Felder
sessionInclusionCriteria

object (SessionSegmentCriteria)

Legt fest, welche Sitzungen in diesem Segment enthalten sind. Optional.

exclusion

object (SessionSegmentExclusion)

Legt fest, welche Sitzungen in diesem Segment ausgeschlossen werden. Optional.

SitzungSegmentkriterien

Eine Sitzung entspricht einem Kriterium, wenn die darin enthaltenen Ereignisse die Bedingungen in den Kriterien erfüllen.

JSON-Darstellung
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Felder
andConditionGroups[]

object (SessionSegmentConditionGroup)

Eine Sitzung entspricht diesen Kriterien, wenn sie jedem dieser andConditionGroups entspricht.

SessionSegmentConditionGroup

Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.

JSON-Darstellung
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Felder
conditionScoping

enum (SessionCriteriaScoping)

Die Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Gültigkeitsbereich wird definiert, über wie viele Ereignisse segmentFilterExpression ausgewertet wird, bevor eine Übereinstimmung mit der Bedingungsgruppe festgestellt wird. Bei conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION wird der Ausdruck beispielsweise für alle Ereignisse in einer Sitzung ausgewertet. Anschließend wird ermittelt, ob die Bedingungsgruppe für diese Sitzung erfüllt ist oder nicht. Bei conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT wird der Ausdruck beispielsweise für ein einzelnes Ereignis ausgewertet. Anschließend wird ermittelt, ob die Bedingungsgruppe für diese Sitzung erfüllt ist oder nicht.

Optional. Wenn kein Wert angegeben ist, wird WITHIN_SAME_SESSION als conditionScoping verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt.

Sitzungskriterienbereich

Der Umfang gibt an, welche Ereignisse bei der Bewertung, ob eine Sitzung ein Kriterium erfüllt, berücksichtigt werden.

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebener Kriterienumfang. Keine Angabe.
SESSION_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt die Sitzung die Kriterien.
SESSION_CRITERIA_WITHIN_SAME_SESSION Wenn die Kriterien innerhalb einer Sitzung erfüllt werden, erfüllt die Sitzung die Kriterien.

Sitzung –Segmentausschluss

Gibt an, welche Sitzungen in diesem Segment ausgeschlossen werden.

JSON-Darstellung
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Felder
sessionExclusionDuration

enum (SessionExclusionDuration)

Gibt an, wie lange ein Ausschluss gelten soll, wenn eine Sitzung mit dem sessionExclusionCriteria übereinstimmt.

Optional. Wenn kein Wert angegeben ist, wird SESSION_EXCLUSION_TEMPORARY als sessionExclusionDuration verwendet.

sessionExclusionCriteria

object (SessionSegmentCriteria)

Erfüllt eine Sitzung diese Bedingung, wird sie von der Mitgliedschaft im Segment für sessionExclusionDuration ausgeschlossen.

Dauer des Sitzungsausschlusses

Listet Optionen für die Dauer eines Ausschlusses auf, wenn eine Sitzung mit dem sessionExclusionCriteria übereinstimmt.

Enums
SESSION_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Keine Angabe.
SESSION_EXCLUSION_TEMPORARY Sitzungen aus dem Segment vorübergehend ausschließen, wenn die Sitzung die Bedingung sessionExclusionCriteria erfüllt.
SESSION_EXCLUSION_PERMANENT Sitzungen aus dem Segment werden dauerhaft ausgeschlossen, wenn sie die Bedingung sessionExclusionCriteria erfüllen.

Ereignissegment

Ereignissegmente sind Teilmengen von Ereignissen, die auf Ihrer Website oder in Ihrer App ausgelöst wurden, z. B. alle Kaufereignisse an einem bestimmten Standort oder „app_exception“-Ereignisse, die unter einem bestimmten Betriebssystem aufgetreten sind.

JSON-Darstellung
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Felder
eventInclusionCriteria

object (EventSegmentCriteria)

Definiert, welche Ereignisse in diesem Segment enthalten sind. Optional.

exclusion

object (EventSegmentExclusion)

Legt fest, welche Ereignisse in diesem Segment ausgeschlossen werden. Optional.

EventSegmentCriteria

Ein Ereignis entspricht einem Kriterium, wenn es die darin enthaltenen Bedingungen erfüllt.

JSON-Darstellung
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Felder
andConditionGroups[]

object (EventSegmentConditionGroup)

Ein Ereignis entspricht diesen Kriterien, wenn es jedem dieser andConditionGroups entspricht.

EventSegmentConditionGroup

Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.

JSON-Darstellung
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Felder
conditionScoping

enum (EventCriteriaScoping)

conditionScoping sollte immer EVENT_CRITERIA_WITHIN_SAME_EVENT sein.

Optional. Wenn kein Wert angegeben ist, wird EVENT_CRITERIA_WITHIN_SAME_EVENT als conditionScoping verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt.

EventCriteriaScoping

Mit der Bereichsdefinition legen Sie fest, welche Ereignisse bei der Beurteilung berücksichtigt werden, ob ein Ereignis ein Kriterium erfüllt.

Enums
EVENT_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebener Kriterienumfang. Keine Angabe.
EVENT_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt es auch die Kriterien.

EventSegmentAusschluss

Gibt an, welche Ereignisse in diesem Segment ausgeschlossen werden.

JSON-Darstellung
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Felder
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration sollte immer PERMANENTLY_EXCLUDE sein.

Optional. Wenn kein Wert angegeben ist, wird EVENT_EXCLUSION_PERMANENT als eventExclusionDuration verwendet.

eventExclusionCriteria

object (EventSegmentCriteria)

Wenn ein Ereignis diese Bedingung erfüllt, wird es von der Mitgliedschaft im Segment für eventExclusionDuration ausgeschlossen.

EventAusschlussDauer

Aufzählung der Optionen für die Dauer eines Ausschlusses, wenn ein Ereignis mit eventExclusionCriteria übereinstimmt

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Keine Angabe.
EVENT_EXCLUSION_PERMANENT Ereignisse aus dem Segment dauerhaft ausschließen, falls sie die Bedingung eventExclusionCriteria erfüllen.

FilterExpression

Zum Ausdruck von Dimensions- oder Messwertfiltern. Die Felder in derselben FilterExpression müssen entweder alle Dimensionen oder alle Messwerte enthalten.

JSON-Darstellung
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Felder
Union-Feld expr. Geben Sie eine Art von Filterausdruck für FilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
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)

FilterExpression ist NICHT "notExpression".

filter

object (Filter)

Ein einfacher Filter. In derselben FilterExpression müssen alle Feldnamen des Filters entweder alle Dimensionen oder alle Messwerte sein.

FilterExpressionList

Eine Liste mit Filterausdrücken.

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

object (FilterExpression)

Eine Liste mit Filterausdrücken.

Filter

Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.

JSON-Darstellung
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Felder
fieldName

string

Name der Dimension oder des Messwerts Muss ein in Dimensionen oder Messwerten definierter Name sein.

Union-Feld one_filter. Geben Sie eine Filterart für Filter an. Für one_filter ist nur einer der folgenden Werte zulässig:
stringFilter

object (StringFilter)

Filter in Bezug auf Strings.

inListFilter

object (InListFilter)

Ein Filter für Listenwerte.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

Trichterunterbericht

Trichter-Unterberichte enthalten die Dimensions- und Messwertdatenwerte. Beispielsweise haben 12 Nutzer den zweiten Schritt des Trichters erreicht.

JSON-Darstellung
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Felder
dimensionHeaders[]

object (DimensionHeader)

Beschreibt Dimensionsspalten. Trichterberichte enthalten in Antworten auf Teilberichte immer die Dimension „Trichterschritt“. In der Antwort können auf Anfrage zusätzliche Dimensionen wie Aufschlüsselungen, Daten und nächste Aktionen enthalten sein.

metricHeaders[]

object (MetricHeader)

Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in Antworten von Teilberichten. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussrate, Ausstiege und Ausstiegsrate.

rows[]

object (Row)

Zeilen mit Kombinationen aus Dimensionswerten und Messwerten im Bericht.

metadata

object (FunnelResponseMetadata)

Metadaten für den Trichterbericht.

DimensionHeader

Beschreibt eine Dimensionsspalte im Bericht. In einem Bericht angeforderte Dimensionen erzeugen Spalteneinträge in Zeilen und DimensionHeaders. Dimensionen, die ausschließlich in Filtern oder Ausdrücken verwendet werden, generieren jedoch keine Spalten in einem Bericht. Daher werden für diese Dimensionen auch keine Überschriften angezeigt.

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

string

Der Name der Dimension

MetricHeader

Beschreibt eine Messwertspalte im Bericht. Sichtbare Messwerte, die in einem Bericht angefordert werden, erzeugen Spalteneinträge in Zeilen und MetricHeaders. Für Messwerte, die ausschließlich in Filtern oder Ausdrücken verwendet werden, werden jedoch keine Spalten in einem Bericht erzeugt. Daher werden für diese Messwerte auch keine Überschriften erzeugt.

JSON-Darstellung
{
  "name": string,
  "type": enum (MetricType)
}
Felder
name

string

Der Name des Messwerts.

type

enum (MetricType)

Der Datentyp des Messwerts.

MetricType

Der Werttyp eines Messwerts.

Enums
METRIC_TYPE_UNSPECIFIED Nicht definierter Typ.
TYPE_INTEGER Ganzzahltyp.
TYPE_FLOAT Gleitkommatyp.
TYPE_SECONDS Eine Dauer von Sekunden (ein spezieller Gleitkommatyp).
TYPE_MILLISECONDS Dauer in Millisekunden; ein spezieller Gleitkommatyp
TYPE_MINUTES Dauer in Minuten; ein spezieller Gleitkommatyp
TYPE_HOURS Dauer in Stunden; ein spezieller Gleitkommatyp
TYPE_STANDARD Ein benutzerdefinierter Messwert vom Typ „Standard“; ein spezieller Gleitkommatyp
TYPE_CURRENCY Ein Geldbetrag; ein spezieller Gleitkommatyp.
TYPE_FEET Eine Länge in Fuß; ein spezieller Gleitkommatyp.
TYPE_MILES Eine Länge in Meilen; ein spezieller Gleitkommatyp.
TYPE_METERS Eine Länge in Metern; ein spezieller Gleitkommatyp.
TYPE_KILOMETERS Eine Länge in Kilometern; ein spezieller Gleitkommatyp

Row

Berichtsdaten für jede Zeile. Wenn RunReportRequest beispielsweise Folgendes enthält:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

Eine Zeile mit „in_app_purchase“ als „eventName“, „JP“ als countryId und „15“ als „eventCount“:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
JSON-Darstellung
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Felder
dimensionValues[]

object (DimensionValue)

Liste der angeforderten Dimensionswerte. In einem PivotReport werden dimensionsValues nur für Dimensionen aufgelistet, die in einem Pivot enthalten sind.

metricValues[]

object (MetricValue)

Liste der angeforderten sichtbaren Messwerte.

DimensionValue

Der Wert einer Dimension.

JSON-Darstellung
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Felder
Union-Feld one_value. Für den Dimensionswert one_value ist nur einer der folgenden Werte zulässig:
value

string

Wert als String, wenn der Dimensionstyp ein String ist.

MetricValue

Der Wert eines Messwerts.

JSON-Darstellung
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Felder
Union-Feld one_value. Einer der folgenden Messwerte ist für den Messwert one_value zulässig:
value

string

Messwert Informationen zum Typ finden Sie unter MetricHeader.

FunnelResponseMetadata

Die Antwortmetadaten des Trichterberichts enthalten zusätzliche Informationen zum Trichterbericht.

JSON-Darstellung
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Felder
samplingMetadatas[]

object (SamplingMetadata)

Falls es sich bei den Ergebnissen des Trichterberichts um Stichproben handelt, ist hier der Prozentsatz der Ereignisse angegeben, der im Trichterbericht verwendet wurde. Für jeden Zeitraum wird ein samplingMetadatas ausgefüllt. Jeder samplingMetadatas entspricht einem Zeitraum in der Reihenfolge, in der die Zeiträume in der Anfrage angegeben wurden.

Wenn die Ergebnisse jedoch nicht auf Stichproben basieren, wird dieses Feld nicht definiert.

SamplingMetadata

Falls es sich bei den Ergebnissen des Trichterberichts um Stichproben handelt, geben diese Metadaten an, welcher Prozentsatz der Ereignisse in diesem Trichterbericht für einen Zeitraum verwendet wurde. Als Stichprobenerhebung wird eine Teilmenge aller Daten analysiert, um aussagekräftige Informationen in einem größeren Dataset zu erhalten.

JSON-Darstellung
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
Felder
samplesReadCount

string (int64 format)

Die Gesamtzahl der in diesem Stichprobenbericht gelesenen Ereignisse für einen Zeitraum. Die Größe der Teilmenge der Daten dieser Property, die in diesem Trichterbericht analysiert wurde.

samplingSpaceSize

string (int64 format)

Die Gesamtzahl der Ereignisse in den Daten dieser Property, die in diesem Trichterbericht für einen Zeitraum hätten analysiert werden können. Durch Stichprobenerhebung werden aussagekräftige Informationen über das größere Dataset ermittelt. Dies ist die Größe des größeren Datasets.

Um den Prozentsatz der verfügbaren Daten zu berechnen, der in diesem Trichterbericht verwendet wurde, berechnen Sie samplesReadCount/samplingSpaceSize.

PropertyQuota

Aktueller Status aller Kontingente für diese Analytics-Property. Wenn ein Kontingent für ein Attribut erschöpft ist, wird bei allen Anfragen an dieses Attribut der Fehler „Ressource erschöpft“ zurückgegeben.

JSON-Darstellung
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
Felder
tokensPerDay

object (QuotaStatus)

Für Standard-Analytics-Properties sind bis zu 200.000 Tokens pro Tag und für Analytics 360-Properties bis zu 2.000.000 Tokens pro Tag möglich. Die meisten Anfragen benötigen weniger als 10 Tokens.

tokensPerHour

object (QuotaStatus)

Für Standard-Analytics-Properties sind bis zu 40.000 Tokens pro Stunde und für Analytics 360-Properties bis zu 400.000 Tokens pro Stunde möglich. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen Stundenkontingenten pro Stunde, Tag und Projekt abgezogen wird.

concurrentRequests

object (QuotaStatus)

Standard-Analytics-Properties können bis zu 10 gleichzeitige Anfragen senden. Analytics 360-Properties können bis zu 50 gleichzeitige Anfragen verwenden.

serverErrorsPerProjectPerHour

object (QuotaStatus)

Standardmäßige Paare von Analytics-Properties und Cloud-Projekten können bis zu 10 Serverfehler pro Stunde enthalten. Paare aus Analytics 360-Properties und Cloud-Projekten können bis zu 50 Serverfehler pro Stunde enthalten.

potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Analytics-Properties können bis zu 120 Anfragen mit Dimensionen pro Stunde senden, für die möglicherweise Grenzwerte festgelegt wurden. In einer Batchanfrage wird jede Berichtsanfrage für dieses Kontingent einzeln gezählt, wenn die Anfrage Dimensionen mit potenziell Grenzwerten enthält.

tokensPerProjectPerHour

object (QuotaStatus)

In Analytics-Properties können bis zu 35% der Tokens pro Projekt und Stunde verwendet werden. Das bedeutet, dass Standard-Analytics-Properties bis zu 14.000 Tokens pro Projekt und Stunde und Analytics 360-Properties 140.000 Tokens pro Projekt und Stunde verwenden können. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen Stundenkontingenten pro Stunde, Tag und Projekt abgezogen wird.

QuotaStatus

Aktueller Status einer bestimmten Kontingentgruppe.

JSON-Darstellung
{
  "consumed": integer,
  "remaining": integer
}
Felder
consumed

integer

Von dieser Anfrage verbrauchtes Kontingent.

remaining

integer

Nach dieser Anfrage verbleibendes Kontingent.