Method: properties.runFunnelReport

Hier sehen Sie einen benutzerdefinierten Trichterbericht Ihrer Google Analytics-Ereignisdaten. Die von der API zurückgegebenen Daten werden in Form einer Tabelle mit Spalten für die angeforderten Dimensionen und Messwerte zurückgegeben.

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 finden Sie unter Explorative Trichteranalysen in GA4.

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 dieses Formular 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. Wird im URL-Pfad und nicht im Text angegeben. Weitere Informationen finden Sie unter Property-ID ermitteln. Innerhalb einer Batchanfrage sollte diese Property entweder nicht angegeben 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. Datumsbereiche der zu lesenden Daten. Wenn mehrere Zeiträume angefordert werden, enthält jede Antwortzeile einen auf null basierenden Zeitrapindizes. Wenn sich zwei Zeiträume überschneiden, werden die Ereignisdaten für die überlappenden Tage in den Antwortzeilen für beide Zeiträume berücksichtigt.

funnel

object (Funnel)

Optional. Die Konfiguration des Trichters dieser Anfrage. Diese Trichterkonfiguration ist erforderlich.

funnelBreakdown

object (FunnelBreakdown)

Optional. Wenn Sie diese Aufschlüsselung angeben, wird der Antwort des untergeordneten Trichtertabellenberichts 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 Gesamtzahl erstellt.

funnelNextAction

object (FunnelNextAction)

Optional. Wenn angegeben, wird der Antwort des untergeordneten Berichts für die Trichtervisualisierung eine Dimension hinzugefügt. Mit dieser Dimension wird jeder Trichterschritt auf die eindeutigen Werte der nächsten Aktion erweitert. Wenn Sie beispielsweise eine nächste Aktion für die Dimension eventName auswählen, werden Zeilen für mehrere Ereignisse (z. B. session_start und click) und die Gesamtzahl erstellt.

Für die nächste Aktion werden nur eventName und die meisten Dimensionen vom Typ „Seite / Bildschirm“ wie pageTitle und pagePath unterstützt.

funnelVisualizationType

enum (FunnelVisualizationType)

Optional. Mit dem Typ der Trichtervisualisierung werden die Dimensionen festgelegt, die in der Antwort des untergeordneten Berichts zur 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 keine Angabe gemacht wird, werden 10.000 Zeilen zurückgegeben. Die API gibt pro Anfrage maximal 250.000 Zeilen zurück,unabhängig davon, wie viele Sie anfordern. limit muss positiv sein.

Die API kann auch weniger Zeilen als die angeforderte 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. In diesem Filter können keine Messwerte verwendet werden.

returnPropertyQuota

boolean

Optional. 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 des Trichterberichts enthält zwei untergeordnete Berichte. Die beiden untergeordneten Berichte enthalten 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 mit den folgenden Messwerten: Trichterschritt, Segment, Aufschlüsselungsdimension, aktive Nutzer, Abschlussrate, Ausstiege und Ausstiegsrate.

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

funnelVisualization

object (FunnelSubReport)

Die Trichtervisualisierung ist ein Bericht mit den Dimensionen „Trichterschritt“, „Segment“, „Datum“, „Nächste Aktion“ und „Aktive Nutzer“.

Die Segmentdimension ist nur in dieser Antwort vorhanden, wenn ein Segment angefordert wurde. Die Datumsdimension ist nur in dieser Antwort enthalten, 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. Diese kind ist immer der feste String „analyticsData#runFunnelReport“. 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

Trichter

