Method: properties.runFunnelReport

Gibt einen benutzerdefinierten Trichterbericht Ihrer 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. Wenn Sie Feedback zu dieser API geben möchten, füllen Sie bitte das Formular für Feedback zu Trichterberichten in der Google Analytics Data API aus.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
property

string

Optional. Die ID einer Google Analytics-Property, deren Ereignisse erfasst werden. Im URL-Pfad und nicht im Text angegeben. Weitere Informationen In einer Batchanfrage sollte diese Property entweder nicht angegeben werden oder mit der Property 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)

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

funnel

object (Funnel)

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

funnelBreakdown

object (FunnelBreakdown)

Optional. Falls angegeben, wird durch diese Aufschlüsselung der Antwort des Unterberichts für die Trichtertabelle eine Dimension hinzugefügt. Mit dieser Aufschlüsselungsdimension wird jeder Schritt im Trichter auf die eindeutigen Werte der Aufschlüsselungsdimension erweitert. Wenn Sie beispielsweise eine Aufschlüsselung nach der Dimension deviceCategory erstellen, werden Zeilen für mobile, tablet, desktop und die Gesamtsumme erstellt.

funnelNextAction

object (FunnelNextAction)

Optional. Falls angegeben, wird mit der nächsten Aktion eine Dimension der Antwort des Unterberichts für die Trichtervisualisierung hinzugefügt. Mit dieser Dimension wird jeder Schritt im Trichter auf die eindeutigen Werte der nächsten Aktion erweitert. Wenn Sie beispielsweise die nächste Aktion der Dimension eventName verwenden, werden Zeilen für mehrere Ereignisse (z. B. session_start und click) und die Summe erstellt.

„Nächste Aktion“ unterstützt nur eventName und die meisten Seiten-/Bildschirmdimensionen wie pageTitle und pagePath.

funnelVisualizationType

enum (FunnelVisualizationType)

Optional. Mit dem Visualisierungstyp „Trichter“ werden die Dimensionen gesteuert, die in der Antwort des Unterberichts für die Trichtervisualisierung enthalten sind. Falls nichts angegeben wird, wird STANDARD_FUNNEL verwendet.

segments[]

object (Segment)

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

Für jedes in dieser Anfrage angegebene Segment wird in der Antwort eine separate Zeile erstellt. In der Antwort wird jedes Segment anhand seines Namens identifiziert.

Der Parameter „segments“ ist optional. Anfragen sind auf vier Segmente beschränkt.

limit

string (int64 format)

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

Die API kann auch weniger Zeilen als die angeforderten limit zurückgeben, wenn es nicht so viele Dimensionswerte wie die limit gibt.

dimensionFilter

object (FilterExpression)

Optional. Mit Dimensionsfiltern können Sie nur bestimmte Dimensionswerte im Bericht abrufen. Weitere Informationen finden Sie unter Bericht erstellen: Dimensionsfilter. Messwerte können in diesem Filter nicht verwendet werden.

returnPropertyQuota

boolean

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

Antworttext

Die Antwort des Trichterberichts enthält zwei Unterberichte. Die beiden Unterberichte enthalten unterschiedliche Kombinationen aus 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 mit dem Schritt im Trichter, dem Segment, der Aufschlüsselungsdimension, den aktiven Nutzern, der Abschlussrate, den Abbrüchen und der Abbruchrate.

Die Segmentdimension ist in dieser Antwort nur 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 den Dimensionen „Schritt im Trichter“, „Segment“, „Datum“, „Nächste Aktion“ und „Aktive Nutzer“.

Die Segmentdimension ist in dieser Antwort nur 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 in der Antwort enthalten, 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 es sich bei dieser Nachricht handelt. kind ist immer der feste String „analyticsData#runFunnelReport“. Nützlich, 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

Trichter

Konfiguriert den Trichter in einer Trichterberichts-Anfrage. In einem Trichterbericht werden Nutzer erfasst, während sie eine Reihe von Schritten durchlaufen.

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

