Method: properties.runFunnelReport

Gibt einen benutzerdefinierten Trichterbericht mit Ihren Google Analytics-Ereignisdaten zurück. Von der API wird eine 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

Diese Methode wird in der Alpha-Entwicklungsphase eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Füllen Sie dieses Formular aus, um Feedback zu dieser API zu geben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
property

string

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

Beispiel: properties/1234

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (DateRange)

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, werden die Ereignisdaten für die sich überschneidenden Tage in den Antwortzeilen für beide Zeiträume angezeigt.
funnel

object (Funnel)

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

object (FunnelBreakdown)

Optional. Wenn angegeben, wird durch diese Aufschlüsselung eine Dimension zur Antwort des Teilberichts in der Trichtertabelle hinzugefügt. Mit dieser Aufschlüsselungsdimension werden die einzelnen Trichterschritte 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 den Gesamtwert erstellt.
funnelNextAction

object (FunnelNextAction)

Optional. Falls angegeben, wird mit der nächsten Aktion der Antwort des untergeordneten Berichts „Trichtervisualisierung“ eine Dimension hinzugefügt. Bei dieser Dimension „Nächste Aktion“ werden die einzelnen Trichterschritte auf die eindeutigen Werte der nächsten Aktion erweitert. Bei einer nächsten Aktion der Dimension eventName werden beispielsweise Zeilen für mehrere Ereignisse (z. B. session_start und click) sowie die Gesamtzahl erstellt.

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

enum (FunnelVisualizationType)

Optional. Mit dem Typ „Trichtervisualisierung“ werden die Dimensionen gesteuert, die in der Antwort des untergeordneten Berichts „Trichtervisualisierung“ enthalten sind. Falls nichts angegeben wird, wird STANDARD_FUNNEL verwendet.
segments[]

object (Segment)

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

Jedes in dieser Anfrage angegebene Segment erzeugt eine separate Zeile in der Antwort. in der Antwort jedes durch seinen Namen identifizierte Segment.

Der Parameter „Segmente“ 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 Zeilen angefordert werden. limit muss positiv sein.

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

object (FilterExpression)

Optional. Mit Dimensionsfiltern können Sie nur bestimmte Dimensionswerte im Bericht anfordern. Weitere Informationen finden Sie unter Bericht erstellen: Dimensionsfilter. In diesem Filter können keine Messwerte verwendet werden.
returnPropertyQuota

boolean

Optional. Mit dieser Option kann festgelegt werden, 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. Bei den beiden untergeordneten Berichten handelt es sich um 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 Trichterschritt, Segment, Aufschlüsselungsdimension, aktiven Nutzern, Abschlussrate, Ausstiegsrate und Ausstiegsrate.

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 Schritt im Trichter, Segment, Datum, der Dimension „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 dann in der Antwort vorhanden, wenn sie angefordert wurde.
propertyQuota

object (PropertyQuota)

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

string

Gibt an, um welche Art von Ressource diese Nachricht handelt. Dieser 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 Trichterberichtsanfrage. In einem Trichter 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

In einem offenen Trichter können Nutzer an jedem beliebigen Punkt und in einem geschlossenen Trichter mit dem ersten Schritt beginnen. Optional. Wenn nicht angegeben, 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. Die Schritte enthalten eine oder mehrere Bedingungen, die Ihre Nutzer erfüllen müssen, um in diesen Schritt des Trichters einbezogen zu werden.

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

string

Der eindeutige Name für diesen Schritt. Wenn kein Wert angegeben ist, werden die Schritte mit einem 1-basierten 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 Trichterschritt der Anfrage angeben, wird 3. Purchase in der Antwort des Trichterberichts erzeugt.
isDirectlyFollowedBy

boolean

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

object (FunnelFilterExpression)

Die Bedingung, die Ihre Nutzer erfüllen müssen, um in diesen Schritt des Trichters einbezogen zu werden.
withinDurationFromPriorStep

string (Duration format)

Falls angegeben, muss dieser Schritt innerhalb dieser Zeitspanne nach Abschluss des vorherigen Schritts abgeschlossen werden. withinDurationFromPriorStep schließt den Endpunkt mit einem Detaillierungsgrad von Mikrosekunden ein. Eine Dauer von 5 Sekunden kann beispielsweise bei 4,9 oder 5,0 Sekunden abgeschlossen werden, aber nicht bei 5 Sekunden und 1 Mikrosekunde.

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

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

FunnelFilterExpression