Konfiguriert den Trichter in einer Trichterberichtsanfrage. In einem Trichter werden Nutzer erfasst, die eine Abfolge 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 ersten Schritt des Trichters durchlaufen. Optional. Wenn keine Angabe gemacht wird, 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 Sie keine Namen angeben, werden die Schritte mit einem Indexnamen benannt, der mit „1“ beginnt (z. B. „0. „, "1. usw.). Mit diesem Namen wird der Stringwert definiert, der von der Dimension funnelStepName zurückgegeben wird. Wenn Sie beispielsweise name = Purchase im dritten Trichterschritt der Anfrage angeben, wird 3. Purchase in der Trichterberichtsantwort zurückgegeben.

isDirectlyFollowedBy

boolean

Wenn diese Option aktiviert ist, muss dieser Schritt direkt auf den vorherigen Schritt folgen. Wenn „false“ (falsch) festgelegt ist, kann es zwischen dem vorherigen und diesem Schritt Ereignisse geben. Wenn nichts angegeben wird, wird isDirectlyFollowedBy als „falsch“ behandelt.

filterExpression

object (FunnelFilterExpression)

Die Bedingung, die ein Nutzer erfüllen muss, um bei diesem Schritt im Trichter berücksichtigt zu werden.

withinDurationFromPriorStep

string (Duration format)

Falls angegeben, muss dieser Schritt innerhalb dieser Dauer nach Abschluss des vorherigen Schritts abgeschlossen sein. withinDurationFromPriorStep ist einschließlich des Endpunkts in Mikrosekunden. Eine Dauer von 5 Sekunden kann beispielsweise nach 4,9 oder 5,0 Sekunden ablaufen, aber nicht nach 5 Sekunden und 1 Mikrosekunde.

withinDurationFromPriorStep ist optional. Wenn Sie diesen Wert nicht angeben, können die Schritte durch beliebige Zeiträume getrennt werden.

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

FunnelFilterExpression

Gibt Kombinationen von Trichterfiltern an.

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)

Der Trichterfilterausdruck in andGroup hat eine UND-Beziehung.

orGroup

object (FunnelFilterExpressionList)

Der FunnelFilterExpression in orGroup hat eine ODER-Beziehung.

notExpression

object (FunnelFilterExpression)

Der Trichterfilterausdruck ist KEIN notExpression.

funnelFieldFilter

object (FunnelFieldFilter)

Trichterfilter für eine Dimension oder einen Messwert.

funnelEventFilter

object (FunnelEventFilter)

Erstellt einen Filter, der Ereignisse mit einem einzelnen Ereignisnamen abgleicht. Wenn ein Parameterfilterausdruck angegeben ist, wird nur die Teilmenge der Ereignisse berücksichtigt, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

FunnelFilterExpressionList

Eine Liste von Trichterfilterausdrücken.

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

object (FunnelFilterExpression)

Liste der Trichterfilterausdrücke.

FunnelFieldFilter

Ein Ausdruck zum Filtern von Dimensions- oder Messwertwerten.

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 einer Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für Werte zwischen zwei Werten.

FunnelEventFilter

Erstellt einen Filter, der Ereignisse mit einem einzelnen Ereignisnamen abgleicht. Wenn ein Parameterfilterausdruck angegeben ist, wird nur die Teilmenge der Ereignisse berücksichtigt, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

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 dieser Filter angegeben ist, werden Ereignisse berücksichtigt, die sowohl dem Namen des einzelnen Ereignisses als auch den Parameterfilterausdrücken entsprechen.

Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar.

FunnelParameterFilterExpression

Gibt Kombinationen von Trichterfiltern für Parameter an.

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 Trichterparameterfilterausdrücke in andGroup haben eine UND-Beziehung.

orGroup

object (FunnelParameterFilterExpressionList)

Der FunnelParameterFilterExpression in orGroup hat eine ODER-Beziehung.

notExpression

object (FunnelParameterFilterExpression)

Der Trichterparameterfilterausdruck ist KEIN notExpression.

funnelParameterFilter

object (FunnelParameterFilter)

Ein einfacher Trichterparameterfilter.

FunnelParameterFilterExpressionList

Eine Liste von Filterausdrücken für Trichterparameter.

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

object (FunnelParameterFilterExpression)

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 Trichtern sowie in einem untergeordneten Filter eines Ereignisfilters verwendet werden. In einem untergeordneten Filter eines Ereignisfilters 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 Trichtern sowie in einem untergeordneten Filter eines Ereignisfilters verwendet werden. In einem untergeordneten Filter eines Ereignisfilters sollten entweder Ereignis- oder Artikelparameter verwendet werden.

Artikelparameter sind nur in E-Commerce-Ereignissen verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie in der Anleitung 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 einer Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für Werte zwischen zwei Werten.

FunnelBreakdown

Aufschlüsselungen fügen der Antwort des untergeordneten Trichtertabellenberichts eine Dimension hinzu.

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

object (Dimension)

Die Dimensionsspalte, die der Antwort des untergeordneten Trichtertabellenberichts hinzugefügt wurde. Mit der Aufschlüsselungsdimension werden die einzelnen Trichterschritte aufgeschlüsselt. Ein gültiger breakdownDimension-Wert ist erforderlich, wenn funnelBreakdown angegeben ist.