Bei einem offenen Trichter können Nutzer den Trichter an einem beliebigen Punkt betreten. Bei einem geschlossenen Trichter müssen Nutzer den Trichter im ersten Schritt betreten. Optional. Wenn nichts angegeben ist, wird ein geschlossener Trichter verwendet.

steps[]

object (FunnelStep)

Die sequenziellen Schritte dieses Trichters.

FunnelStep

Mit Schritten wird der Kaufprozess definiert, den Sie analysieren möchten. Schritte enthalten eine oder mehrere Bedingungen, die ein Nutzer erfüllen muss, um bei diesem Schritt im Trichter berücksichtigt zu werden.

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

string

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

isDirectlyFollowedBy

boolean

Wenn „true“, muss dieser Schritt direkt auf den vorherigen Schritt folgen. Wenn „false“, kann es zwischen dem vorherigen und diesem Schritt Ereignisse geben. Wenn nicht angegeben, wird isDirectlyFollowedBy als „false“ behandelt.

filterExpression

object (FunnelFilterExpression)

Die Bedingung, die Ihre Nutzer erfüllen müssen, um bei diesem Schritt im Trichter berücksichtigt zu werden.

withinDurationFromPriorStep

string (Duration format)

Wenn angegeben, muss dieser Schritt innerhalb dieses Zeitraums nach Abschluss des vorherigen Schritts abgeschlossen werden. withinDurationFromPriorStep umfasst den Endpunkt mit Mikrosekundengenauigkeit. Eine Dauer von 5 Sekunden kann beispielsweise nach 4,9 oder 5,0 Sekunden abgeschlossen werden, aber nicht nach 5 Sekunden und 1 Mikrosekunde.

withinDurationFromPriorStep ist optional. Wenn nichts angegeben ist, können die Schritte durch einen beliebigen Zeitraum getrennt sein.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

FunnelFilterExpression

Kombinationen von Trichterfiltern.

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 einen Filtertyp für FunnelFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in andGroup haben eine UND-Beziehung.

orGroup

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in orGroup haben eine ODER-Beziehung.

notExpression

object (FunnelFilterExpression)

Der FunnelFilterExpression ist NICHT vom Typ notExpression.

funnelFieldFilter

object (FunnelFieldFilter)

Ein Trichterfilter für eine Dimension oder einen Messwert.

funnelEventFilter

object (FunnelEventFilter)

Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

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

Der 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 für Strings.

inListFilter

object (InListFilter)

Ein Filter für Werte in der Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für einen Bereich zwischen zwei Werten.

FunnelEventFilter

Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

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

string

Dieser Filter entspricht Ereignissen mit diesem einzelnen Ereignisnamen. Ereignisname erforderlich.

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

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

Im Parameterfilterausdruck sind nur Parameterfilter verfügbar.

FunnelParameterFilterExpression

Kombinationen von Trichterfiltern für Parameter.

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 einen Filtertyp für FunnelParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (FunnelParameterFilterExpressionList)

Die FunnelParameterFilterExpression in andGroup haben eine UND-Beziehung.

orGroup

object (FunnelParameterFilterExpressionList)

Die FunnelParameterFilterExpression in orGroup haben eine ODER-Beziehung.

notExpression

object (FunnelParameterFilterExpression)

Der FunnelParameterFilterExpression ist NICHT vom Typ notExpression.

funnelParameterFilter

object (FunnelParameterFilter)

Ein einfacher Trichterparameterfilter.

FunnelParameterFilterExpressionList

Eine Liste mit Filterausdrü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, nach dem gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig:
eventParameterName

string

Dieser Filter wird für den angegebenen Ereignisparameter ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Zu den Ereignisparametern gehören Felder wie „firebase_screen“ und „currency“.

