Method: properties.runFunnelReport

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

{
  "startDate": string,
  "endDate": string,
  "name": string
}

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.

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.

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.

{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}

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.

object (FunnelStep)

Die sequenziellen Schritte dieses Trichters.

{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}

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.

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.

object (FunnelFilterExpression)

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

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".

{

  // 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.
}

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in andGroup hat eine AND-Beziehung.

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in orGroup hat eine OR-Beziehung.

object (FunnelFilterExpression)

FunnelFilterExpression ist NICHT notExpression.

object (FunnelFieldFilter)

Ein Trichterfilter für eine Dimension oder einen Messwert.

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.

{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}

object (FunnelFilterExpression)

Die Liste der Trichterfilterausdrücke.

{
  "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.
}

string

Name der Dimension oder des Messwerts

object (StringFilter)

Filter in Bezug auf Strings.

object (InListFilter)

Ein Filter für Listenwerte.

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

object (BetweenFilter)

Ein Filter für zwei Werte.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

Die Keyword-Option für diesen Filter.

string

Der für den Abgleich verwendete Stringwert.

boolean

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

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

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

boolean

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

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

Der Vorgangstyp für diesen Filter.

object (NumericValue)

Ein numerischer Wert oder ein Datumswert.

{

  // 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.
}

string (int64 format)

Ganzzahlwert

number

Doppelter Wert

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

Beginnt mit dieser Zahl.

object (NumericValue)

Endet mit dieser Nummer.

{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}

string

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

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.

{

  // 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.
}

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression ist NICHT von notExpression.

object (FunnelParameterFilter)

Ein einfacher Trichterparameterfilter.

{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}

object (FunnelParameterFilterExpression)

Die Liste der Filterausdrücke für Trichterparameter.

{

  // 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.
}

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.

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.

object (StringFilter)

Filter in Bezug auf Strings.

object (InListFilter)

Ein Filter für Listenwerte.

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

object (BetweenFilter)

Ein Filter für zwei Werte.

{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}

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.

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.

{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}

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.

object (DimensionExpression)

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

{

  // 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.
}

object (CaseExpression)

Damit wird ein Dimensionswert in Kleinbuchstaben umgewandelt.

object (CaseExpression)

Damit wird ein Dimensionswert in Großbuchstaben umgewandelt.

object (ConcatenateExpression)

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

{
  "dimensionName": string
}

string

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

{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}

string

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

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“.

{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}

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.

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.

{
  "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.
}

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.).

object (UserSegment)

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

object (SessionSegment)

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

object (EventSegment)

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

{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}

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.

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.

{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

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.

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.

{

  // 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.
}

object (SegmentFilterExpressionList)

Die SegmentFilterExpression in andGroup hat eine AND-Beziehung.

object (SegmentFilterExpressionList)

Die SegmentFilterExpression in orGroup hat eine OR-Beziehung.

object (SegmentFilterExpression)

SegmentFilterExpression ist NICHT notExpression.

object (SegmentFilter)

Ein einfacher Segmentfilter.

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.

{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}

object (SegmentFilterExpression)

Die Liste der Segmentfilterausdrücke

{
  "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.
}

string

Name der Dimension oder des Messwerts

object (SegmentFilterScoping)

Gibt den Umfang für den Filter an.

object (StringFilter)

Filter in Bezug auf Strings.

object (InListFilter)

Ein Filter für Listenwerte.

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

object (BetweenFilter)

Ein Filter für zwei Werte.

{
  "atAnyPointInTime": boolean
}

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.

{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}

string

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

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.

{

  // 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.
}

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression in andGroup hat eine AND-Beziehung.

object (SegmentParameterFilterExpressionList)

Die SegmentParameterFilterExpression in orGroup hat eine OR-Beziehung.

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression ist NICHT notExpression.

object (SegmentParameterFilter)

Ein einfacher Segmentparameter-Filter.

{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}

object (SegmentParameterFilterExpression)

Die Liste der Filterausdrücke für Segmentparameter.

{
  "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.
}

object (SegmentParameterFilterScoping)

Gibt den Umfang für den Filter an.

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.

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.

object (StringFilter)

Filter in Bezug auf Strings.

object (InListFilter)

Ein Filter für Listenwerte.

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

object (BetweenFilter)

Ein Filter für zwei Werte.

{
  "inAnyNDayPeriod": string
}

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.

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

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.

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".

object (UserSequenceStep)

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

{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

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.

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.

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.

{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}

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.

object (UserSegmentCriteria)

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

{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}

object (SessionSegmentCriteria)

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

object (SessionSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}

object (SessionSegmentConditionGroup)

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

{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

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.

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.

{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}

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.

object (SessionSegmentCriteria)

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

{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}

object (EventSegmentCriteria)

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

object (EventSegmentExclusion)

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

{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}

object (EventSegmentConditionGroup)

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

{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

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.

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.

{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}

enum (EventExclusionDuration)

eventExclusionDuration sollte immer PERMANENTLY_EXCLUDE sein.

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

object (EventSegmentCriteria)

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

{

  // 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.
}

object (FilterExpressionList)

Die FilterExpressions in andGroup haben eine AND-Beziehung.

object (FilterExpressionList)

Die FilterExpressions in orGroup haben eine OR-Beziehung.

object (FilterExpression)

FilterExpression ist NICHT "notExpression".

object (Filter)

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

{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}

object (FilterExpression)

Eine Liste mit Filterausdrücken.

{
  "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.
}

string

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

object (StringFilter)

Filter in Bezug auf Strings.

object (InListFilter)

Ein Filter für Listenwerte.

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

object (BetweenFilter)

Ein Filter für zwei Werte.

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

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.

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.

object (Row)

Zeilen mit Kombinationen aus Dimensionswerten und Messwerten im Bericht.

object (FunnelResponseMetadata)

Metadaten für den Trichterbericht.

{
  "name": string
}

string

Der Name der Dimension

{
  "name": string,
  "type": enum (MetricType)
}

string

Der Name des Messwerts.

enum (MetricType)

Der Datentyp des Messwerts.

{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}

object (DimensionValue)

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

object (MetricValue)

Liste der angeforderten sichtbaren Messwerte.

{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}

string

Wert als String, wenn der Dimensionstyp ein String ist.

{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}

string

Messwert Informationen zum Typ finden Sie unter MetricHeader.

{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}

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.

{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}

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.

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.

{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}

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.

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.

object (QuotaStatus)

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

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.

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.

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.

{
  "consumed": integer,
  "remaining": integer
}

integer

Von dieser Anfrage verbrauchtes Kontingent.

integer

Nach dieser Anfrage verbleibendes Kontingent.