limit

string (int64 format)

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

FunnelNextAction

„Nächste Aktionen“ gibt den Wert für eine Dimension an, nachdem der Nutzer einen Schritt ausgeführt hat, aber noch nicht den nächsten. Wenn nextActionDimension beispielsweise eventName ist, wird für nextActionDimension in der Zeile für den i. Trichterschritt das erste Ereignis nach dem Ereignis zurückgegeben, das den Nutzer für den i. Trichterschritt qualifiziert hat, aber noch vor dem i+1. Trichterschritt.

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

object (Dimension)

Die Dimensionsspalte, die der Antwort des untergeordneten Berichts zur Trichtervisualisierung hinzugefügt wurde. Die Dimension „Nächste Aktion“ gibt den nächsten Dimensionswert dieser Dimension zurück, nachdem der Nutzer den i. Trichterschritt erreicht hat.

nextActionDimension unterstützt derzeit nur eventName und die meisten Dimensionen vom Typ „Seite / Bildschirm“, z. B. pageTitle und pagePath. nextActionDimension darf kein Dimensionsausdruck sein.

limit

string (int64 format)

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

FunnelVisualizationType

Hiermit werden die Dimensionen gesteuert, die in der Antwort des untergeordneten Berichts „Trichtervisualisierung“ enthalten sind.

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nicht definierter Typ.
STANDARD_FUNNEL Einen Standardtrichter (mit Schritten) Der untergeordnete Bericht „Trichtervisualisierung“ in der Antwort enthält kein Datum.
TRENDED_FUNNEL Einen Trichter mit Zeitverlauf (Liniendiagramm). Der untergeordnete Bericht „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 finden Sie unter 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 Sie keine Namen angeben, werden Segmente als „Segment“ bezeichnet. Mit diesem Namen wird der Stringwert definiert, der von der Dimension segment zurückgegeben wird. Bei der Dimension segment wird den Segmentnamen die Indexnummer des Segments in der Anfrage (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)

Hier wird festgelegt, welche Nutzer in dieses Segment aufgenommen werden. Optional.

exclusion

object (UserSegmentExclusion)

Hiermit wird festgelegt, welche Nutzer in diesem Segment ausgeschlossen werden. Optional.

UserSegmentCriteria

Ein Nutzer entspricht einem Kriterium, wenn seine Ereignisse die Bedingungen in den Kriterien erfüllen.

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

object (UserSegmentConditionGroup)

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

andSequenceGroups[]

object (UserSegmentSequenceGroup)

Ein Nutzer erfüllt diese Kriterien, wenn er allen andSequenceGroups und allen andConditionGroups entspricht. 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 aufgenommen oder daraus ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit dieser Begrenzung wird festgelegt, anhand von wie vielen Ereignissen das segmentFilterExpression ausgewertet wird, bevor festgestellt wird, ob die Bedingungsgruppe erfüllt ist oder nicht. Wenn Sie beispielsweise conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION auswählen, 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 oder nicht. Wenn beispielsweise conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT festgelegt ist, wird der Ausdruck für ein einzelnes Ereignis ausgewertet und dann wird ermittelt, ob die Bedingungsgruppe für diesen Nutzer erfüllt ist oder nicht.

Optional. Wenn keine Angabe erfolgt, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

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

UserCriteriaScoping

Mit dem Umfang wird festgelegt, welche Ereignisse bei der Prüfung berücksichtigt werden, ob ein Nutzer ein bestimmtes Kriterium erfüllt.

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebene Kriterien Nicht angeben.
USER_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien in einem Ereignis erfüllt sind, entspricht der Nutzer den Kriterien.
USER_CRITERIA_WITHIN_SAME_SESSION Wenn die Kriterien innerhalb einer Sitzung erfüllt werden, 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

Gibt Kombinationen von Segmentfiltern an.

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)

Der SegmentFilterExpression in andGroup hat eine UND-Beziehung.

orGroup

object (SegmentFilterExpressionList)

Der SegmentFilterExpression in orGroup hat eine ODER-Beziehung.

notExpression

object (SegmentFilterExpression)

Der SegmentFilterExpression ist KEIN notExpression.

segmentFilter

object (SegmentFilter)

Ein einfacher Segmentfilter.

segmentEventFilter

object (SegmentEventFilter)