Ereignisparameter können nur in Segmenten und Trichteranalysen verwendet werden und nur in einem untergeordneten Filter von einem EventFilter. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden.

itemParameterName

string

Dieser Filter wird anhand des angegebenen Artikelparameters ausgewertet. Artikelparameter werden als Parameter im Artikelarray protokolliert. Zu den Artikelparametern gehören Felder wie „item_name“ und „item_category“.

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

Artikelparameter sind nur in E-Commerce-Ereignissen 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 für Strings.

inListFilter

object (InListFilter)

Ein Filter für Werte in der Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für einen Bereich zwischen zwei Werten.

FunnelBreakdown

Durch Aufschlüsselungen wird der Antwort des Unterberichts für die Trichtertabelle eine Dimension hinzugefügt.

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

object (Dimension)

Die Dimensionenspalte, die der Antwort des Unterberichts für die Trichtertabelle hinzugefügt wurde. Die Aufschlüsselungsdimension schlüsselt jeden Schritt im Trichter auf. Ein gültiger breakdownDimension-Wert ist erforderlich, wenn funnelBreakdown angegeben ist.

limit

string (int64 format)

Die maximale Anzahl der unterschiedlichen Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird ein limit von 5 verwendet. Das Limit muss größer als null und darf nicht größer als 15 sein.

FunnelNextAction

Der Status „Nächste Aktionen“ gibt den Wert für eine Dimension an, nachdem der Nutzer einen Schritt ausgeführt hat, aber bevor er den nächsten Schritt ausführt. Wenn nextActionDimension beispielsweise eventName ist, wird mit nextActionDimension in der Zeile für den i. Schritt im Trichter das erste Ereignis nach dem Ereignis zurückgegeben, das den Nutzer für den i. Schritt im Trichter qualifiziert hat, aber bevor der Nutzer den i+1. Schritt im Trichter erreicht hat.

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

object (Dimension)

Die Dimensionenspalte, die der Antwort des Unterberichts für die 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-/Bildschirmdimensionen wie pageTitle und pagePath. nextActionDimension darf kein Dimensionsausdruck sein.

limit

string (int64 format)

Die maximale Anzahl der unterschiedlichen Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird ein limit von 5 verwendet. Das Limit muss größer als null und darf nicht größer als fünf sein.

FunnelVisualizationType

Steuert die Dimensionen, die in der Antwort des Unterberichts zur Trichtervisualisierung enthalten sind.

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nicht definierter Typ.
STANDARD_FUNNEL Ein Standardtrichter (mit Stufen). Der Unterbericht zur Trichtervisualisierung in der Antwort enthält kein Datum.
TRENDED_FUNNEL Ein Trichter mit Zeitverlauf (Liniendiagramm). Der Unterbericht zur Trichtervisualisierung in der Antwort enthält die Datumsdimension.

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

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 nichts angegeben wird, werden Segmente als „Segment“ bezeichnet. Dieser Name definiert den Stringwert, der von der Dimension segment zurückgegeben wird. Mit dem Dimensionspräfix segment wird den Segmentnamen die 1-basierte Indexnummer des Segments in der Anfrage vorangestellt, z. B. „1. Segment“ und „2. Segment“ usw.).

Union-Feld one_segment_scope. Ein Segment wird in einem Bereich 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.

UserSegment

Nutzersegmente sind Teilmengen von Nutzern, die bereits mit Ihrer Website oder App interagiert haben. Sie können einen Kauf abgeschlossen oder Artikel in den Einkaufswagen gelegt haben, ohne einen Kauf abzuschließen.

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

object (UserSegmentCriteria)

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

exclusion

object (UserSegmentExclusion)

Definiert, welche Nutzer in diesem Segment ausgeschlossen werden. Optional.

UserSegmentCriteria

Ein Nutzer entspricht einem Kriterium, wenn die Ereignisse des Nutzers die Bedingungen im Kriterium erfüllen.

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

object (UserSegmentConditionGroup)

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

