- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Trichter
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter (Trichterereignisfilter)
- 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
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- Testen!
Gibt einen benutzerdefinierten Trichterbericht mit Ihren Google Analytics-Ereignisdaten zurück. Die von der API zurückgegebenen Daten liegen in einer 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. Bitte geben Sie über dieses Formular Feedback zu dieser API.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
property |
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 die Property-ID finden In 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 ( |
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, werden die Ereignisdaten für die sich überschneidenden Tage in den Antwortzeilen für beide Zeiträume aufgeführt. |
funnel |
Optional. Die Konfiguration des Trichters dieser Anfrage. Diese Trichterkonfiguration ist erforderlich. |
funnelBreakdown |
Optional. Wenn angegeben, wird durch diese Aufschlüsselung der Antwort des Unterberichts der Trichtertabelle 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 „ |
funnelNextAction |
Optional. Wenn angegeben, wird mit der nächsten Aktion der Antwort des Teilberichts zur Trichtervisualisierung eine Dimension hinzugefügt. Mit dieser Dimension „Nächste Aktion“ erhalten Sie für jeden Trichterschritt eindeutige Werte für die nächste Aktion. Bei einer nächsten Aktion der Dimension Die nächste Aktion unterstützt nur |
funnelVisualizationType |
Optional. Mit dem Typ der Trichtervisualisierung werden die Dimensionen festgelegt, die in der Antwort des Teilberichts 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. Jedes in dieser Anfrage angegebene Segment generiert eine separate Zeile in der Antwort. In der Antwort wird jedes Segment mit seinem Namen gekennzeichnet. Der Segmentparameter ist optional. Anfragen sind auf 4 Segmente beschränkt. |
limit |
Optional. Die Anzahl der zurückzugebenden Zeilen. Wenn kein Wert angegeben ist, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen Sie anfordern. Die API kann auch weniger Zeilen als vom angeforderten |
dimensionFilter |
Optional. Mit Dimensionsfiltern können Sie im Bericht nur nach bestimmten Dimensionswerten fragen. Weitere Beispiele finden Sie unter Bericht erstellen: Dimensionsfilter. Messwerte können in diesem Filter nicht verwendet werden. |
returnPropertyQuota |
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 zum Trichterbericht enthält zwei Unterberichte. Die beiden untergeordneten Berichte enthalten verschiedene Kombinationen aus Dimensionen und Messwerten.
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "funnelTable": { object ( |
Felder | |
---|---|
funnelTable |
Die Trichtertabelle ist ein Bericht mit Trichterschritt, Segment, Aufschlüsselungsdimension, aktiven Nutzern, Abschlussrate, Ausstiegen und Ausstiegsrate. Die Dimension „Segment“ ist nur in dieser Antwort vorhanden, wenn ein Segment angefordert wurde. Die Aufschlüsselungsdimension ist nur in dieser Antwort vorhanden, wenn sie angefordert wurde. |
funnelVisualization |
Die Trichtervisualisierung ist ein Bericht mit Trichterschritt, Segment, Datum, Dimension „Nächste Aktion“ und aktiven Nutzern. Die Dimension „Segment“ ist nur in dieser Antwort vorhanden, wenn ein Segment angefordert wurde. Die Datumsdimension ist nur in dieser Antwort vorhanden, wenn sie über den Trichtertyp |
propertyQuota |
Der Kontingentstatus dieser Analytics-Property, einschließlich dieser Anfrage. |
kind |
Gibt an, um welche Art von Ressource diese Nachricht handelt. Dieser |
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. Ein Trichter erfasst Nutzer in einer Abfolge von Schritten.
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 jedem beliebigen Punkt betreten, bei einem geschlossenen dagegen als Erstes. Optional. Wenn kein Wert angegeben ist, wird ein geschlossener Trichter verwendet. |
steps[] |
Die aufeinanderfolgenden Schritte dieses Trichters. |
FunnelStep
Mit Schritten wird der Kaufprozess definiert, den Sie analysieren möchten. Schritte enthalten eine oder mehrere Bedingungen, die Nutzer erfüllen müssen, um in diesen Schritt des Trichters aufgenommen zu werden.
JSON-Darstellung |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Felder | |
---|---|
name |
Der eindeutige Name für diesen Schritt. Wenn Sie nichts angeben, werden die Schritte nach einem 1-basierten indexierten Namen benannt (z. B. „0. ", "1. usw.). Dieser Name definiert den Stringwert, der von der Dimension |
isDirectlyFollowedBy |
Bei „true“ 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 |
filterExpression |
Die Bedingung, die Nutzer erfüllen müssen, um in diesen Schritt des Trichterpfads aufgenommen zu werden. |
withinDurationFromPriorStep |
Wenn angegeben, muss dieser Schritt innerhalb dieser Dauer nach Abschluss des vorherigen Schritts abgeschlossen werden.
Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
FunnelFilterExpression
drückt Kombinationen von Trichterfiltern aus.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Geben Sie eine Filterart für FunnelFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Die FunnelFilterExpression in |
orGroup |
Die FunnelFilterExpression in |
notExpression |
FunnelFilterExpression ist NICHT |
funnelFieldFilter |
Ein Trichterfilter für eine Dimension oder einen Messwert. |
funnelEventFilter |
Erstellt einen Filter, der den Ereignissen eines einzelnen Ereignisnamens entspricht. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. |
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 |
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 zum Thema Strings. |
inListFilter |
Ein Filter für in Listenwerten. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwischen zwei Werten. |
FunnelEventFilter
Erstellt einen Filter, der den Ereignissen eines einzelnen Ereignisnamens entspricht. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.
JSON-Darstellung |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Felder | |
---|---|
eventName |
Dieser Filter stimmt mit Ereignissen dieses einzelnen Ereignisnamens überein. Ereignisname ist erforderlich. |
funnelParameterFilterExpression |
Wenn angegeben, ermittelt dieser Filter Ereignisse, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar. |
FunnelParameterFilterExpression
Drückt Kombinationen von Trichterfiltern für Parameter aus.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Geben Sie eine Filterart für FunnelParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Der Parameter "FunnelParameterFilterExpression" in |
orGroup |
Die Parameter "FunnelParameterFilterExpression" in |
notExpression |
FunnelParameterFilterExpression ist NICHT |
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, das gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig: |
|
eventParameterName |
Dieser Filter wird anhand des angegebenen Ereignisparameters 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 und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. |
itemParameterName |
Dieser Filter wird anhand des angegebenen „item“-Parameters ausgewertet. Artikelparameter werden im „item“-Array als Parameter protokolliert. Zu Artikelparametern gehören Felder wie „item_name“ und „item_category“. Artikelparameter können nur in Segmenten und Trichtern und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. Artikelparameter sind nur für E-Commerce-Ereignisse 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 zum Thema Strings. |
inListFilter |
Ein Filter für in Listenwerten. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwischen zwei Werten. |
FunnelBreakdown
Durch Aufschlüsselungen wird der Antwort des Unterberichts der Trichtertabelle eine Dimension hinzugefügt.
JSON-Darstellung |
---|
{
"breakdownDimension": {
object ( |
Felder | |
---|---|
breakdownDimension |
Die Dimensionsspalte, die der Antwort des Unterberichts der Trichtertabelle hinzugefügt wurde. Mit der Aufschlüsselungsdimension werden die einzelnen Schritte im Trichter aufgeschlüsselt. Ein gültiger |
limit |
Die maximale Anzahl unterschiedlicher Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird für |
FunnelNextAction
Unter „Nächste Aktionen“ wird der Wert für eine Dimension angegeben, nachdem der Nutzer einen Schritt erreicht hat, aber bevor er den nächsten Schritt erreicht hat. Wenn nextActionDimension
beispielsweise eventName
ist, gibt nextActionDimension
in der i
. Zeile des Trichterschritts das erste Ereignis nach dem Ereignis zurück, durch das der Nutzer zum i
. Schritt des Trichters qualifiziert wurde, aber vor dem i+1
. Schritt.
JSON-Darstellung |
---|
{
"nextActionDimension": {
object ( |
Felder | |
---|---|
nextActionDimension |
Die Dimensionsspalte, die der Antwort des Teilberichts 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 unterschiedlicher Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird für |
FunnelVisualizationType
Mit dieser Richtlinie werden die Dimensionen in der Antwort auf den Teilbericht zur Trichtervisualisierung gesteuert.
Enums | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Nicht definierter Typ. |
STANDARD_FUNNEL |
Ein Standardtrichter (mit Schritten). Der Teilbericht zur 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 GA4 Segment Builder.
JSON-Darstellung |
---|
{ "name": string, // Union field |
Felder | |
---|---|
name |
Der Name für dieses Segment. Wenn keine Vorgabe erfolgt, erhalten die Segmente den Namen „Segment“. Dieser Name definiert den Stringwert, der von der Dimension |
Union-Feld one_segment_scope . In einem Bereich ist ein Segment 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 mit Ihrer Website oder App interagiert haben, z. B. Nutzer, die bereits etwas gekauft oder Artikel in den Einkaufswagen gelegt, aber keinen Kauf abgeschlossen haben.
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 erfüllt ein Kriterium, wenn seine Ereignisse die Bedingungen des Kriteriums erfüllen.
JSON-Darstellung |
---|
{ "andConditionGroups": [ { object ( |
Felder | |
---|---|
andConditionGroups[] |
Ein Nutzer erfüllt diese Kriterien, wenn er jeder dieser |
andSequenceGroups[] |
Ein Nutzer erfüllt diese Kriterien, wenn er jeder dieser |
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 je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen, in das Segment ein- oder daraus ausgeschlossen. Dieser Gültigkeitsbereich definiert, für wie viele Ereignisse der Optional. Wenn kein Wert angegeben ist, wird |
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 festgelegt. |
UserCriteriaScoping
Mit dem Umfang wird festgelegt, welche Ereignisse bei der Bewertung, ob ein Nutzer ein Kriterium erfüllt, berücksichtigt werden.
Enums | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Kriterienbereich nicht angegeben. Keine Angabe. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt der Nutzer sie. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Wenn die Kriterien innerhalb einer Sitzung erfüllt werden, erfüllt der Nutzer sie. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Wenn Ereignisse für den Nutzer die Kriterien erfüllen, erfüllt er die Kriterien. |
SegmentFilterExpression
Drückt Kombinationen von Segmentfiltern aus.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Geben Sie eine Filterart für SegmentFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
SegmentFilterExpression in |
orGroup |
Die SegmentFilterExpression in |
notExpression |
SegmentFilterExpression ist NICHT |
segmentFilter |
Ein einfacher Segmentfilter. |
segmentEventFilter |
Erstellt einen Filter, der den Ereignissen eines einzelnen Ereignisnamens entspricht. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. |
SegmentFilterExpressionList
Eine Liste mit Segmentfilterausdrücken.
JSON-Darstellung |
---|
{
"expressions": [
{
object ( |
Felder | |
---|---|
expressions[] |
Liste der Segmentfilterausdrücke |
SegmentFilter
Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.
JSON-Darstellung |
---|
{ "fieldName": string, "filterScoping": { object ( |
Felder | |
---|---|
fieldName |
Name der Dimension oder des Messwerts |
filterScoping |
Gibt den Bereich für den Filter an. |
Union-Feld one_filter . Geben Sie eine Filterart für Filter an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Filter zum Thema Strings. |
inListFilter |
Ein Filter für in Listenwerten. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwischen zwei Werten. |
SegmentFilterScoping
Über Bereiche legen Sie fest, wie die Dimensionen und Messwerte mehrerer Ereignisse bei der Auswertung eines Segmentfilters berücksichtigt werden.
JSON-Darstellung |
---|
{ "atAnyPointInTime": boolean } |
Felder | |
---|---|
atAnyPointInTime |
Wenn Durch diesen Diese Ist der Kriterienbereich |
SegmentEventFilter
Erstellt einen Filter, der den Ereignissen eines einzelnen Ereignisnamens entspricht. Wenn ein Parameterfilterausdruck angegeben ist, stimmt nur die Teilmenge der Ereignisse mit diesem Ereignisfilter überein, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen.
JSON-Darstellung |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Felder | |
---|---|
eventName |
Dieser Filter stimmt mit Ereignissen dieses einzelnen Ereignisnamens überein. Ereignisname ist erforderlich. |
segmentParameterFilterExpression |
Wenn angegeben, ermittelt dieser Filter Ereignisse, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar. |
SegmentParameterFilterExpression
Drückt Kombinationen von Segmentfiltern für Parameter aus.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Geben Sie eine Filterart für SegmentParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
SegmentParameterFilterExpression in |
orGroup |
SegmentParameterFilterExpression in |
notExpression |
SegmentParameterFilterExpression ist NICHT |
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 Bereich 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 |
Dieser Filter wird anhand des angegebenen Ereignisparameters 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 und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. |
itemParameterName |
Dieser Filter wird anhand des angegebenen „item“-Parameters ausgewertet. Artikelparameter werden im „item“-Array als Parameter protokolliert. Zu Artikelparametern gehören Felder wie „item_name“ und „item_category“. Artikelparameter können nur in Segmenten und Trichtern und nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Artikelparameter verwendet werden. Artikelparameter sind nur für E-Commerce-Ereignisse 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 zum Thema Strings. |
inListFilter |
Ein Filter für in Listenwerten. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwischen zwei Werten. |
SegmentParameterFilterScoping
Über Bereiche legen Sie fest, wie mehrere Ereignisse bei der Auswertung eines Segmentparameterfilters berücksichtigt werden.
JSON-Darstellung |
---|
{ "inAnyNDayPeriod": string } |
Felder | |
---|---|
inAnyNDayPeriod |
Der Parameter wird im angegebenen Zeitraum von Tagen gesammelt, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Kriterienbereich Beispiel: Wenn Der Zeitraum wird nicht zwecks eines Zeitfensters von n Tagen vor Beginn des Zeitraums erweitert. Beispiel: Wenn ein Bericht für den Zeitraum vom 01.11.2021 bis zum 10.11.2021 gilt und
|
UserSegmentSequenceGroup
Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge auftreten müssen, damit der User Mitglied des Segments wird.
JSON-Darstellung |
---|
{ "sequenceScoping": enum ( |
Felder | |
---|---|
sequenceScoping |
Alle Sequenzschritte müssen im Bereich erfüllt sein, damit der Nutzer der Sequenz entsprechen kann. Wenn beispielsweise Optional. Wenn kein Wert angegeben ist, wird |
sequenceMaximumDuration |
Definiert den Zeitraum, in dem die gesamte Sequenz stattfinden muss, z. B. 30 Minuten.
Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
userSequenceSteps[] |
Eine geordnete Abfolge von Bedingungsschritten. Die Ereignisse eines Nutzers müssen jeden Schritt abschließen, damit der Nutzer dem |
UserSequenceStep
Eine Bedingung, die in der angegebenen Schrittreihenfolge eintreten muss, damit der Nutzer der Sequenz entspricht.
JSON-Darstellung |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Felder | |
---|---|
isDirectlyFollowedBy |
Bei „true“ 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 Ereignisse zwischen dem vorherigen Schritt und diesem Schritt auftreten. |
stepScoping |
Dieser Sequenzschritt muss innerhalb des Gültigkeitsbereichs erfüllt sein, damit der Nutzer der Sequenz zuordnen kann. Wenn beispielsweise Optional. Wenn kein Wert angegeben ist, verwendet |
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 festgelegt. |
UserSegmentExclusion
Gibt an, welche Nutzer in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "userExclusionDuration": enum ( |
Felder | |
---|---|
userExclusionDuration |
Gibt an, wie lange ein Ausschluss gilt, wenn ein Nutzer mit der Optional. Wenn kein Wert angegeben ist, wird |
userExclusionCriteria |
Wenn ein Nutzer diese Bedingung erfüllt, wird er von der Mitgliedschaft im Segment für |
UserExclusionDuration
Listet Optionen auf, die festlegen, wie lange ein Ausschluss gilt, wenn ein Nutzer mit dem userExclusionCriteria
übereinstimmt.
Enums | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
USER_EXCLUSION_TEMPORARY |
Sie können Nutzer vorübergehend aus dem Segment ausschließen, wenn sie die Bedingung userExclusionCriteria 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 ( |
Felder | |
---|---|
sessionInclusionCriteria |
Definiert, welche Sitzungen in diesem Segment enthalten sind. Optional. |
exclusion |
Definiert, welche Sitzungen in diesem Segment ausgeschlossen werden. Optional. |
SessionSegmentCriteria
Eine Sitzung entspricht einem Kriterium, wenn die darin enthaltenen Ereignisse die Bedingungen des Kriteriums erfüllen.
JSON-Darstellung |
---|
{
"andConditionGroups": [
{
object ( |
Felder | |
---|---|
andConditionGroups[] |
Eine Sitzung erfüllt diese Kriterien, wenn sie jeder 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 je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen, in das Segment ein- oder daraus ausgeschlossen. Dieser Gültigkeitsbereich definiert, für wie viele Ereignisse der Optional. Wenn kein Wert angegeben ist, wird |
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 festgelegt. |
SessionCriteriaScoping
Mit dem Umfang wird festgelegt, welche Ereignisse bei der Bewertung einer Sitzung berücksichtigt werden, die ein Kriterium erfüllt.
Enums | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Kriterienbereich nicht angegeben. Keine Angabe. |
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, erfüllt auch die Sitzung die Kriterien. |
SessionSegmentExclusion
Gibt an, welche Sitzungen in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "sessionExclusionDuration": enum ( |
Felder | |
---|---|
sessionExclusionDuration |
Gibt an, wie lange ein Ausschluss andauert, wenn eine Sitzung mit dem Optional. Wenn kein Wert angegeben ist, wird |
sessionExclusionCriteria |
Wenn eine Sitzung diese Bedingung erfüllt, wird sie von der Mitgliedschaft im Segment für |
SessionExclusionDuration
Listet Optionen auf, die festlegen, wie lange ein Ausschluss andauert, wenn eine Sitzung mit dem sessionExclusionCriteria
übereinstimmt.
Enums | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
SESSION_EXCLUSION_TEMPORARY |
Sitzungen in Zeiträumen, in denen die Sitzung die Bedingung sessionExclusionCriteria erfüllt, vorübergehend aus dem Segment ausschließen. |
SESSION_EXCLUSION_PERMANENT |
Sitzungen werden dauerhaft aus dem Segment ausgeschlossen, 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 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 erfüllt diese Kriterien, wenn es jedem der folgenden |
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 kein Wert angegeben ist, wird |
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 festgelegt. |
EventCriteriaScoping
Mit der Definition des Umfangs wird festgelegt, welche Ereignisse bei der Bewertung, ob ein Ereignis ein Kriterium erfüllt, berücksichtigt werden.
Enums | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Kriterienbereich nicht angegeben. Keine Angabe. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien für ein Ereignis erfüllt sind, erfüllt es auch das Ereignis. |
EventSegmentExclusion
Gibt an, welche Ereignisse in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "eventExclusionDuration": enum ( |
Felder | |
---|---|
eventExclusionDuration |
Optional. Wenn kein Wert angegeben ist, wird |
eventExclusionCriteria |
Wenn ein Ereignis diese Bedingung erfüllt, wird es von der Mitgliedschaft im Segment für |
EventExclusionDuration
Listet Optionen auf, über die festgelegt wird, wie lange ein Ausschluss angewendet wird, wenn ein Ereignis mit eventExclusionCriteria
übereinstimmt.
Enums | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
EVENT_EXCLUSION_PERMANENT |
Ereignisse werden dauerhaft aus dem Segment ausgeschlossen, falls sie die Bedingung eventExclusionCriteria erfüllen. |
FunnelSubReport
Trichter-Teilberichte enthalten die Datenwerte für Dimensionen und Messwerte. Beispielsweise haben 12 Nutzer den zweiten Schritt des Trichters erreicht.
JSON-Darstellung |
---|
{ "dimensionHeaders": [ { object ( |
Felder | |
---|---|
dimensionHeaders[] |
Beschreibt Dimensionsspalten. Trichterberichte enthalten in Antworten auf untergeordnete Berichte immer die Dimension „Trichterschritt“. Auf Anfrage können zusätzliche Dimensionen wie Aufschlüsselungen, Daten und nächste Aktionen in der Antwort enthalten sein. |
metricHeaders[] |
Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in Antworten von Unterberichten. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussrate, Ausstiege und Ausstiegsrate. |
rows[] |
Zeilen mit Dimensionswertkombinationen 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[] |
Falls die Ergebnisse des Trichterberichts Stichproben sind, gibt dies Aufschluss darüber, welcher Prozentsatz der Ereignisse in diesem Trichterbericht verwendet wurde. Für jeden Zeitraum wird eine Wenn die Ergebnisse jedoch nicht auf Stichproben basieren, wird dieses Feld nicht definiert. |
SamplingMetadata
Wenn die Ergebnisse des Trichterberichts Stichproben sind, geben diese Metadaten an, welcher Prozentsatz der Ereignisse in diesem Trichterbericht für einen bestimmten Zeitraum verwendet wurde. Als Stichprobenerhebung wird eine Teilmenge aller Daten analysiert, um aussagekräftige Informationen in einem größeren Dataset zu gewinnen.
JSON-Darstellung |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Felder | |
---|---|
samplesReadCount |
Gesamtzahl der Ereignisse, die in diesem Stichprobenbericht für einen Zeitraum gelesen wurden. Dies ist die Größe der Teilmenge der Daten dieser Property, die in diesem Trichterbericht analysiert wurden. |
samplingSpaceSize |
Die Gesamtzahl der Ereignisse in den Daten dieser Property, die in diesem Trichterbericht für einen bestimmten Zeitraum hätten analysiert werden können. Durch die Stichprobenerhebung werden wichtige Informationen über das größere Dataset ermittelt. Dies ist die Größe des größeren Datensatzes. Um den Prozentsatz der verfügbaren Daten zu berechnen, der in diesem Trichterbericht verwendet wurde, berechnen Sie |
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 „Ressource erschöpft“ zurückgegeben.
JSON-Darstellung |
---|
{ "tokensPerDay": { object ( |
Felder | |
---|---|
tokensPerDay |
Für Standard-Analytics-Properties sind bis zu 200.000 Tokens pro Tag zulässig, für Analytics 360-Properties dagegen 2.000.000 Tokens pro Tag. Die meisten Anfragen benötigen weniger als 10 Tokens. |
tokensPerHour |
Für Analytics-Standard-Properties sind bis zu 40.000 Tokens pro Stunde zulässig, für Analytics 360-Properties dagegen 400.000 Tokens pro Stunde. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen Stunden-, Tages- und Projektkontingenten abgezogen wird. |
concurrentRequests |
Standard-Analytics-Properties können bis zu 10 gleichzeitige Anfragen senden, Analytics 360-Properties bis zu 50 gleichzeitige Anfragen. |
serverErrorsPerProjectPerHour |
Paare von standardmäßigen Analytics-Properties und Cloud-Projekten können bis zu 10 Serverfehler pro Stunde haben. Paare von Analytics 360-Properties und Cloud-Projekten können bis zu 50 Serverfehler pro Stunde haben. |
potentiallyThresholdedRequestsPerHour |
Analytics-Properties können bis zu 120 Anfragen mit Dimensionen mit möglicherweise Grenzwerten pro Stunde senden. Bei Batchanfragen wird jede Berichtsanfrage für dieses Kontingent einzeln gezählt, wenn die Anfrage Dimensionen mit potenziell Grenzwerten enthält. |
tokensPerProjectPerHour |
Analytics-Properties können bis zu 35% ihrer Tokens pro Projekt und Stunde verwenden. Für standardmäßige Analytics-Properties sind also bis zu 14.000 Tokens pro Projekt und Stunde möglich, während für Analytics 360-Properties 140.000 Tokens pro Projekt und Stunde möglich sind. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen Stunden-, Tages- und Projektkontingenten abgezogen wird. |
QuotaStatus
Aktueller Status für eine bestimmte Kontingentgruppe.
JSON-Darstellung |
---|
{ "consumed": integer, "remaining": integer } |
Felder | |
---|---|
consumed |
Von dieser Anfrage verbrauchtes Kontingent. |
remaining |
Nach dieser Anfrage verbleibendes Kontingent. |