Drückt Kombinationen von Trichterfiltern aus.

JSON-Darstellung 
{

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

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in andGroup hat eine AND-Beziehung.
orGroup

object (FunnelFilterExpressionList)

Die FunnelFilterExpression in orGroup hat eine OR-Beziehung.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression entspricht NICHT notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Ein Trichterfilter für eine Dimension oder einen Messwert.
funnelEventFilter

object (FunnelEventFilter)

Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter.

FunnelFilterExpressionList

Eine Liste der Trichterfilterausdrücke.

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)

Stringbezogener Filter.
inListFilter

object (InListFilter)

Ein Filter für In-Listen-Werte.
numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.
betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

FunnelEventFilter

Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter.

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

string

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

object (FunnelParameterFilterExpression)

Wenn angegeben, sucht dieser Filter nach Ereignissen, die sowohl mit dem Namen des einzelnen Ereignisses als auch mit den Ausdrücken des Parameterfilters übereinstimmen.

Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar.

FunnelParameterFilterExpression

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

JSON-Darstellung 
{

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

object (FunnelParameterFilterExpressionList)

Die FunnelParameterFilterExpression in andGroup hat eine AND-Beziehung.
orGroup

object (FunnelParameterFilterExpressionList)

Die FunnelParameterFilterExpression in orGroup hat eine ODER-Beziehung.
notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression entspricht NICHT notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Ein einfacher Parameterfilter für den Trichter.

FunnelParameterFilterExpressionList

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

string

Dieser Filter wird auf Basis des angegebenen Ereignisparameters ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Ereignisparameter enthalten Felder wie „firebase_screen“ und „currency“ an.

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

string

Dieser Filter wird auf Basis des angegebenen „item“-Parameters ausgewertet. „item“-Parameter werden als Parameter im „item“-Array protokolliert. Artikelparameter enthalten Felder wie „item_name“ und „item_category“.

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

Artikelparameter sind nur 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)

Stringbezogener Filter.
inListFilter

object (InListFilter)

Ein Filter für In-Listen-Werte.
numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.
betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

FunnelBreakdown

Durch Aufschlüsselungen wird der Antwort im Unterbericht der Trichtertabelle eine Dimension hinzugefügt.

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

object (Dimension)

Die Dimensionsspalte, die der Antwort des Unterberichts für die Trichtertabelle hinzugefügt wurde. Mit der Aufschlüsselungsdimension werden die einzelnen Schritte im Trichter aufgeschlüsselt. Wenn funnelBreakdown angegeben ist, ist eine gültige breakdownDimension erforderlich.
limit

string (int64 format)

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

FunnelNextAction

Die nächsten Aktionen geben den Wert für eine Dimension an, nachdem der Nutzer einen Schritt ausgeführt hat, aber bevor derselbe Nutzer den nächsten Schritt ausgeführt hat. Wenn nextActionDimension beispielsweise eventName ist, gibt nextActionDimension in der Zeile des i. Trichterschritts das erste Ereignis nach dem Ereignis zurück, das den Nutzer für den i. Trichterschritt qualifiziert hat, aber bevor der Nutzer den i+1. Trichterschritt erreicht hat.

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

object (Dimension)

Die Dimensionsspalte, die der Antwort des untergeordneten Berichts „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 Seiten-/Bildschirmabmessungen wie pageTitle und pagePath. „nextActionDimension“ kann kein Dimensionsausdruck sein.
limit

string (int64 format)

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

FunnelVisualizationType

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

Enums
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Nicht definierter Typ.
STANDARD_FUNNEL Standardtrichter mit Schritten Der Teilbericht „Trichtervisualisierung“ in der Antwort enthält kein Datum.
TRENDED_FUNNEL Trichter mit Zeitverlauf (Liniendiagramm) Der Teilbericht „Trichtervisualisierung“ in der Antwort enthält die Dimension „Datum“.

Segment

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

Weitere Informationen finden Sie unter Segmentierungstool in GA4.

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 des Segments. Wenn keine Angabe gemacht wird, erhalten Segmente den Namen „Segment“. Dieser Name definiert den Stringwert, der von der Dimension „segment“ zurückgegeben wird. Die Dimension segment stellt Segmentnamen anhand der 1-basierten Indexnummer des Segments in der Anfrage (z. B. „1. Segment", "2. Segment usw.).
Union-Feld one_segment_scope. Ein Segment ist 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 mit Ihrer Website oder App interagiert haben. Beispiele: Nutzer, die schon einmal etwas gekauft haben ... Nutzern, die Artikel in den Einkaufswagen gelegt, aber keinen Kauf abgeschlossen haben.

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