andSequenceGroups[]

object (UserSegmentSequenceGroup)

Ein Nutzer erfüllt diese Kriterien, wenn er alle andSequenceGroups und alle 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)

Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie der Bedingungsgruppe entsprechen. Dieser Bereich definiert, für wie viele Ereignisse das segmentFilterExpression ausgewertet wird, bevor festgestellt wird, ob die Bedingungsgruppe erfüllt ist oder nicht. Wenn conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wird der Ausdruck für alle Ereignisse in einer Sitzung ausgewertet. Anschließend wird ermittelt, ob die Bedingungsgruppe für diesen Nutzer erfüllt ist. Wenn conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, wird der Ausdruck für ein einzelnes Ereignis ausgewertet und dann wird ermittelt, ob die Bedingungsgruppe für diesen Nutzer erfüllt ist.

Optional. Wenn nichts angegeben ist, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter an.

UserCriteriaScoping

Mit dem Bereich wird festgelegt, welche Ereignisse berücksichtigt werden, wenn geprüft wird, ob ein Nutzer ein Kriterium erfüllt.

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebener Bereich für Kriterien. Nicht angeben.
USER_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, entspricht der Nutzer den Kriterien.
USER_CRITERIA_WITHIN_SAME_SESSION Wenn die Kriterien innerhalb einer Sitzung erfüllt sind, entspricht der Nutzer den Kriterien.
USER_CRITERIA_ACROSS_ALL_SESSIONS Wenn die Kriterien durch Ereignisse für den Nutzer erfüllt werden, entspricht der Nutzer den Kriterien.

SegmentFilterExpression

Kombinationen von Segmentfiltern.

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 einen Filtertyp für SegmentFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (SegmentFilterExpressionList)

Die SegmentFilterExpression in andGroup haben eine UND-Beziehung.

orGroup

object (SegmentFilterExpressionList)

Die SegmentFilterExpression in orGroup haben eine ODER-Beziehung.

notExpression

object (SegmentFilterExpression)

Der SegmentFilterExpression ist NICHT vom Typ notExpression.

segmentFilter

object (SegmentFilter)

Ein einfacher Segmentfilter.

segmentEventFilter

object (SegmentEventFilter)

Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

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

Der Name der Dimension oder des Messwerts.

filterScoping

object (SegmentFilterScoping)

Gibt den Umfang für den Filter an.

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

object (StringFilter)

Filter für Strings.

inListFilter

object (InListFilter)

Ein Filter für Werte in der Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für einen Bereich zwischen zwei Werten.

SegmentFilterScoping

Mit Bereichen wird angegeben, wie die Dimensionen und Messwerte mehrerer Ereignisse bei der Auswertung eines Segmentfilters berücksichtigt werden sollen.

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

boolean

Wenn atAnyPointInTime „true“ ist, ergibt dieser Filter „true“ für alle Ereignisse, wenn er für ein beliebiges Ereignis im Datumsbereich der Anfrage „true“ ergibt.

Dieser atAnyPointInTime-Parameter verlängert nicht den Zeitraum der Ereignisse im Bericht. Wenn atAnyPointInTime „true“ ist, werden bei der Auswertung dieses Filters nur Ereignisse innerhalb des Zeitraums des Berichts berücksichtigt.

atAnyPointInTime kann nur angegeben werden, wenn der Bereich der Kriterien ACROSS_ALL_SESSIONS ist. In Sequenzen kann er nicht angegeben werden.

Wenn der Bereich der Kriterien ACROSS_ALL_SESSIONS ist, wird atAnyPointInTime = false verwendet, sofern nichts anderes angegeben ist.

SegmentEventFilter

Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

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

string

Dieser Filter entspricht Ereignissen mit diesem einzelnen Ereignisnamen. Ereignisname erforderlich.

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

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

Im Parameterfilterausdruck sind nur Parameterfilter verfügbar.