Erstellt einen Filter, der Ereignisse mit einem einzelnen Ereignisnamen abgleicht. Wenn ein Parameterfilterausdruck angegeben ist, wird nur die Teilmenge der Ereignisse berücksichtigt, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

SegmentFilterExpressionList

Eine Liste von Segmentfilterausdrücken.

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

object (SegmentFilterExpression)

Liste der Segmentfilterausdrücke

SegmentFilter

Ein Ausdruck zum Filtern von Dimensions- oder Messwertwerten.

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 des Filters 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 einer Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für Werte zwischen zwei Werten.

SegmentFilterScoping

Mit Scopes wird festgelegt, 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 „wahr“ ist, wird dieser Filter für alle Ereignisse als „wahr“ ausgewertet, wenn er für ein Ereignis im angegebenen Zeitraum als „wahr“ ausgewertet wird.

Mit diesem Parameter wird der Zeitraum der Ereignisse im Bericht nicht erweitert.atAnyPointInTime Wenn atAnyPointInTime auf „wahr“ gesetzt ist, werden bei der Auswertung dieses Filters nur Ereignisse im Zeitraum des Berichts berücksichtigt.

Diese atAnyPointInTime kann nur angegeben werden, wenn die Kriterienbegrenzung ACROSS_ALL_SESSIONS ist. Sie kann nicht in Sequenzen angegeben werden.

Wenn der Kriterienbereich ACROSS_ALL_SESSIONS ist, wird atAnyPointInTime = false verwendet, wenn keine Angabe gemacht wird.

SegmentEventFilter

Erstellt einen Filter, der Ereignisse mit einem einzelnen Ereignisnamen abgleicht. Wenn ein Parameterfilterausdruck angegeben ist, wird nur die Teilmenge der Ereignisse berücksichtigt, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.

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 dieser Filter angegeben ist, werden Ereignisse berücksichtigt, die sowohl dem Namen des einzelnen Ereignisses als auch den Parameterfilterausdrücken entsprechen.

Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar.

SegmentParameterFilterExpression

Gibt Kombinationen von Segmentfiltern für Parameter an.

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)

Der SegmentParameterFilterExpression in orGroup hat eine ODER-Beziehung.

notExpression

object (SegmentParameterFilterExpression)

Der SegmentParameterFilterExpression ist KEIN notExpression.

segmentParameterFilter

object (SegmentParameterFilter)

Ein primitiver Segmentparameterfilter.

SegmentParameterFilterExpressionList

Eine Liste von Filterausdrücken für Segmentparameter.

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

object (SegmentParameterFilterExpression)

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 des Filters 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 Trichtern sowie in einem untergeordneten Filter eines Ereignisfilters verwendet werden. In einem untergeordneten Filter eines Ereignisfilters 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 Trichtern sowie in einem untergeordneten Filter eines Ereignisfilters verwendet werden. In einem untergeordneten Filter eines Ereignisfilters sollten entweder Ereignis- oder Artikelparameter verwendet werden.

Artikelparameter sind nur in E-Commerce-Ereignissen verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie in der Anleitung 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 einer Liste.

numericFilter

object (NumericFilter)

Ein Filter für numerische oder Datumswerte.

betweenFilter

object (BetweenFilter)

Ein Filter für Werte zwischen zwei Werten.

SegmentParameterFilterScoping

Mit Scopes 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 in Tagen erfasst, bevor der Filter angewendet wird. Nur unterstützt, wenn die Kriterienbegrenzung 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 Filterkriterium größer als 5 ist, wird mit diesem Filter die Ereignisanzahl der Kaufereignisse für jeden Zeitraum von drei aufeinanderfolgenden Tagen im Zeitraum des Berichts erfasst. Ein Nutzer wird in dieses Segment aufgenommen, wenn die Anzahl der Kaufereignisse in einem Zeitraum von drei aufeinanderfolgenden Tagen mehr als 5 beträgt. 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 am Anfang des Zeitraums ein volles N-Tage-Fenster zu erhalten. Wenn ein Bericht beispielsweise vom 01.11.2021 bis zum 10.11.2021 gilt und inAnyNDayPeriod = 3 ist, wird der Zeitraum der ersten beiden Tage effektiv verkürzt, da keine Ereignisdaten außerhalb des Berichtszeitraums gelesen werden. Die ersten vier Zeiträume sind beispielsweise 01.11.2021 bis 01.11.2021, 01.11.2021 bis 02.11.2021, 01.11.2021 bis 03.11.2021 und 02.11.2021 bis 04.11.2021.

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