object (UserSegmentCriteria)

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

object (UserSegmentExclusion)

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

UserSegmentCriteria

Ein Nutzer erfüllt ein 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 alle andConditionGroups- und andSequenceGroups-Elemente erfüllt. andConditionGroups kann leer sein, wenn andSequenceGroups angegeben ist.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Ein Nutzer erfüllt diese Kriterien, wenn er alle andSequenceGroups- und andConditionGroups-Elemente 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 ein- oder ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Umfang wird definiert, wie viele Ereignisse die segmentFilterExpression ausgewertet wird, bevor die Bedingungsgruppe als übereinstimmend oder nicht bestätigt wird. Wenn beispielsweise conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, wird der Ausdruck für alle Ereignisse in einer Sitzung ausgewertet. Dann wird bestimmt, ob die Bedingungsgruppe mit diesem Nutzer übereinstimmt oder nicht. Wenn beispielsweise conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, wird der Ausdruck für ein einzelnes Ereignis ausgewertet. Dann wird bestimmt, ob die Bedingungsgruppe mit diesem Nutzer übereinstimmt oder nicht.

Optional. Wenn kein Wert angegeben ist, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.
segmentFilterExpression

object (SegmentFilterExpression)

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

UserCriteriaScoping

Durch die Definition des Geltungsbereichs wird angegeben, welche Ereignisse bei der Bewertung berücksichtigt werden, ob ein Nutzer ein Kriterium erfüllt.

Enums
USER_CRITERIA_SCOPING_UNSPECIFIED Nicht spezifizierter Kriteriumsumfang. Machen Sie keine Angaben.
USER_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien innerhalb eines Ereignisses erfüllt werden, erfüllt der Nutzer die Kriterien.
USER_CRITERIA_WITHIN_SAME_SESSION Wenn die Kriterien innerhalb einer Sitzung erfüllt werden, erfüllt der Nutzer die Kriterien.
USER_CRITERIA_ACROSS_ALL_SESSIONS Wenn ein Ereignis für den Nutzer die Kriterien erfüllt, erfüllt der Nutzer die Kriterien.

SegmentFilterExpression

Drückt Kombinationen von Segmentfiltern aus.

JSON-Darstellung 
{

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

object (SegmentFilterExpressionList)

SegmentFilterExpression in andGroup hat eine AND-Beziehung.
orGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression in orGroup hat eine OR-Beziehung.
notExpression

object (SegmentFilterExpression)

SegmentFilterExpression gehört NICHT zu notExpression.
segmentFilter

object (SegmentFilter)

Ein einfacher Segmentfilter.
segmentEventFilter

object (SegmentEventFilter)

Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter.

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)

Stringbezogener Filter.
inListFilter

object (InListFilter)

Ein Filter für In-Listen-Werte.
numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.
betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

SegmentFilterScoping

Scopings geben an, wie die Dimensionen und bei der Auswertung eines Segmentfilters sollten die Messwerte mehrerer Ereignisse berücksichtigt werden.

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

boolean

Ist atAnyPointInTime „true“, wird dieser Filter für alle Ereignisse mit „true“ ausgewertet, wenn er für ein Ereignis im Zeitraum der Anfrage „true“ ergibt.

Mit dem Parameter atAnyPointInTime wird der Zeitraum der Ereignisse im Bericht nicht verlängert. Ist „atAnyPointInTime“ auf „true“ gesetzt, werden bei der Auswertung dieses Filters nur Ereignisse innerhalb des Berichtszeitraums berücksichtigt.

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

Wenn der Kriteriumsbereich ACROSS_ALL_SESSIONS lautet, wird atAnyPointInTime = „false“ verwendet, wenn kein Wert angegeben ist.

SegmentEventFilter

Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter.

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

string

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

object (SegmentParameterFilterExpression)

Wenn angegeben, sucht dieser Filter nach Ereignissen, die sowohl mit dem Namen des einzelnen Ereignisses als auch mit den Ausdrücken des Parameterfilters übereinstimmen.

Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar.

SegmentParameterFilterExpression

drückt Kombinationen von Segmentfiltern für Parameter aus.