SegmentParameterFilterExpression

Kombinationen von Segmentfiltern für Parameter.

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 einen Filtertyp für SegmentParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig:
andGroup

object (SegmentParameterFilterExpressionList)

Die SegmentParameterFilterExpression in andGroup haben eine UND-Beziehung.

orGroup

object (SegmentParameterFilterExpressionList)

Die SegmentParameterFilterExpression in orGroup haben eine ODER-Beziehung.

notExpression

object (SegmentParameterFilterExpression)

Der SegmentParameterFilterExpression ist NICHT vom Typ notExpression.

segmentParameterFilter

object (SegmentParameterFilter)

Ein einfacher Segmentparameterfilter.

SegmentParameterFilterExpressionList

Eine Liste mit Filterausdrücken für Segmentparameter.

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, nach dem gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig:
eventParameterName

string

Dieser Filter wird für den angegebenen Ereignisparameter ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Zu den Ereignisparametern gehören Felder wie „firebase_screen“ und „currency“.

Ereignisparameter können nur in Segmenten und Trichteranalysen verwendet werden und nur in einem untergeordneten Filter von einem EventFilter. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden.

itemParameterName

string

Dieser Filter wird anhand des angegebenen Artikelparameters ausgewertet. Artikelparameter werden als Parameter im Artikelarray protokolliert. Zu den Artikelparametern gehören Felder wie „item_name“ und „item_category“.

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

Artikelparameter sind nur in E-Commerce-Ereignissen 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 für Strings.

inListFilter

object (InListFilter)

Ein Filter für Werte in der Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für einen Bereich zwischen zwei Werten.

SegmentParameterFilterScoping

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

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

string (int64 format)

Der Parameter wird über den angegebenen Zeitraum hinweg kumuliert, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Bereich der Kriterien ACROSS_ALL_SESSIONS oder WITHIN_SAME_SESSION ist. Wird nur unterstützt, wenn der Parameter event_count ist.

Wenn inAnyNDayPeriod beispielsweise 3 ist, der Ereignisname „purchase“, der Ereignisparameter „event_count“ und das Kriterium des Filters „größer als 5“, wird mit diesem Filter die Anzahl der Kaufereignisse für jeden Zeitraum von drei aufeinanderfolgenden Tagen im Datumsbereich des Berichts erfasst. Ein Nutzer erfüllt das Kriterium dieses Filters und wird in das Segment aufgenommen, wenn die Anzahl seiner Kaufereignisse in einem beliebigen Zeitraum von drei aufeinanderfolgenden Tagen 5 überschreitet. Beispielsweise werden die Zeiträume 01.11.2021 bis 03.11.2021, 02.11.2021 bis 04.11.2021, 03.11.2021 bis 05.11.2021 usw. berücksichtigt.

Der Zeitraum wird nicht verlängert, um ein vollständiges N-Tage-Fenster in der Nähe des Startdatums zu erhalten. Wenn ein Bericht beispielsweise für den Zeitraum vom 01.11.2021 bis zum 10.11.2021 erstellt wird und inAnyNDayPeriod = 3 ist, wird der erste Zeitraum von zwei Tagen verkürzt, da keine Ereignisdaten außerhalb des Datumsbereichs des Berichts gelesen werden. Die ersten vier Zeiträumen sind beispielsweise: 2021-11-01 bis 2021-11-01, 2021-11-01 bis 2021-11-02, 2021-11-01 bis 2021-11-03 und 2021-11-02 bis 2021-11-04.

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

UserSegmentSequenceGroup

Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge auftreten müssen, damit der Nutzer Mitglied des Segments 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. Wenn sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION festgelegt ist, 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 nichts angegeben ist, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.

sequenceMaximumDuration

string (Duration format)

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

sequenceMaximumDuration ist optional. Wenn nichts angegeben ist, können Sequenzen in beliebiger Zeit abgeschlossen werden.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

