- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Trichter
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segment
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- Testen!
Gibt einen benutzerdefinierten Trichterbericht Ihrer Google Analytics-Ereignisdaten zurück. Die von der API zurückgegebenen Daten liegen als Tabelle mit Spalten für die angeforderten Dimensionen und Messwerte vor.
Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden. Wie werden z. B. aus potenziellen Kunden Besucher und letztendlich Käufer? Wie werden Neukunden zu Bestandskunden? Anhand dieser Informationen können Sie dann entsprechende Optimierungen vornehmen. Weitere Informationen
Diese Methode wird in der Alpha-Entwicklungsphase eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Wenn Sie Feedback zu dieser API geben möchten, füllen Sie bitte das Formular für Feedback zu Trichterberichten in der Google Analytics Data API aus.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter | |
|---|---|
property |
Optional. Die ID einer Google Analytics-Property, deren Ereignisse erfasst werden. Im URL-Pfad und nicht im Text angegeben. Weitere Informationen In einer Batchanfrage sollte diese Property entweder nicht angegeben werden oder mit der Property auf Batchebene übereinstimmen. Beispiel: properties/1234 |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
|---|
{ "dateRanges": [ { object ( |
| Felder | |
|---|---|
dateRanges[] |
Optional. Zeiträume der zu lesenden Daten. Wenn mehrere Zeiträume angefordert werden, enthält jede Antwortzeile einen nullbasierten Zeitraumindex. Wenn sich zwei Zeiträume überschneiden, sind die Ereignisdaten für die überschneidenden Tage in den Antwortzeilen für beide Zeiträume enthalten. |
funnel |
Optional. Die Konfiguration des Trichters für diese Anfrage. Diese Trichterkonfiguration ist erforderlich. |
funnelBreakdown |
Optional. Falls angegeben, wird durch diese Aufschlüsselung der Antwort des Unterberichts für die Trichtertabelle eine Dimension hinzugefügt. Mit dieser Aufschlüsselungsdimension wird jeder Schritt im Trichter auf die eindeutigen Werte der Aufschlüsselungsdimension erweitert. Wenn Sie beispielsweise eine Aufschlüsselung nach der Dimension |
funnelNextAction |
Optional. Falls angegeben, wird mit der nächsten Aktion eine Dimension der Antwort des Unterberichts für die Trichtervisualisierung hinzugefügt. Mit dieser Dimension wird jeder Schritt im Trichter auf die eindeutigen Werte der nächsten Aktion erweitert. Wenn Sie beispielsweise die nächste Aktion der Dimension „Nächste Aktion“ unterstützt nur |
funnelVisualizationType |
Optional. Mit dem Visualisierungstyp „Trichter“ werden die Dimensionen gesteuert, die in der Antwort des Unterberichts für die Trichtervisualisierung enthalten sind. Falls nichts angegeben wird, wird |
segments[] |
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 |
Optional. Die Anzahl der zurückzugebenden Zeilen. Wenn nicht angegeben, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Sie anfordern. Die API kann auch weniger Zeilen als die angeforderten |
dimensionFilter |
Optional. Mit Dimensionsfiltern können Sie nur bestimmte Dimensionswerte im Bericht abrufen. Weitere Informationen finden Sie unter Bericht erstellen: Dimensionsfilter. Messwerte können in diesem Filter nicht verwendet werden. |
returnPropertyQuota |
Optional. Legt fest, ob der aktuelle Status des Kontingents dieser Analytics-Property zurückgegeben werden soll. Das Kontingent wird in PropertyQuota zurückgegeben. |
Antworttext
Die Antwort des Trichterberichts enthält zwei Unterberichte. Die beiden Unterberichte enthalten unterschiedliche Kombinationen aus Dimensionen und Messwerten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
|---|
{ "funnelTable": { object ( |
| Felder | |
|---|---|
funnelTable |
Die Trichtertabelle ist ein Bericht mit dem Schritt im Trichter, dem Segment, der Aufschlüsselungsdimension, den aktiven Nutzern, der Abschlussrate, den Abbrüchen und der Abbruchrate. Die Segmentdimension ist in dieser Antwort nur vorhanden, wenn ein Segment angefordert wurde. Die Aufschlüsselungsdimension ist in dieser Antwort nur vorhanden, wenn sie angefordert wurde. |
funnelVisualization |
Die Trichtervisualisierung ist ein Bericht mit den Dimensionen „Schritt im Trichter“, „Segment“, „Datum“, „Nächste Aktion“ und „Aktive Nutzer“. Die Segmentdimension ist in dieser Antwort nur vorhanden, wenn ein Segment angefordert wurde. Die Datumsdimension ist in dieser Antwort nur vorhanden, wenn sie über den Trichtertyp |
propertyQuota |
Der Kontingentstatus dieser Analytics-Property, einschließlich dieser Anfrage. |
kind |
Gibt an, um welche Art von Ressource es sich bei dieser Nachricht handelt. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics
Trichter
Konfiguriert den Trichter in einer Trichterberichts-Anfrage. In einem Trichterbericht werden Nutzer erfasst, während sie eine Reihe von Schritten durchlaufen.
Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden. Wie werden z. B. aus potenziellen Kunden Besucher und letztendlich Käufer? Wie werden Neukunden zu Bestandskunden? Anhand dieser Informationen können Sie dann entsprechende Optimierungen vornehmen.
| JSON-Darstellung |
|---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
| Felder | |
|---|---|
isOpenFunnel |
Bei einem offenen Trichter können Nutzer den Trichter an einem beliebigen Punkt betreten. Bei einem geschlossenen Trichter müssen Nutzer den Trichter im ersten Schritt betreten. Optional. Wenn nichts angegeben ist, wird ein geschlossener Trichter verwendet. |
steps[] |
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 ( |
| Felder | |
|---|---|
name |
Der eindeutige Name für diesen Schritt. Wenn nichts angegeben ist, werden die Schritte mit einem auf 1 basierenden indexierten Namen benannt (z. B. „0. “, „1. “ usw.). Dieser Name definiert den Stringwert, der von der Dimension |
isDirectlyFollowedBy |
Wenn „true“, muss dieser Schritt direkt auf den vorherigen Schritt folgen. Wenn „false“, kann es zwischen dem vorherigen und diesem Schritt Ereignisse geben. Wenn nicht angegeben, wird |
filterExpression |
Die Bedingung, die Ihre Nutzer erfüllen müssen, um bei diesem Schritt im Trichter berücksichtigt zu werden. |
withinDurationFromPriorStep |
Wenn angegeben, muss dieser Schritt innerhalb dieses Zeitraums nach Abschluss des vorherigen Schritts abgeschlossen werden.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
FunnelFilterExpression
Kombinationen von Trichterfiltern.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld expr. Geben Sie einen Filtertyp für FunnelFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Die FunnelFilterExpression in |
orGroup |
Die FunnelFilterExpression in |
notExpression |
Der FunnelFilterExpression ist NICHT vom Typ |
funnelFieldFilter |
Ein Trichterfilter für eine Dimension oder einen Messwert. |
funnelEventFilter |
Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen. |
FunnelFilterExpressionList
Eine Liste mit Trichterfilterausdrücken.
| JSON-Darstellung |
|---|
{
"expressions": [
{
object ( |
| Felder | |
|---|---|
expressions[] |
Die Liste der Trichterfilterausdrücke. |
FunnelFieldFilter
Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.
| JSON-Darstellung |
|---|
{ "fieldName": string, // Union field |
| Felder | |
|---|---|
fieldName |
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 |
Filter für Strings. |
inListFilter |
Ein Filter für Werte in der Liste. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für einen Bereich zwischen zwei Werten. |
FunnelEventFilter
Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.
| JSON-Darstellung |
|---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
| Felder | |
|---|---|
eventName |
Dieser Filter entspricht Ereignissen mit diesem einzelnen Ereignisnamen. Ereignisname erforderlich. |
funnelParameterFilterExpression |
Wenn angegeben, werden mit diesem Filter Ereignisse abgeglichen, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen. Im Parameterfilterausdruck sind nur Parameterfilter verfügbar. |
FunnelParameterFilterExpression
Kombinationen von Trichterfiltern für Parameter.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld expr. Geben Sie einen Filtertyp für FunnelParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Die FunnelParameterFilterExpression in |
orGroup |
Die FunnelParameterFilterExpression in |
notExpression |
Der FunnelParameterFilterExpression ist NICHT vom Typ |
funnelParameterFilter |
Ein einfacher Trichterparameterfilter. |
FunnelParameterFilterExpressionList
Eine Liste mit Filterausdrücken für Trichterparameter.
| JSON-Darstellung |
|---|
{
"expressions": [
{
object ( |
| Felder | |
|---|---|
expressions[] |
Die Liste der Filterausdrücke für Trichterparameter. |
FunnelParameterFilter
Ein Ausdruck zum Filtern von Parameterwerten in einem Trichter.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld one_parameter. Das Feld, nach dem gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig: |
|
eventParameterName |
Dieser Filter wird für den angegebenen Ereignisparameter ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Zu den Ereignisparametern gehören Felder wie „firebase_screen“ und „currency“. Ereignisparameter können nur in Segmenten und Trichteranalysen verwendet werden und nur in einem untergeordneten Filter von einem EventFilter. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. |
itemParameterName |
Dieser Filter wird anhand des angegebenen Artikelparameters ausgewertet. Artikelparameter werden als Parameter im Artikelarray protokolliert. Zu den Artikelparametern gehören Felder wie „item_name“ und „item_category“. Artikelparameter können nur in Segmenten und Trichteranalysen verwendet werden und nur in einem untergeordneten Filter von einem EventFilter. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. Artikelparameter sind nur in E-Commerce-Ereignissen verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie im Leitfaden E-Commerce messen. |
Union-Feld one_filter. Geben Sie einen Filtertyp an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Filter für Strings. |
inListFilter |
Ein Filter für Werte in der Liste. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für einen Bereich zwischen zwei Werten. |
FunnelBreakdown
Durch Aufschlüsselungen wird der Antwort des Unterberichts für die Trichtertabelle eine Dimension hinzugefügt.
| JSON-Darstellung |
|---|
{
"breakdownDimension": {
object ( |
| Felder | |
|---|---|
breakdownDimension |
Die Dimensionenspalte, die der Antwort des Unterberichts für die Trichtertabelle hinzugefügt wurde. Die Aufschlüsselungsdimension schlüsselt jeden Schritt im Trichter auf. Ein gültiger |
limit |
Die maximale Anzahl der unterschiedlichen Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird ein |
FunnelNextAction
Der Status „Nächste Aktionen“ gibt den Wert für eine Dimension an, nachdem der Nutzer einen Schritt ausgeführt hat, aber bevor er den nächsten Schritt ausführt. Wenn nextActionDimension beispielsweise eventName ist, wird mit nextActionDimension in der Zeile für den i. Schritt im Trichter das erste Ereignis nach dem Ereignis zurückgegeben, das den Nutzer für den i. Schritt im Trichter qualifiziert hat, aber bevor der Nutzer den i+1. Schritt im Trichter erreicht hat.
| JSON-Darstellung |
|---|
{
"nextActionDimension": {
object ( |
| Felder | |
|---|---|
nextActionDimension |
Die Dimensionenspalte, die der Antwort des Unterberichts für die Trichtervisualisierung hinzugefügt wurde. Die Dimension „Nächste Aktion“ gibt den nächsten Dimensionswert dieser Dimension zurück, nachdem der Nutzer den
|
limit |
Die maximale Anzahl der unterschiedlichen Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird ein |
FunnelVisualizationType
Steuert die Dimensionen, die in der Antwort des Unterberichts zur Trichtervisualisierung enthalten sind.
| Enums | |
|---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Nicht definierter Typ. |
STANDARD_FUNNEL |
Ein Standardtrichter (mit Stufen). Der Unterbericht zur Trichtervisualisierung in der Antwort enthält kein Datum. |
TRENDED_FUNNEL |
Ein Trichter mit Zeitverlauf (Liniendiagramm). Der Unterbericht zur Trichtervisualisierung in der Antwort enthält die Datumsdimension. |
Segment
Ein Segment ist eine Teilmenge Ihrer Analytics-Daten. Beispielsweise könnten Nutzer aus demselben Land oder Ort ein Segment all Ihrer Nutzer sein. Oder Sie segmentieren nach Nutzern, die Artikel einer Produktlinie kaufen, einen bestimmten Bereich Ihrer Website besuchen oder dasselbe Ereignis in Ihrer App auslösen.
| JSON-Darstellung |
|---|
{ "name": string, // Union field |
| Felder | |
|---|---|
name |
Der Name für dieses Segment. Wenn nichts angegeben wird, werden Segmente als „Segment“ bezeichnet. Dieser Name definiert den Stringwert, der von der Dimension |
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 |
Nutzersegmente sind Teilmengen von Nutzern, die mit Ihrer Website oder App interagiert haben. |
sessionSegment |
Sitzungssegmente sind Teilmengen der Sitzungen, die auf Ihrer Website oder in Ihrer App stattgefunden haben. |
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 ( |
| Felder | |
|---|---|
userInclusionCriteria |
Definiert, welche Nutzer in dieses Segment aufgenommen werden. Optional. |
exclusion |
Definiert, welche Nutzer in diesem Segment ausgeschlossen werden. Optional. |
UserSegmentCriteria
Ein Nutzer entspricht einem Kriterium, wenn die Ereignisse des Nutzers die Bedingungen im Kriterium erfüllen.
| JSON-Darstellung |
|---|
{ "andConditionGroups": [ { object ( |
| Felder | |
|---|---|
andConditionGroups[] |
Ein Nutzer erfüllt diese Kriterien, wenn er alle |
andSequenceGroups[] |
Ein Nutzer erfüllt diese Kriterien, wenn er alle |
UserSegmentConditionGroup
Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.
| JSON-Darstellung |
|---|
{ "conditionScoping": enum ( |
| Felder | |
|---|---|
conditionScoping |
Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie der Bedingungsgruppe entsprechen. Dieser Bereich definiert, für wie viele Ereignisse das Optional. Wenn nichts angegeben ist, wird |
segmentFilterExpression |
Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter an. |
UserCriteriaScoping
Mit dem Bereich wird festgelegt, welche Ereignisse berücksichtigt werden, wenn geprüft wird, ob ein Nutzer ein Kriterium erfüllt.
| Enums | |
|---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Bereich für Kriterien. Nicht angeben. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, entspricht der Nutzer den Kriterien. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Wenn die Kriterien innerhalb einer Sitzung erfüllt sind, entspricht der Nutzer den Kriterien. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Wenn die Kriterien durch Ereignisse für den Nutzer erfüllt werden, entspricht der Nutzer den Kriterien. |
SegmentFilterExpression
Kombinationen von Segmentfiltern.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld expr. Geben Sie einen Filtertyp für SegmentFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Die SegmentFilterExpression in |
orGroup |
Die SegmentFilterExpression in |
notExpression |
Der SegmentFilterExpression ist NICHT vom Typ |
segmentFilter |
Ein einfacher Segmentfilter. |
segmentEventFilter |
Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen. |
SegmentFilterExpressionList
Eine Liste mit Segmentfilterausdrücken.
| JSON-Darstellung |
|---|
{
"expressions": [
{
object ( |
| Felder | |
|---|---|
expressions[] |
Die Liste der Segmentfilterausdrücke |
SegmentFilter
Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.
| JSON-Darstellung |
|---|
{ "fieldName": string, "filterScoping": { object ( |
| Felder | |
|---|---|
fieldName |
Der Name der Dimension oder des Messwerts. |
filterScoping |
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 |
Filter für Strings. |
inListFilter |
Ein Filter für Werte in der Liste. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für einen Bereich zwischen zwei Werten. |
SegmentFilterScoping
Mit Bereichen wird angegeben, wie die Dimensionen und Messwerte mehrerer Ereignisse bei der Auswertung eines Segmentfilters berücksichtigt werden sollen.
| JSON-Darstellung |
|---|
{ "atAnyPointInTime": boolean } |
| Felder | |
|---|---|
atAnyPointInTime |
Wenn Dieser
Wenn der Bereich der Kriterien |
SegmentEventFilter
Erstellt einen Filter, der mit Ereignissen eines einzelnen Ereignisnamens übereinstimmt. Wenn ein Parameterfilterausdruck angegeben ist, entspricht dieser Ereignisfilter nur der Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen.
| JSON-Darstellung |
|---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
| Felder | |
|---|---|
eventName |
Dieser Filter entspricht Ereignissen mit diesem einzelnen Ereignisnamen. Ereignisname erforderlich. |
segmentParameterFilterExpression |
Wenn angegeben, werden mit diesem Filter Ereignisse abgeglichen, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen. Im Parameterfilterausdruck sind nur Parameterfilter verfügbar. |
SegmentParameterFilterExpression
Kombinationen von Segmentfiltern für Parameter.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld expr. Geben Sie einen Filtertyp für SegmentParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Die SegmentParameterFilterExpression in |
orGroup |
Die SegmentParameterFilterExpression in |
notExpression |
Der SegmentParameterFilterExpression ist NICHT vom Typ |
segmentParameterFilter |
Ein einfacher Segmentparameterfilter. |
SegmentParameterFilterExpressionList
Eine Liste mit Filterausdrücken für Segmentparameter.
| JSON-Darstellung |
|---|
{
"expressions": [
{
object ( |
| Felder | |
|---|---|
expressions[] |
Die Liste der Filterausdrücke für Segmentparameter. |
SegmentParameterFilter
Ein Ausdruck zum Filtern von Parameterwerten in einem Segment.
| JSON-Darstellung |
|---|
{ "filterScoping": { object ( |
| Felder | |
|---|---|
filterScoping |
Gibt den Umfang für den Filter an. |
Union-Feld one_parameter. Das Feld, nach dem gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig: |
|
eventParameterName |
Dieser Filter wird für den angegebenen Ereignisparameter ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Zu den Ereignisparametern gehören Felder wie „firebase_screen“ und „currency“. Ereignisparameter können nur in Segmenten und Trichteranalysen verwendet werden und nur in einem untergeordneten Filter von einem EventFilter. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. |
itemParameterName |
Dieser Filter wird anhand des angegebenen Artikelparameters ausgewertet. Artikelparameter werden als Parameter im Artikelarray protokolliert. Zu den Artikelparametern gehören Felder wie „item_name“ und „item_category“. Artikelparameter können nur in Segmenten und Trichteranalysen verwendet werden und nur in einem untergeordneten Filter von einem EventFilter. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. Artikelparameter sind nur in E-Commerce-Ereignissen verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie im Leitfaden E-Commerce messen. |
Union-Feld one_filter. Geben Sie einen Filtertyp an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Filter für Strings. |
inListFilter |
Ein Filter für Werte in der Liste. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für einen Bereich zwischen zwei Werten. |
SegmentParameterFilterScoping
Mit Bereichseinstellungen wird festgelegt, wie mehrere Ereignisse bei der Auswertung eines Segmentparameterfilters berücksichtigt werden sollen.
| JSON-Darstellung |
|---|
{ "inAnyNDayPeriod": string } |
| Felder | |
|---|---|
inAnyNDayPeriod |
Der Parameter wird über den angegebenen Zeitraum hinweg kumuliert, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Bereich der Kriterien Wenn Der Zeitraum wird nicht verlängert, um ein vollständiges N-Tage-Fenster in der Nähe des Startdatums zu erhalten. Wenn ein Bericht beispielsweise für den Zeitraum vom 01.11.2021 bis zum 10.11.2021 erstellt wird und
|
UserSegmentSequenceGroup
Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge auftreten müssen, damit der Nutzer Mitglied des Segments wird.
| JSON-Darstellung |
|---|
{ "sequenceScoping": enum ( |
| Felder | |
|---|---|
sequenceScoping |
Alle Sequenzschritte müssen im Bereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Wenn Optional. Wenn nichts angegeben ist, wird |
sequenceMaximumDuration |
Definiert den Zeitraum, in dem die gesamte Sequenz ablaufen muss, z. B. 30 Minuten.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
userSequenceSteps[] |
Eine geordnete Abfolge von Bedingungsschritten. Die Ereignisse eines Nutzers müssen jeden Schritt durchlaufen, damit der Nutzer der |
UserSequenceStep
Eine Bedingung, die im angegebenen Schritt auftreten muss, damit dieser Nutzer der Sequenz entspricht.
| JSON-Darstellung |
|---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
| Felder | |
|---|---|
isDirectlyFollowedBy |
Wenn „true“ (wahr), muss das Ereignis, das diesen Schritt erfüllt, das unmittelbar nächste Ereignis nach dem Ereignis sein, das den letzten Schritt erfüllt. Wenn „false“, folgt dieser Schritt indirekt auf den vorherigen Schritt. Zwischen dem vorherigen und diesem Schritt können beispielsweise Ereignisse auftreten. |
stepScoping |
Dieser Sequenzschritt muss im Bereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Wenn Optional. Wenn nichts angegeben ist, verwendet |
segmentFilterExpression |
Ein Nutzer entspricht diesem Sequenzschritt, wenn seine Ereignisse mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter an. |
UserSegmentExclusion
Gibt an, welche Nutzer in diesem Segment ausgeschlossen werden.
| JSON-Darstellung |
|---|
{ "userExclusionDuration": enum ( |
| Felder | |
|---|---|
userExclusionDuration |
Gibt an, wie lange ein Ausschluss dauert, wenn ein Nutzer mit Optional. Wenn nichts angegeben ist, wird |
userExclusionCriteria |
Wenn ein Nutzer diese Bedingung erfüllt, wird er für den Zeitraum |
UserExclusionDuration
Hier werden die Optionen für die Dauer eines Ausschlusses aufgeführt, wenn ein Nutzer der userExclusionCriteria entspricht.
| Enums | |
|---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Nicht angeben. |
USER_EXCLUSION_TEMPORARY |
Nutzer vorübergehend aus dem Segment ausschließen, wenn sie die userExclusionCriteria-Bedingung erfüllen. |
USER_EXCLUSION_PERMANENT |
Nutzer dauerhaft aus dem Segment ausschließen, wenn sie die Bedingung userExclusionCriteria erfüllen. |
SessionSegment
Sitzungssegmente sind Teilmengen der Sitzungen, die auf Ihrer Website oder in Ihrer App stattgefunden haben: etwa alle Sitzungen, die aus einer bestimmten Werbekampagne stammen.
| JSON-Darstellung |
|---|
{ "sessionInclusionCriteria": { object ( |
| Felder | |
|---|---|
sessionInclusionCriteria |
Definiert, welche Sitzungen in dieses Segment aufgenommen werden. Optional. |
exclusion |
Definiert, welche Sitzungen in diesem Segment ausgeschlossen werden. Optional. |
SessionSegmentCriteria
Eine Sitzung entspricht einem Kriterium, wenn die Ereignisse der Sitzung die Bedingungen des Kriteriums erfüllen.
| JSON-Darstellung |
|---|
{
"andConditionGroups": [
{
object ( |
| Felder | |
|---|---|
andConditionGroups[] |
Eine Sitzung entspricht diesen Kriterien, wenn sie mit jedem dieser |
SessionSegmentConditionGroup
Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.
| JSON-Darstellung |
|---|
{ "conditionScoping": enum ( |
| Felder | |
|---|---|
conditionScoping |
Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie der Bedingungsgruppe entsprechen. Dieser Bereich definiert, für wie viele Ereignisse das Optional. Wenn nichts angegeben ist, wird ein |
segmentFilterExpression |
Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter angegeben. |
SessionCriteriaScoping
Mit dem Bereich wird festgelegt, welche Ereignisse berücksichtigt werden, wenn geprüft wird, ob eine Sitzung ein Kriterium erfüllt.
| Enums | |
|---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Bereich für Kriterien. Nicht angeben. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, entspricht die Sitzung den Kriterien. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Wenn die Kriterien innerhalb einer Sitzung erfüllt sind, entspricht die Sitzung den Kriterien. |
SessionSegmentExclusion
Gibt an, welche Sitzungen in diesem Segment ausgeschlossen werden.
| JSON-Darstellung |
|---|
{ "sessionExclusionDuration": enum ( |
| Felder | |
|---|---|
sessionExclusionDuration |
Gibt an, wie lange ein Ausschluss gilt, wenn eine Sitzung mit dem Optional. Wenn nichts angegeben ist, wird ein |
sessionExclusionCriteria |
Wenn eine Sitzung diese Bedingung erfüllt, wird sie nicht in das Segment für die |
SessionExclusionDuration
Listet Optionen für die Dauer eines Ausschlusses auf, wenn eine Sitzung mit dem sessionExclusionCriteria übereinstimmt.
| Enums | |
|---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Nicht angeben. |
SESSION_EXCLUSION_TEMPORARY |
Sitzungen vorübergehend aus dem Segment ausschließen, wenn sie die sessionExclusionCriteria-Bedingung erfüllen. |
SESSION_EXCLUSION_PERMANENT |
Sitzungen dauerhaft aus dem Segment ausschließen, wenn die sessionExclusionCriteria-Bedingung jemals erfüllt ist. |
EventSegment
Ereignissegmente sind Teilmengen von Ereignissen, die auf Ihrer Website oder in Ihrer App ausgelöst wurden: etwa alle Kaufereignisse, die am selben Standort erfolgt sind, oder „app_exception“-Ereignisse, die unter einem bestimmten Betriebssystem aufgetreten sind.
| JSON-Darstellung |
|---|
{ "eventInclusionCriteria": { object ( |
| Felder | |
|---|---|
eventInclusionCriteria |
Definiert, welche Ereignisse in diesem Segment enthalten sind. Optional. |
exclusion |
Definiert, welche Ereignisse in diesem Segment ausgeschlossen werden. Optional. |
EventSegmentCriteria
Ein Ereignis entspricht einem Kriterium, wenn es die Bedingungen des Kriteriums erfüllt.
| JSON-Darstellung |
|---|
{
"andConditionGroups": [
{
object ( |
| Felder | |
|---|---|
andConditionGroups[] |
Ein Ereignis entspricht diesen Kriterien, wenn es mit jedem dieser |
EventSegmentConditionGroup
Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.
| JSON-Darstellung |
|---|
{ "conditionScoping": enum ( |
| Felder | |
|---|---|
conditionScoping |
Optional. Wenn nichts angegeben ist, wird ein |
segmentFilterExpression |
Daten werden in das Segment einbezogen oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter an. |
EventCriteriaScoping
Mit dem Bereich wird festgelegt, welche Ereignisse berücksichtigt werden, wenn geprüft wird, ob ein Ereignis ein Kriterium erfüllt.
| Enums | |
|---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Bereich für Kriterien. Nicht angeben. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, entspricht das Ereignis den Kriterien. |
EventSegmentExclusion
Gibt an, welche Ereignisse in diesem Segment ausgeschlossen werden.
| JSON-Darstellung |
|---|
{ "eventExclusionDuration": enum ( |
| Felder | |
|---|---|
eventExclusionDuration |
Optional. Wenn nichts angegeben ist, wird ein |
eventExclusionCriteria |
Wenn ein Ereignis diese Bedingung erfüllt, wird es für die |
EventExclusionDuration
Hier werden die Optionen für die Dauer eines Ausschlusses aufgelistet, wenn ein Ereignis mit eventExclusionCriteria übereinstimmt.
| Enums | |
|---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Nicht angeben. |
EVENT_EXCLUSION_PERMANENT |
Ereignisse dauerhaft aus dem Segment ausschließen, wenn das Ereignis jemals die Bedingung eventExclusionCriteria erfüllt. |
FunnelSubReport
Die Unterberichte für Trichter enthalten die Datenwerte für Dimensionen und Messwerte. Beispiel: 12 Nutzer haben den zweiten Schritt des Trichters erreicht.
| JSON-Darstellung |
|---|
{ "dimensionHeaders": [ { object ( |
| Felder | |
|---|---|
dimensionHeaders[] |
Beschreibt Dimensionsspalten. Trichterberichte enthalten immer die Dimension „Schritt im Trichter“ in den Antworten der Unterberichte. Falls angefordert, können in der Antwort zusätzliche Dimensionen wie Aufschlüsselungen, Datumsangaben und nächste Aktionen enthalten sein. |
metricHeaders[] |
Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in den Antworten der Unterberichte. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussrate, Abbrüche und Abbruchrate. |
rows[] |
Zeilen mit Kombinationen aus Dimensionswerten und Messwerten im Bericht. |
metadata |
Metadaten für den Trichterbericht. |
FunnelResponseMetadata
Die Antwortmetadaten des Trichterberichts enthalten zusätzliche Informationen zum Trichterbericht.
| JSON-Darstellung |
|---|
{
"samplingMetadatas": [
{
object ( |
| Felder | |
|---|---|
samplingMetadatas[] |
Wenn die Ergebnisse des Trichterberichts auf Stichproben basieren, wird hier der Prozentsatz der Ereignisse angegeben, die in diesem Trichterbericht verwendet wurden. Für jeden Zeitraum wird ein Wenn die Ergebnisse jedoch nicht auf Stichproben basieren, ist dieses Feld nicht definiert. |