JSON-Darstellung 
{

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

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression in andGroup hat eine AND-Beziehung.
orGroup

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression in orGroup hat eine OR-Beziehung.
notExpression

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression gehört NICHT zu 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, das gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig:
eventParameterName

string

Dieser Filter wird auf Basis des angegebenen Ereignisparameters ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Ereignisparameter enthalten Felder wie „firebase_screen“ und „currency“ an.

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

string

Dieser Filter wird auf Basis des angegebenen „item“-Parameters ausgewertet. „item“-Parameter werden als Parameter im „item“-Array protokolliert. Artikelparameter enthalten Felder wie „item_name“ und „item_category“.

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

Artikelparameter sind nur 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)

Stringbezogener Filter.
inListFilter

object (InListFilter)

Ein Filter für In-Listen-Werte.
numericFilter

object (NumericFilter)

Ein Filter für numerische Werte oder Datumswerte.
betweenFilter

object (BetweenFilter)

Ein Filter für zwei Werte.

SegmentParameterFilterScoping

Anhand von Bereichen wird angegeben, wie mehrere Ereignisse bei der Auswertung eines Segmentparameterfilters berücksichtigt werden.

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

string (int64 format)

Akkumuliert den Parameter über die angegebene Zeitspanne von Tagen, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Kriteriumsbereich ACROSS_ALL_SESSIONS oder WITHIN_SAME_SESSION ist. Wird nur unterstützt, wenn der Parameter event_count ist.

Beispiel: Wenn inAnyNDayPeriod den Wert „3“ hat, „eventName“ „purchase“, der Ereignisparameter „event_count“ und die Filterkriterien größer als 5 sind, wird mit diesem Filter die Ereignisanzahl von Kaufereignissen für alle drei aufeinanderfolgenden Tage im Berichtszeitraum erfasst. Ein Nutzer erfüllt die Kriterien dieses Filters für die Aufnahme in dieses Segment, wenn die Anzahl der Kaufereignisse innerhalb eines Zeitraums von drei aufeinanderfolgenden Tagen 5 überschreitet. Berücksichtigt werden beispielsweise die Zeiträume 2021-11-01 bis 2021-11-03, 2021-11-02 bis 2021-11-04, 2021-11-03 bis 2021-11-05 usw.

Der Zeitraum wird nicht zu dem Zweck erweitert, dass kurz vor Beginn des Zeitraums ein vollständiges Fenster von n Tagen vorhanden ist. Wenn ein Bericht beispielsweise für den 1.11.2021 bis 10.11.2021 gilt und inAnyNDayPeriod = 3 ist, werden die ersten zwei Tage effektiv verkürzt, da keine Ereignisdaten außerhalb des Berichtszeitraums gelesen werden. Die ersten vier Zeiträume sind beispielsweise: 2021-11-01 bis 01.11.2021, 2021-11-01 bis 2021-11-02, 2021-11-01 bis 2021-11-03 und 12.11.2021 bis 1.11.2021.

inAnyNDayPeriod ist optional. Wenn keine Angabe erfolgt, wird die segmentParameterFilter einzeln auf jedes Ereignis angewendet.

UserSegmentSequenceGroup

Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge eintreten müssen, damit der Nutzer Mitglied eines Segments ist.

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

enum (UserCriteriaScoping)

Alle Sequenzschritte müssen im Gültigkeitsbereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Bei sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION müssen beispielsweise 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 kein Wert angegeben ist, wird conditionScoping = ACROSS_ALL_SESSIONS verwendet.
sequenceMaximumDuration

string (Duration format)

Definiert den Zeitraum, in dem die gesamte Sequenz stattfinden muss. z. B. 30 Minuten. sequenceMaximumDuration schließt den Endpunkt mit einem Detaillierungsgrad von Mikrosekunden ein. Beispielsweise kann eine Sequenz mit einer maximalen Dauer von 5 Sekunden bei 4,9 oder 5,0 Sekunden abgeschlossen werden, aber nicht bei 5 Sekunden und 1 Mikrosekunde.

sequenceMaximumDuration ist optional. Wenn nicht angegeben, können Sequenzen zu einem beliebigen Zeitpunkt 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 alle Schritte abschließen, damit er mit der UserSegmentSequenceGroup übereinstimmt.

UserSequenceStep

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

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

boolean

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

enum (UserCriteriaScoping)

Dieser Sequenzschritt muss bei der Festlegung des Gültigkeitsbereichs 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 entspricht. stepScoping = ACROSS_ALL_SESSIONS ist nur zulässig, wenn die sequenceScoping = ACROSS_ALL_SESSIONS.

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