userSequenceSteps[]

object (UserSequenceStep)

Eine geordnete Abfolge von Bedingungsschritten. Die Ereignisse eines Nutzers müssen jeden Schritt durchlaufen, damit der Nutzer der UserSegmentSequenceGroup entspricht.

UserSequenceStep

Eine Bedingung, die im angegebenen Schritt auftreten muss, damit dieser Nutzer der Sequenz entspricht.

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

boolean

Wenn „true“ (wahr), muss das Ereignis, das diesen Schritt erfüllt, das unmittelbar nächste Ereignis nach dem Ereignis sein, das den letzten Schritt erfüllt. Wenn „false“, folgt dieser Schritt indirekt auf den vorherigen Schritt. Zwischen dem vorherigen und diesem Schritt können beispielsweise 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. Wenn sequenceScoping = WITHIN_SAME_SESSION, müssen diese Sequenzschritte beispielsweise innerhalb einer Sitzung abgeschlossen werden, damit der Nutzer der Sequenz entspricht. stepScoping = ACROSS_ALL_SESSIONS ist nur zulässig, wenn die sequenceScoping = ACROSS_ALL_SESSIONS.

Optional. Wenn nichts angegeben ist, verwendet stepScoping dieselbe UserCriteriaScoping wie die sequenceScoping.

segmentFilterExpression

object (SegmentFilterExpression)

Ein Nutzer entspricht diesem Sequenzschritt, wenn seine Ereignisse mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter an.

UserSegmentExclusion

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 dauert, wenn ein Nutzer mit userExclusionCriteria übereinstimmt.

Optional. Wenn nichts angegeben ist, wird userExclusionDuration von USER_EXCLUSION_TEMPORARY verwendet.

userExclusionCriteria

object (UserSegmentCriteria)

Wenn ein Nutzer diese Bedingung erfüllt, wird er für den Zeitraum userExclusionDuration aus dem Segment ausgeschlossen.

UserExclusionDuration

Hier werden die Optionen für die Dauer eines Ausschlusses aufgeführt, wenn ein Nutzer der userExclusionCriteria entspricht.

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

SessionSegment

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)

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

exclusion

object (SessionSegmentExclusion)

Definiert, welche Sitzungen in diesem Segment ausgeschlossen werden. Optional.

SessionSegmentCriteria

Eine Sitzung entspricht einem Kriterium, wenn die Ereignisse der Sitzung die Bedingungen des Kriteriums erfüllen.

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

object (SessionSegmentConditionGroup)

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

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)

Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie der Bedingungsgruppe entsprechen. Dieser Bereich definiert, für wie viele Ereignisse das segmentFilterExpression ausgewertet wird, bevor festgestellt wird, ob die Bedingungsgruppe erfüllt ist oder nicht. Wenn conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, wird der Ausdruck für alle Ereignisse in einer Sitzung ausgewertet. Anschließend wird ermittelt, ob die Bedingungsgruppe für diese Sitzung erfüllt ist. Wenn conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT ist, wird der Ausdruck für ein einzelnes Ereignis ausgewertet. Anschließend wird ermittelt, ob die Bedingungsgruppe für diese Sitzung erfüllt ist.

Optional. Wenn nichts angegeben ist, wird ein conditionScoping von WITHIN_SAME_SESSION verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

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

SessionCriteriaScoping

Mit dem Bereich wird festgelegt, welche Ereignisse berücksichtigt werden, wenn geprüft wird, ob eine Sitzung ein Kriterium erfüllt.

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebener Bereich für Kriterien. Nicht angeben.
SESSION_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, entspricht die Sitzung den Kriterien.
SESSION_CRITERIA_WITHIN_SAME_SESSION Wenn die Kriterien innerhalb einer Sitzung erfüllt sind, entspricht die Sitzung den Kriterien.