UserSegmentSequenceGroup

Hier können Sie Bedingungen definieren, die in einer bestimmten Reihenfolge erfüllt werden müssen, damit der Nutzer zum Segment gehört.

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

enum (UserCriteriaScoping)

Alle Schritte der Sequenz müssen im Umfang erfüllt sein, damit der Nutzer der Sequenz zugeordnet werden kann. Wenn beispielsweise sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION festgelegt ist, müssen alle Schritte der Abfolge innerhalb einer Sitzung abgeschlossen werden, damit der Nutzer der Abfolge zugeordnet werden kann. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT wird nicht unterstützt.

Optional. Wenn keine Angabe erfolgt, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.

sequenceMaximumDuration

string (Duration format)

Hier wird der Zeitraum festgelegt, in dem die gesamte Sequenz ablaufen muss, z. B. 30 Minuten. sequenceMaximumDuration ist einschließlich des Endpunkts in Mikrosekunden. 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 Sie diesen Parameter nicht angeben, 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 bedingten Schritten. Die Ereignisse eines Nutzers müssen alle Schritte durchlaufen, damit der Nutzer mit der UserSegmentSequenceGroup übereinstimmt.

UserSequenceStep

Eine Bedingung, die in der angegebenen Schrittreihenfolge erfüllt werden muss, damit dieser Nutzer der Sequenz entspricht.

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

boolean

Wenn diese Option aktiviert ist, muss das Ereignis, das diesen Schritt erfüllt, direkt auf das Ereignis folgen, das den letzten Schritt erfüllt. Wenn „false“ festgelegt ist, folgt dieser Schritt indirekt auf den vorherigen Schritt. Zwischen den beiden Schritten kann es beispielsweise Ereignisse geben. Für den ersten Schritt muss isDirectlyFollowedBy auf „falsch“ gesetzt sein.

stepScoping

enum (UserCriteriaScoping)

Dieser Sequenzschritt muss bei der Definition des Umfangs erfüllt sein, damit der Nutzer der Sequenz entspricht. Bei sequenceScoping = WITHIN_SAME_SESSION müssen diese Sequenzschritte beispielsweise innerhalb einer Sitzung abgeschlossen werden, damit der Nutzer der Sequenz zugeordnet werden kann. stepScoping = ACROSS_ALL_SESSIONS ist nur zulässig, wenn sequenceScoping = ACROSS_ALL_SESSIONS

Optional. Wenn keine Angabe erfolgt, wird für stepScoping dieselbe UserCriteriaScoping wie für sequenceScoping verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

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

UserSegmentExclusion

Gibt an, welche Nutzer in diesem Segment ausgeschlossen sind.

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

enum (UserExclusionDuration)

Gibt an, wie lange eine Aussetzung dauert, wenn ein Nutzer mit der userExclusionCriteria übereinstimmt.

Optional. Wenn keine Angabe erfolgt, wird userExclusionDuration von USER_EXCLUSION_TEMPORARY verwendet.

userExclusionCriteria

object (UserSegmentCriteria)

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

UserExclusionDuration

Hier werden Optionen für die Dauer eines Ausschlusses aufgelistet, wenn ein Nutzer mit der userExclusionCriteria übereinstimmt.

Enums
USER_EXCLUSION_DURATION_UNSPECIFIED Unbestimmte Ausschlussdauer. Nicht angeben.
USER_EXCLUSION_TEMPORARY Nutzer vorübergehend aus dem Segment ausschließen, während sie die Bedingung userExclusionCriteria 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)

Hier wird festgelegt, welche Sitzungen in dieses Segment aufgenommen werden. Optional.

exclusion

object (SessionSegmentExclusion)

Hier wird definiert, welche Sitzungen in diesem Segment ausgeschlossen werden. Optional.

SessionSegmentCriteria

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

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

object (SessionSegmentConditionGroup)