object (SegmentFilterExpression)

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

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

Optional. Wenn kein Wert angegeben ist, wird userExclusionDuration von USER_EXCLUSION_TEMPORARY verwendet.
userExclusionCriteria

object (UserSegmentCriteria)

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

UserExclusionDuration

Zählt Optionen für die Dauer eines Ausschlusses auf, wenn ein Nutzer mit userExclusionCriteria übereinstimmt.

Enums
USER_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Machen Sie keine Angaben.
USER_EXCLUSION_TEMPORARY Sie können Nutzer vorübergehend aus dem Segment ausschließen, wenn sie die userExclusionCriteria-Bedingung erfüllen.
USER_EXCLUSION_PERMANENT Nutzer, die die userExclusionCriteria-Bedingung erfüllen, werden dauerhaft aus dem Segment ausgeschlossen.

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 diesem Segment enthalten sind. Optional.
exclusion

object (SessionSegmentExclusion)

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

SessionSegmentCriteria

Eine Sitzung erfüllt ein 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 diese Kriterien, wenn sie jedem dieser andConditionGroups entspricht.

SessionSegmentConditionGroup

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

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

enum (SessionCriteriaScoping)

Daten werden in das Segment ein- oder ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Umfang wird definiert, wie viele Ereignisse die segmentFilterExpression ausgewertet wird, bevor die Bedingungsgruppe als übereinstimmend oder nicht bestätigt wird. Wenn beispielsweise conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, wird der Ausdruck für alle Ereignisse in einer Sitzung ausgewertet. Dann wird bestimmt, ob die Bedingungsgruppe mit dieser Sitzung übereinstimmt oder nicht. Wenn beispielsweise conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, wird der Ausdruck für ein einzelnes Ereignis ausgewertet. Dann wird bestimmt, ob die Bedingungsgruppe für diese Sitzung erfüllt ist oder nicht.

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

object (SegmentFilterExpression)

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

SessionCriteriaScoping

Durch die Definition des Gültigkeitsbereichs wird angegeben, welche Ereignisse bei der Bewertung berücksichtigt werden, ob eine Sitzung ein Kriterium erfüllt.

Enums
SESSION_CRITERIA_SCOPING_UNSPECIFIED Nicht spezifizierter Kriteriumsumfang. Machen Sie keine Angaben.
SESSION_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien bei einem Ereignis erfüllt werden, erfüllt die Sitzung die Kriterien.
SESSION_CRITERIA_WITHIN_SAME_SESSION Wenn die Kriterien innerhalb einer Sitzung erfüllt werden, erfüllt die Sitzung die Kriterien.

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 kein Wert angegeben ist, wird als sessionExclusionDuration 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

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

Enums
SESSION_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Machen Sie keine Angaben.
SESSION_EXCLUSION_TEMPORARY Sie können Sitzungen vorübergehend aus dem Segment ausschließen, wenn die Sitzung die sessionExclusionCriteria-Bedingung erfüllt.
SESSION_EXCLUSION_PERMANENT Sie können Sitzungen dauerhaft aus dem Segment ausschließen, wenn sie die Bedingung „sessionExclusionCriteria“ erfüllen.

EventSegment

Ereignissegmente sind Teilmengen von Ereignissen, die auf Ihrer Website oder in Ihrer App ausgelöst wurden. z. B. alle Kaufereignisse an einem bestimmten Standort 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 in den Kriterien erfüllt.

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

object (EventSegmentConditionGroup)

Ein Ereignis erfüllt diese Kriterien, wenn es mit jeder 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 kein Wert angegeben ist, wird als conditionScoping EVENT_CRITERIA_WITHIN_SAME_EVENT verwendet.
segmentFilterExpression

object (SegmentFilterExpression)

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

EventCriteriaScoping

Die Definition des Gültigkeitsbereichs gibt an, welche Ereignisse bei der Bewertung berücksichtigt werden, ob ein Ereignis ein Kriterium erfüllt.

Enums
EVENT_CRITERIA_SCOPING_UNSPECIFIED Nicht spezifizierter Kriteriumsumfang. Machen Sie keine Angaben.
EVENT_CRITERIA_WITHIN_SAME_EVENT Wenn die Kriterien bei einem Ereignis erfüllt werden, 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 kein Wert angegeben ist, wird ein eventExclusionDuration von EVENT_EXCLUSION_PERMANENT verwendet.
eventExclusionCriteria