SessionSegmentExclusion

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 gilt, wenn eine Sitzung mit dem sessionExclusionCriteria übereinstimmt.

Optional. Wenn nichts angegeben ist, wird ein sessionExclusionDuration von SESSION_EXCLUSION_TEMPORARY verwendet.

sessionExclusionCriteria

object (SessionSegmentCriteria)

Wenn eine Sitzung diese Bedingung erfüllt, wird sie nicht in das Segment für die sessionExclusionDuration aufgenommen.

SessionExclusionDuration

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

Enums
SESSION_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Nicht angeben.
SESSION_EXCLUSION_TEMPORARY Sitzungen vorübergehend aus dem Segment ausschließen, wenn sie die sessionExclusionCriteria-Bedingung erfüllen.
SESSION_EXCLUSION_PERMANENT Sitzungen dauerhaft aus dem Segment ausschließen, wenn die sessionExclusionCriteria-Bedingung jemals erfüllt ist.

EventSegment

Ereignissegmente sind Teilmengen von Ereignissen, die auf Ihrer Website oder in Ihrer App ausgelöst wurden: etwa alle Kaufereignisse, die am selben Standort erfolgt sind, 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)

Definiert, welche Ereignisse in diesem Segment ausgeschlossen werden. Optional.

EventSegmentCriteria

Ein Ereignis entspricht einem Kriterium, wenn es die Bedingungen des Kriteriums erfüllt.

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

object (EventSegmentConditionGroup)

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

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 nichts angegeben ist, wird ein conditionScoping von EVENT_CRITERIA_WITHIN_SAME_EVENT verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter an.

EventCriteriaScoping

Mit dem Bereich wird festgelegt, welche Ereignisse berücksichtigt werden, wenn geprüft wird, ob ein Ereignis ein Kriterium erfüllt.

Enums
EVENT_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebener Bereich für Kriterien. Nicht angeben.
EVENT_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, entspricht das Ereignis den Kriterien.

EventSegmentExclusion

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 nichts angegeben ist, wird ein eventExclusionDuration von EVENT_EXCLUSION_PERMANENT verwendet.

eventExclusionCriteria

object (EventSegmentCriteria)

Wenn ein Ereignis diese Bedingung erfüllt, wird es für die eventExclusionDuration aus dem Segment ausgeschlossen.

EventExclusionDuration

Hier werden die Optionen für die Dauer eines Ausschlusses aufgelistet, wenn ein Ereignis mit eventExclusionCriteria übereinstimmt.

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Nicht angeben.
EVENT_EXCLUSION_PERMANENT Ereignisse dauerhaft aus dem Segment ausschließen, wenn das Ereignis jemals die Bedingung eventExclusionCriteria erfüllt.

FunnelSubReport

Die Unterberichte für Trichter enthalten die Datenwerte für Dimensionen und Messwerte. Beispiel: 12 Nutzer haben 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 immer die Dimension „Schritt im Trichter“ in den Antworten der Unterberichte. Falls angefordert, können in der Antwort zusätzliche Dimensionen wie Aufschlüsselungen, Datumsangaben und nächste Aktionen enthalten sein.

metricHeaders[]

object (MetricHeader)

Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in den Antworten der Unterberichte. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussrate, Abbrüche und Abbruchrate.

rows[]

object (Row)

Zeilen mit Kombinationen aus Dimensionswerten und Messwerten im Bericht.

metadata

object (FunnelResponseMetadata)

Metadaten für den Trichterbericht.

FunnelResponseMetadata

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

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

object (SamplingMetadata)

Wenn die Ergebnisse des Trichterberichts auf Stichproben basieren, wird hier der Prozentsatz der Ereignisse angegeben, die in diesem Trichterbericht verwendet wurden. Für jeden Zeitraum wird ein samplingMetadatas ausgefüllt. Jedes samplingMetadatas entspricht einem Zeitraum, sofern in der Anfrage Zeiträume angegeben wurden.

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