Eine Sitzung erfüllt dieses Kriterium, wenn sie mit allen 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 aufgenommen oder daraus ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit dieser Begrenzung wird festgelegt, anhand von wie vielen Ereignissen das segmentFilterExpression ausgewertet wird, bevor festgestellt wird, ob die Bedingungsgruppe erfüllt ist oder nicht. Wenn beispielsweise conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION festgelegt ist, 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 oder nicht. Wenn beispielsweise conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT festgelegt ist, wird der Ausdruck für ein einzelnes Ereignis ausgewertet und dann wird ermittelt, ob die Bedingungsgruppe für diese Sitzung erfüllt ist oder nicht.

Optional. Wenn keine Angabe erfolgt, wird ein conditionScoping von WITHIN_SAME_SESSION verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

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

SessionCriteriaScoping

Mit dem Umfang wird festgelegt, welche Ereignisse bei der Prüfung berücksichtigt werden, ob eine Sitzung bestimmte Kriterien erfüllt.

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED Nicht angegebene 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 sind.

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

enum (SessionExclusionDuration)

Gibt an, wie lange eine Aus exclusion gültig ist, wenn eine Sitzung mit der sessionExclusionCriteria übereinstimmt.

Optional. Wenn keine Angabe erfolgt, wird ein sessionExclusionDuration von SESSION_EXCLUSION_TEMPORARY verwendet.

sessionExclusionCriteria

object (SessionSegmentCriteria)

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

SessionExclusionDuration

Hier werden Optionen für die Dauer eines Ausschlusses aufgelistet, wenn eine Sitzung mit der sessionExclusionCriteria übereinstimmt.

Enums
SESSION_EXCLUSION_DURATION_UNSPECIFIED Unbestimmte Ausschlussdauer. Nicht angeben.
SESSION_EXCLUSION_TEMPORARY Sitzungen vorübergehend aus dem Segment ausschließen, während sie die Bedingung sessionExclusionCriteria erfüllen.
SESSION_EXCLUSION_PERMANENT Sitzungen dauerhaft aus dem Segment ausschließen, wenn die Sitzung die Bedingung sessionExclusionCriteria erfüllt.

EventSegment

Ereignissegmente sind Teilmengen von Ereignissen, die auf Ihrer Website oder in Ihrer App ausgelöst wurden. Beispiele: alle Kaufereignisse, die an einem bestimmten 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)

Hier wird definiert, welche Ereignisse in dieses Segment aufgenommen werden. Optional.

exclusion

object (EventSegmentExclusion)

Hier können Sie festlegen, welche Ereignisse in diesem Segment ausgeschlossen werden. Optional.

EventSegmentCriteria

Ein Ereignis stimmt mit einem Kriterium überein, 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 allen 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 keine Angabe erfolgt, wird ein conditionScoping von EVENT_CRITERIA_WITHIN_SAME_EVENT verwendet.

segmentFilterExpression

object (SegmentFilterExpression)

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

EventCriteriaScoping

Mit dem Umfang wird festgelegt, welche Ereignisse bei der Prüfung berücksichtigt werden, ob ein Ereignis bestimmte Kriterien erfüllt.

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

EventSegmentExclusion

Hier wird angegeben, 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 keine Angabe erfolgt, wird ein eventExclusionDuration von EVENT_EXCLUSION_PERMANENT verwendet.

eventExclusionCriteria

object (EventSegmentCriteria)

Wenn ein Ereignis diese Bedingung erfüllt, wird es nicht in das Segment für die eventExclusionDuration aufgenommen.

EventExclusionDuration

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

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

FunnelSubReport

Trichterunterberichte enthalten die Datenwerte für Dimensionen und Messwerte. Angenommen, 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 „Trichterschritt“ in den Antworten von untergeordneten Berichten. Auf Anfrage können in der Antwort zusätzliche Dimensionen wie Aufschlüsselungen, Datumsangaben und nächste Aktionen enthalten sein.

metricHeaders[]

object (MetricHeader)

Beschreibt Messwertspalten. In Trichterberichten sind in den Antworten von untergeordneten Berichten immer aktive Nutzer enthalten. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussrate, Ausstiege und Ausstiegsrate.

rows[]

object (Row)

Zeilen mit Kombinationen von 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, gibt dieser Wert an, welcher Prozentsatz der Ereignisse in diesem Trichterbericht verwendet wurde. Für jeden Zeitraum wird eine samplingMetadatas erfasst. Jedes samplingMetadatas entspricht einem Zeitraum, der in der Anfrage angegeben wurde.

Wenn die Ergebnisse jedoch nicht Stichprobenerhebungen sind, ist dieses Feld nicht definiert.