object (EventSegmentCriteria)

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

EventExclusionDuration

Zählt Optionen für die Dauer eines Ausschlusses auf, wenn ein Ereignis mit dem eventExclusionCriteria übereinstimmt.

Enums
EVENT_EXCLUSION_DURATION_UNSPECIFIED Nicht angegebene Ausschlussdauer. Machen Sie keine Angaben.
EVENT_EXCLUSION_PERMANENT Schließen Sie Ereignisse dauerhaft aus dem Segment aus, wenn sie die eventExclusionCriteria-Bedingung erfüllen.

FunnelSubReport

Trichter-Unterberichte enthalten die Werte 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 des Trichterschritts in Antworten für untergeordnete Berichte. Zusätzliche Dimensionen wie Aufschlüsselungen, Datumsangaben und nächste Aktionen können auf Anfrage in der Antwort enthalten sein.
metricHeaders[]

object (MetricHeader)

Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in den Antworten der Berichte. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussquote, Ausstiegsrate und Ausstiegsrate.
rows[]

object (Row)

Zeilen mit Dimensionswertkombinationen 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)

Falls die Ergebnisse des Trichterberichts auf Stichproben basieren, beschreibt dieser Wert den Prozentsatz der Ereignisse, die in diesem Trichterbericht verwendet wurden. Für jeden Zeitraum wird ein samplingMetadatas ausgefüllt. Jede samplingMetadatas entspricht einem Zeitraum, der in der Anfrage angegeben wurde.

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

SamplingMetadata

Falls die Ergebnisse des Trichterberichts auf Stichproben basieren, geben diese Metadaten den Prozentsatz der Ereignisse an, die in diesem Trichterbericht für einen bestimmten Zeitraum verwendet wurden. Bei einer Stichprobenerhebung wird eine Teilmenge aller Daten analysiert, um die aussagekräftigen Informationen im größeren Dataset zu ermitteln.

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

string (int64 format)

Die Gesamtzahl der in diesem Stichprobenbericht für einen Zeitraum gelesenen Ereignisse. Der Umfang der Daten der Property, die in diesem Trichterbericht analysiert wurden.
samplingSpaceSize

string (int64 format)

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

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

PropertyQuota

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

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

object (QuotaStatus)

In Analytics-Standard-Properties können pro Tag bis zu 200.000 Tokens verwendet werden. In Analytics 360-Properties können pro Tag 2.000.000 Tokens verwendet werden. Die meisten Anfragen benötigen weniger als 10 Tokens.
tokensPerHour

object (QuotaStatus)

In Analytics-Standard-Properties können bis zu 40.000 Tokens pro Stunde verwendet werden. In Analytics 360-Properties können pro Stunde 400.000 Tokens verwendet werden. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen stündlichen, täglichen und projektbasierten Stundenkontingenten abgezogen wird.
concurrentRequests

object (QuotaStatus)

Standard-Analytics-Properties können bis zu 10 Anfragen gleichzeitig senden. In Analytics 360-Properties können bis zu 50 Anfragen gleichzeitig verwendet werden.
serverErrorsPerProjectPerHour

object (QuotaStatus)

Bei standardmäßigen Analytics-Properties und Cloud-Projekt-Paaren können bis zu zehn Serverfehler pro Stunde auftreten. Bei Paaren von Analytics 360-Properties und Cloud-Projekten können bis zu 50 Serverfehler pro Stunde auftreten.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

In Analytics-Properties können pro Stunde bis zu 120 Anfragen mit Dimensionen mit potenziell Grenzwerten gesendet werden. In einer Batchanfrage wird jede Berichtsanfrage einzeln für dieses Kontingent gezählt, wenn die Anfrage Dimensionen mit potenziell Grenzwerten umfasst.
tokensPerProjectPerHour

object (QuotaStatus)

In Analytics-Properties können bis zu 35% der Tokens pro Projekt und Stunde verwendet werden. In Analytics-Standard-Properties können bis zu 14.000 Tokens pro Projekt und Stunde verwendet werden. Bei Analytics 360-Properties sind 140.000 Tokens pro Projekt und Stunde möglich. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen stündlichen, täglichen und projektbasierten Stundenkontingenten abgezogen wird.

QuotaStatus

Aktueller Status für eine bestimmte Kontingentgruppe.

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

integer

Von dieser Anfrage verbrauchtes Kontingent.
remaining

integer

Verbleibendes Kontingent nach dieser Anfrage.