- 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!
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 |
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 ( |
Felder | |
---|---|
date |
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 |
Optional. Die Konfiguration des Trichters dieser Anfrage. Diese Trichterkonfiguration ist erforderlich. |
funnel |
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 |
funnel |
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 Für die nächste Aktion werden nur |
funnel |
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 |
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 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. Die API kann auch weniger Zeilen als die angeforderte |
dimension |
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. |
return |
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 ( |
Felder | |
---|---|
funnel |
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. |
funnel |
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 |
property |
Der Kontingentstatus dieser Analytics-Property, einschließlich dieser Anfrage. |
kind |
Gibt an, um welche Art von Ressource es sich bei dieser Nachricht handelt. Diese |
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 ( |
Felder | |
---|---|
is |
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[] |
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 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 |
is |
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 |
filter |
Die Bedingung, die ein Nutzer erfüllen muss, um bei diesem Schritt im Trichter berücksichtigt zu werden. |
within |
Falls angegeben, muss dieser Schritt innerhalb dieser Dauer nach Abschluss des vorherigen Schritts abgeschlossen sein.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
FunnelFilterExpression
Gibt Kombinationen von Trichterfiltern an.
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: |
|
and |
Der Trichterfilterausdruck in |
or |
Der FunnelFilterExpression in |
not |
Der Trichterfilterausdruck ist KEIN |
funnel |
Trichterfilter für eine Dimension oder einen Messwert. |
funnel |
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 ( |
Felder | |
---|---|
expressions[] |
Liste der Trichterfilterausdrücke. |
FunnelFieldFilter
Ein Ausdruck zum Filtern von Dimensions- oder Messwertwerten.
JSON-Darstellung |
---|
{ "fieldName": string, // Union field |
Felder | |
---|---|
field |
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: |
|
string |
Filter für Strings. |
in |
Ein Filter für Werte in einer Liste. |
numeric |
Ein Filter für numerische oder Datumswerte. |
between |
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 ( |
Felder | |
---|---|
event |
Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich. |
funnel |
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 |
Felder | |
---|---|
Union-Feld expr . Geben Sie einen Filtertyp für FunnelParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
and |
Die Trichterparameterfilterausdrücke in |
or |
Der FunnelParameterFilterExpression in |
not |
Der Trichterparameterfilterausdruck ist KEIN |
funnel |
Ein einfacher Trichterparameterfilter. |
FunnelParameterFilterExpressionList
Eine Liste von Filterausdrücken für Trichterparameter.
JSON-Darstellung |
---|
{
"expressions": [
{
object ( |
Felder | |
---|---|
expressions[] |
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: |
|
event |
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. |
item |
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: |
|
string |
Filter für Strings. |
in |
Ein Filter für Werte in einer Liste. |
numeric |
Ein Filter für numerische oder Datumswerte. |
between |
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 ( |
Felder | |
---|---|
breakdown |
Die Dimensionsspalte, die der Antwort des untergeordneten Trichtertabellenberichts hinzugefügt wurde. Mit der Aufschlüsselungsdimension werden die einzelnen Trichterschritte aufgeschlüsselt. Ein gültiger |
limit |
Die maximale Anzahl der eindeutigen Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird |
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 ( |
Felder | |
---|---|
next |
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
|
limit |
Die maximale Anzahl der eindeutigen Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird |
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 |
Felder | |
---|---|
name |
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 |
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: |
|
user |
Nutzersegmente sind Teilmengen von Nutzern, die mit Ihrer Website oder App interagiert haben. |
session |
Sitzungssegmente sind Teilmengen der Sitzungen, die auf Ihrer Website oder in Ihrer App stattgefunden haben. |
event |
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 | |
---|---|
user |
Hier wird festgelegt, welche Nutzer in dieses Segment aufgenommen werden. Optional. |
exclusion |
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 ( |
Felder | |
---|---|
and |
Ein Nutzer erfüllt diese Kriterien, wenn er allen |
and |
Ein Nutzer erfüllt diese Kriterien, wenn er allen |
UserSegmentConditionGroup
Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.
JSON-Darstellung |
---|
{ "conditionScoping": enum ( |
Felder | |
---|---|
condition |
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 Optional. Wenn keine Angabe erfolgt, wird |
segment |
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 |
Felder | |
---|---|
Union-Feld expr . Geben Sie einen Filtertyp für SegmentFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
and |
Der SegmentFilterExpression in |
or |
Der SegmentFilterExpression in |
not |
Der SegmentFilterExpression ist KEIN |
segment |
Ein einfacher Segmentfilter. |
segment |
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 ( |
Felder | |
---|---|
expressions[] |
Liste der Segmentfilterausdrücke |
SegmentFilter
Ein Ausdruck zum Filtern von Dimensions- oder Messwertwerten.
JSON-Darstellung |
---|
{ "fieldName": string, "filterScoping": { object ( |
Felder | |
---|---|
field |
Der Name der Dimension oder des Messwerts. |
filter |
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: |
|
string |
Filter für Strings. |
in |
Ein Filter für Werte in einer Liste. |
numeric |
Ein Filter für numerische oder Datumswerte. |
between |
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 | |
---|---|
at |
Wenn Mit diesem Parameter wird der Zeitraum der Ereignisse im Bericht nicht erweitert. Diese Wenn der Kriterienbereich |
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 ( |
Felder | |
---|---|
event |
Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich. |
segment |
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 |
Felder | |
---|---|
Union-Feld expr . Geben Sie einen Filtertyp für SegmentParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
and |
Die SegmentParameterFilterExpression in |
or |
Der SegmentParameterFilterExpression in |
not |
Der SegmentParameterFilterExpression ist KEIN |
segment |
Ein primitiver Segmentparameterfilter. |
SegmentParameterFilterExpressionList
Eine Liste von Filterausdrücken für Segmentparameter.
JSON-Darstellung |
---|
{
"expressions": [
{
object ( |
Felder | |
---|---|
expressions[] |
Liste der Filterausdrücke für Segmentparameter. |
SegmentParameterFilter
Ein Ausdruck zum Filtern von Parameterwerten in einem Segment.
JSON-Darstellung |
---|
{ "filterScoping": { object ( |
Felder | |
---|---|
filter |
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: |
|
event |
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. |
item |
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: |
|
string |
Filter für Strings. |
in |
Ein Filter für Werte in einer Liste. |
numeric |
Ein Filter für numerische oder Datumswerte. |
between |
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 | |
---|---|
in |
Der Parameter wird über den angegebenen Zeitraum in Tagen erfasst, bevor der Filter angewendet wird. Nur unterstützt, wenn die Kriterienbegrenzung Wenn 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
|
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 ( |
Felder | |
---|---|
sequence |
Alle Schritte der Sequenz müssen im Umfang erfüllt sein, damit der Nutzer der Sequenz zugeordnet werden kann. Wenn beispielsweise Optional. Wenn keine Angabe erfolgt, wird |
sequence |
Hier wird der Zeitraum festgelegt, in dem die gesamte Sequenz ablaufen muss, z. B. 30 Minuten.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
user |
Eine geordnete Abfolge von bedingten Schritten. Die Ereignisse eines Nutzers müssen alle Schritte durchlaufen, damit der Nutzer mit der |
UserSequenceStep
Eine Bedingung, die in der angegebenen Schrittreihenfolge erfüllt werden muss, damit dieser Nutzer der Sequenz entspricht.
JSON-Darstellung |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Felder | |
---|---|
is |
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 |
step |
Dieser Sequenzschritt muss bei der Definition des Umfangs erfüllt sein, damit der Nutzer der Sequenz entspricht. Bei Optional. Wenn keine Angabe erfolgt, wird für |
segment |
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 ( |
Felder | |
---|---|
user |
Gibt an, wie lange eine Aussetzung dauert, wenn ein Nutzer mit der Optional. Wenn keine Angabe erfolgt, wird |
user |
Wenn ein Nutzer diese Bedingung erfüllt, wird er für den |
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 ( |
Felder | |
---|---|
session |
Hier wird festgelegt, welche Sitzungen in dieses Segment aufgenommen werden. Optional. |
exclusion |
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 ( |
Felder | |
---|---|
and |
Eine Sitzung erfüllt dieses Kriterium, wenn sie mit allen |
SessionSegmentConditionGroup
Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.
JSON-Darstellung |
---|
{ "conditionScoping": enum ( |
Felder | |
---|---|
condition |
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 Optional. Wenn keine Angabe erfolgt, wird ein |
segment |
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 ( |
Felder | |
---|---|
session |
Gibt an, wie lange eine Aus exclusion gültig ist, wenn eine Sitzung mit der Optional. Wenn keine Angabe erfolgt, wird ein |
session |
Wenn eine Sitzung diese Bedingung erfüllt, wird sie von der Mitgliedschaft im Segment für die |
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 ( |
Felder | |
---|---|
event |
Hier wird definiert, welche Ereignisse in dieses Segment aufgenommen werden. Optional. |
exclusion |
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 ( |
Felder | |
---|---|
and |
Ein Ereignis entspricht diesen Kriterien, wenn es mit allen |
EventSegmentConditionGroup
Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.
JSON-Darstellung |
---|
{ "conditionScoping": enum ( |
Felder | |
---|---|
condition |
Optional. Wenn keine Angabe erfolgt, wird ein |
segment |
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 ( |
Felder | |
---|---|
event |
Optional. Wenn keine Angabe erfolgt, wird ein |
event |
Wenn ein Ereignis diese Bedingung erfüllt, wird es nicht in das Segment für die |
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 ( |
Felder | |
---|---|
dimension |
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. |
metric |
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[] |
Zeilen mit Kombinationen von 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 | |
---|---|
sampling |
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 Wenn die Ergebnisse jedoch nicht Stichprobenerhebungen sind, ist dieses Feld nicht definiert. |