- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Trichter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelStep
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelFieldFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelEventFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelParameterFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelParameterFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelParameterFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelBreakdown
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelNextAction
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelVisualizationType
- Segmentieren
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserSegmentCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserSegmentConditionGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserCriteriaScoping
- SegmentFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentFilterScoping
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentEventFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentParameterFilterExpression
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentParameterFilterExpressionList
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentParameterFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SegmentParameterFilterScoping
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserSegmentSequenceGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserSequenceStep
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserSegmentExclusion
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- UserExclusionDuration
- SessionSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SessionSegmentCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SessionSegmentConditionGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SessionCriteriaScoping
- SessionSegmentExclusion
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SessionExclusionDuration
- EventSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- EventSegmentCriteria
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- EventSegmentConditionGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- EventCriteriaScoping
- EventSegmentExclusion
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- EventExclusionDuration
- FunnelSubReport
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FunnelResponseMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SamplingMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- PropertyQuota
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- QuotaStatus
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Testen!
Gibt einen benutzerdefinierten Trichterbericht mit Ihren Google Analytics-Ereignisdaten zurück. Von der API wird eine Tabelle mit Spalten für die angeforderten Dimensionen und Messwerte zurückgegeben.
Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden. Wie werden z. B. aus potenziellen Kunden Besucher und letztendlich Käufer? Wie werden Neukunden zu Bestandskunden? Anhand dieser Informationen können Sie dann entsprechende Optimierungen vornehmen. Weitere Informationen
Diese Methode wird in der Alpha-Entwicklungsphase eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Füllen Sie dieses Formular aus, um Feedback zu dieser API zu geben.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
property |
Optional. Eine Google Analytics GA4-Property-ID, deren Ereignisse erfasst werden. Wird im URL-Pfad und nicht im Text angegeben. Weitere Informationen dazu, wo Sie Ihre Property-ID finden Innerhalb einer Batchanfrage sollte dieses Attribut entweder nicht angegeben sein oder mit dem Attribut auf Batchebene übereinstimmen. Beispiel: properties/1234 |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "dateRanges": [ { object ( |
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 angezeigt. |
funnel |
Optional. Die Konfiguration des Trichters für diese Anfrage. Diese Trichterkonfiguration ist erforderlich. |
funnelBreakdown |
Optional. Wenn angegeben, wird durch diese Aufschlüsselung eine Dimension zur Antwort des Teilberichts in der Trichtertabelle hinzugefügt. Mit dieser Aufschlüsselungsdimension werden die einzelnen Trichterschritte auf die eindeutigen Werte der Aufschlüsselungsdimension erweitert. Bei einer Aufschlüsselung nach der Dimension |
funnelNextAction |
Optional. Falls angegeben, wird mit der nächsten Aktion der Antwort des untergeordneten Berichts „Trichtervisualisierung“ eine Dimension hinzugefügt. Bei dieser Dimension „Nächste Aktion“ werden die einzelnen Trichterschritte auf die eindeutigen Werte der nächsten Aktion erweitert. Bei einer nächsten Aktion der Dimension Die nächste Aktion unterstützt nur |
funnelVisualizationType |
Optional. Mit dem Typ „Trichtervisualisierung“ werden die Dimensionen gesteuert, die in der Antwort des untergeordneten Berichts „Trichtervisualisierung“ enthalten sind. Falls nichts angegeben wird, wird |
segments[] |
Optional. Die Konfigurationen der Segmente. Segmente sind Teilmengen der Daten einer Property. In einem Trichterbericht mit Segmenten wird der Trichter in jedem Segment bewertet. Jedes in dieser Anfrage angegebene Segment erzeugt eine separate Zeile in der Antwort. in der Antwort jedes durch seinen Namen identifizierte Segment. Der Parameter „Segmente“ ist optional. Anfragen sind auf vier Segmente beschränkt. |
limit |
Optional. Die Anzahl der zurückzugebenden Zeilen. Wenn nicht angegeben, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen angefordert werden. Die API kann auch weniger Zeilen als die angeforderte |
dimensionFilter |
Optional. Mit Dimensionsfiltern können Sie nur bestimmte Dimensionswerte im Bericht anfordern. Weitere Informationen finden Sie unter Bericht erstellen: Dimensionsfilter. In diesem Filter können keine Messwerte verwendet werden. |
returnPropertyQuota |
Optional. Mit dieser Option kann festgelegt werden, ob der aktuelle Status des Kontingents dieser Analytics-Property zurückgegeben werden soll. Das Kontingent wird in PropertyQuota zurückgegeben. |
Antworttext
Die Antwort des Trichterberichts enthält zwei untergeordnete Berichte. Bei den beiden untergeordneten Berichten handelt es sich um unterschiedliche Kombinationen von Dimensionen und Messwerten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "funnelTable": { object ( |
Felder | |
---|---|
funnelTable |
Die Trichtertabelle ist ein Bericht mit Trichterschritt, Segment, Aufschlüsselungsdimension, aktiven Nutzern, Abschlussrate, Ausstiegsrate und Ausstiegsrate. Die Segmentdimension ist in dieser Antwort nur vorhanden, wenn ein Segment angefordert wurde. Die Aufschlüsselungsdimension ist in dieser Antwort nur vorhanden, wenn sie angefordert wurde. |
funnelVisualization |
Die Trichtervisualisierung ist ein Bericht mit Schritt im Trichter, Segment, Datum, der Dimension „Nächste Aktion“ und „Aktive Nutzer“. Die Segmentdimension ist in dieser Antwort nur vorhanden, wenn ein Segment angefordert wurde. Die Datumsdimension ist in dieser Antwort nur vorhanden, wenn sie über den Trichtertyp |
propertyQuota |
Der Kontingentstatus der 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. In einem Trichter werden Nutzer erfasst, während sie eine Reihe von Schritten durchlaufen.
Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden. Wie werden z. B. aus potenziellen Kunden Besucher und letztendlich Käufer? Wie werden Neukunden zu Bestandskunden? Anhand dieser Informationen können Sie dann entsprechende Optimierungen vornehmen.
JSON-Darstellung |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
Felder | |
---|---|
isOpenFunnel |
In einem offenen Trichter können Nutzer an jedem beliebigen Punkt und in einem geschlossenen Trichter mit dem ersten Schritt beginnen. Optional. Wenn nicht angegeben, wird ein geschlossener Trichter verwendet. |
steps[] |
Die sequenziellen Schritte dieses Trichters. |
FunnelStep
Mit Schritten wird der Kaufprozess definiert, den Sie analysieren möchten. Die Schritte enthalten eine oder mehrere Bedingungen, die Ihre Nutzer erfüllen müssen, um in diesen Schritt des Trichters einbezogen zu werden.
JSON-Darstellung |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Felder | |
---|---|
name |
Der eindeutige Name für diesen Schritt. Wenn kein Wert angegeben ist, werden die Schritte mit einem 1-basierten indexierten Namen benannt, z. B. „0. ", "1. ", usw.). Dieser Name definiert den Stringwert, der von der Dimension „ |
isDirectlyFollowedBy |
Falls wahr, muss dieser Schritt direkt auf den vorherigen Schritt folgen. Bei „false“ können zwischen dem vorherigen und diesem Schritt Ereignisse auftreten. Wenn keine Vorgabe erfolgt, wird |
filterExpression |
Die Bedingung, die Ihre Nutzer erfüllen müssen, um in diesen Schritt des Trichters einbezogen zu werden. |
withinDurationFromPriorStep |
Falls angegeben, muss dieser Schritt innerhalb dieser Zeitspanne nach Abschluss des vorherigen Schritts abgeschlossen werden.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
FunnelFilterExpression
Drückt Kombinationen von Trichterfiltern aus.
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 |
FunnelFilterExpression entspricht NICHT |
funnelFieldFilter |
Ein Trichterfilter für eine Dimension oder einen Messwert. |
funnelEventFilter |
Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter. |
FunnelFilterExpressionList
Eine Liste der Trichterfilterausdrücke.
JSON-Darstellung |
---|
{
"expressions": [
{
object ( |
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 |
Stringbezogener Filter. |
inListFilter |
Ein Filter für In-Listen-Werte. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
FunnelEventFilter
Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter.
JSON-Darstellung |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Felder | |
---|---|
eventName |
Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich. |
funnelParameterFilterExpression |
Wenn angegeben, sucht dieser Filter nach Ereignissen, die sowohl mit dem Namen des einzelnen Ereignisses als auch mit den Ausdrücken des Parameterfilters übereinstimmen. Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar. |
FunnelParameterFilterExpression
drückt Kombinationen von Trichterfiltern für Parameter aus.
JSON-Darstellung |
---|
{ // Union field |
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 |
FunnelParameterFilterExpression entspricht NICHT |
funnelParameterFilter |
Ein einfacher Parameterfilter für den Trichter. |
FunnelParameterFilterExpressionList
Eine Liste von 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 auf Basis des angegebenen Ereignisparameters ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Ereignisparameter enthalten Felder wie „firebase_screen“ und „currency“ an. Ereignisparameter können nur in Segmenten und -Trichter und kann nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden. |
itemParameterName |
Dieser Filter wird auf Basis des angegebenen „item“-Parameters ausgewertet. „item“-Parameter werden als Parameter im „item“-Array protokolliert. Artikelparameter enthalten Felder wie „item_name“ und „item_category“. Artikelparameter können nur in Segmenten und -Trichter und kann nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden. Artikelparameter sind nur in E-Commerce-Ereignissen verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie im Leitfaden E-Commerce messen. |
Union-Feld one_filter . Geben Sie einen Filtertyp an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Stringbezogener Filter. |
inListFilter |
Ein Filter für In-Listen-Werte. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
FunnelBreakdown
Durch Aufschlüsselungen wird der Antwort im Unterbericht der Trichtertabelle eine Dimension hinzugefügt.
JSON-Darstellung |
---|
{
"breakdownDimension": {
object ( |
Felder | |
---|---|
breakdownDimension |
Die Dimensionsspalte, die der Antwort des Unterberichts für die Trichtertabelle hinzugefügt wurde. Mit der Aufschlüsselungsdimension werden die einzelnen Schritte im Trichter aufgeschlüsselt. Wenn |
limit |
Die maximale Anzahl einzelner Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird als |
FunnelNextAction
Die nächsten Aktionen geben den Wert für eine Dimension an, nachdem der Nutzer einen Schritt ausgeführt hat, aber bevor derselbe Nutzer den nächsten Schritt ausgeführt hat. Wenn nextActionDimension
beispielsweise eventName
ist, gibt nextActionDimension
in der Zeile des i
. Trichterschritts das erste Ereignis nach dem Ereignis zurück, das den Nutzer für den i
. Trichterschritt qualifiziert hat, aber bevor der Nutzer den i+1
. Trichterschritt erreicht hat.
JSON-Darstellung |
---|
{
"nextActionDimension": {
object ( |
Felder | |
---|---|
nextActionDimension |
Die Dimensionsspalte, die der Antwort des untergeordneten Berichts „Trichtervisualisierung“ hinzugefügt wurde. Die Dimension „Nächste Aktion“ gibt den nächsten Dimensionswert dieser Dimension zurück, nachdem der Nutzer den
|
limit |
Die maximale Anzahl einzelner Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden sollen. Wenn kein Limit angegeben ist, wird als |
FunnelVisualizationType
Steuert die Dimensionen, die in der Antwort des untergeordneten Berichts zur Trichtervisualisierung enthalten sind.
Enums | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Nicht definierter Typ. |
STANDARD_FUNNEL |
Standardtrichter mit Schritten Der Teilbericht „Trichtervisualisierung“ in der Antwort enthält kein Datum. |
TRENDED_FUNNEL |
Trichter mit Zeitverlauf (Liniendiagramm) Der Teilbericht „Trichtervisualisierung“ in der Antwort enthält die Dimension „Datum“. |
Segment
Ein Segment ist eine Teilmenge Ihrer Analytics-Daten. Beispielsweise könnten Nutzer aus demselben Land oder Ort ein Segment all Ihrer Nutzer sein. Oder Sie segmentieren nach Nutzern, die Artikel einer Produktlinie kaufen, einen bestimmten Bereich Ihrer Website besuchen oder dasselbe Ereignis in Ihrer App auslösen.
Weitere Informationen finden Sie unter Segmentierungstool in GA4.
JSON-Darstellung |
---|
{ "name": string, // Union field |
Felder | |
---|---|
name |
Der Name des Segments. Wenn keine Angabe gemacht wird, erhalten Segmente den Namen „Segment“. Dieser Name definiert den Stringwert, der von der Dimension „ |
Union-Feld one_segment_scope . Ein Segment ist in einem Bereich angegeben. Für one_segment_scope ist nur einer der folgenden Werte zulässig: |
|
userSegment |
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. Beispiele: Nutzer, die schon einmal etwas gekauft haben ... Nutzern, die 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 in den Kriterien 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 ein- oder ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Umfang wird definiert, wie viele Ereignisse die 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 angegeben. |
UserCriteriaScoping
Durch die Definition des Geltungsbereichs wird angegeben, welche Ereignisse bei der Bewertung berücksichtigt werden, ob ein Nutzer ein Kriterium erfüllt.
Enums | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Nicht spezifizierter Kriteriumsumfang. Machen Sie keine Angaben. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt werden, erfüllt der Nutzer die Kriterien. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Wenn die Kriterien innerhalb einer Sitzung erfüllt werden, erfüllt der Nutzer die Kriterien. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Wenn ein Ereignis für den Nutzer die Kriterien erfüllt, erfüllt der Nutzer die Kriterien. |
SegmentFilterExpression
Drückt Kombinationen von Segmentfiltern aus.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Geben Sie einen Filtertyp für SegmentFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
SegmentFilterExpression in |
orGroup |
SegmentFilterExpression in |
notExpression |
SegmentFilterExpression gehört NICHT zu |
segmentFilter |
Ein einfacher Segmentfilter. |
segmentEventFilter |
Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter. |
SegmentFilterExpressionList
Eine Liste mit Segmentfilterausdrücken.
JSON-Darstellung |
---|
{
"expressions": [
{
object ( |
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 |
Stringbezogener Filter. |
inListFilter |
Ein Filter für In-Listen-Werte. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
SegmentFilterScoping
Scopings geben an, wie die Dimensionen und bei der Auswertung eines Segmentfilters sollten die Messwerte mehrerer Ereignisse berücksichtigt werden.
JSON-Darstellung |
---|
{ "atAnyPointInTime": boolean } |
Felder | |
---|---|
atAnyPointInTime |
Ist Mit dem Parameter Dieser Wenn der Kriteriumsbereich |
SegmentEventFilter
Erstellt einen Filter, der nach Ereignissen mit einem einzelnen Ereignisnamen sucht. Wenn ein Parameterfilterausdruck angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, diesem Ereignisfilter.
JSON-Darstellung |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Felder | |
---|---|
eventName |
Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich. |
segmentParameterFilterExpression |
Wenn angegeben, sucht dieser Filter nach Ereignissen, die sowohl mit dem Namen des einzelnen Ereignisses als auch mit den Ausdrücken des Parameterfilters übereinstimmen. Innerhalb des Parameterfilterausdrucks sind nur Parameterfilter verfügbar. |
SegmentParameterFilterExpression
drückt Kombinationen von Segmentfiltern für Parameter aus.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Geben Sie einen Filtertyp für SegmentParameterFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
SegmentParameterFilterExpression in |
orGroup |
SegmentParameterFilterExpression in |
notExpression |
SegmentParameterFilterExpression gehört NICHT zu |
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, das gefiltert wird. Für one_parameter ist nur einer der folgenden Werte zulässig: |
|
eventParameterName |
Dieser Filter wird auf Basis des angegebenen Ereignisparameters ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Ereignisparameter enthalten Felder wie „firebase_screen“ und „currency“ an. Ereignisparameter können nur in Segmenten und -Trichter und kann nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden. |
itemParameterName |
Dieser Filter wird auf Basis des angegebenen „item“-Parameters ausgewertet. „item“-Parameter werden als Parameter im „item“-Array protokolliert. Artikelparameter enthalten Felder wie „item_name“ und „item_category“. Artikelparameter können nur in Segmenten und -Trichter und kann nur in einem untergeordneten Filter eines EventFilters verwendet werden. In einem untergeordneten Filter eines EventFilters sollten entweder Ereignis- oder Elementparameter verwendet werden. Artikelparameter sind nur in E-Commerce-Ereignissen verfügbar. Weitere Informationen zu E-Commerce-Ereignissen finden Sie im Leitfaden E-Commerce messen. |
Union-Feld one_filter . Geben Sie einen Filtertyp an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Stringbezogener Filter. |
inListFilter |
Ein Filter für In-Listen-Werte. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
SegmentParameterFilterScoping
Anhand von Bereichen wird angegeben, wie mehrere Ereignisse bei der Auswertung eines Segmentparameterfilters berücksichtigt werden.
JSON-Darstellung |
---|
{ "inAnyNDayPeriod": string } |
Felder | |
---|---|
inAnyNDayPeriod |
Akkumuliert den Parameter über die angegebene Zeitspanne von Tagen, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Kriteriumsbereich Beispiel: Wenn Der Zeitraum wird nicht zu dem Zweck erweitert, dass kurz vor Beginn des Zeitraums ein vollständiges Fenster von n Tagen vorhanden ist. Wenn ein Bericht beispielsweise für den 1.11.2021 bis 10.11.2021 gilt und
|
UserSegmentSequenceGroup
Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge eintreten müssen, damit der Nutzer Mitglied eines Segments ist.
JSON-Darstellung |
---|
{ "sequenceScoping": enum ( |
Felder | |
---|---|
sequenceScoping |
Alle Sequenzschritte müssen im Gültigkeitsbereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Bei Optional. Wenn kein Wert angegeben ist, wird |
sequenceMaximumDuration |
Definiert den Zeitraum, in dem die gesamte Sequenz stattfinden 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 alle Schritte abschließen, damit er mit der |
UserSequenceStep
Eine Bedingung, die in der angegebenen Schrittreihenfolge eintreten muss, damit dieser Nutzer der Sequenz entspricht.
JSON-Darstellung |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Felder | |
---|---|
isDirectlyFollowedBy |
Falls wahr, muss das Ereignis, das diesen Schritt erfüllt, das nächste Ereignis nach dem Ereignis sein, das den letzten Schritt erfüllt. Bei „false“ folgt dieser Schritt indirekt dem vorherigen Schritt. Beispielsweise können zwischen dem vorherigen und diesem Schritt Ereignisse auftreten. |
stepScoping |
Dieser Sequenzschritt muss bei der Festlegung des Gültigkeitsbereichs erfüllt sein, damit der Nutzer der Sequenz entspricht. Bei Optional. Wenn nicht angegeben, 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 angegeben. |
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 Optional. Wenn kein Wert angegeben ist, wird |
userExclusionCriteria |
Wenn ein Nutzer diese Bedingung erfüllt, wird er von der Mitgliedschaft im Segment für die |
UserExclusionDuration
Zählt Optionen für die Dauer eines Ausschlusses auf, wenn ein Nutzer mit userExclusionCriteria
übereinstimmt.
Enums | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Machen Sie keine Angaben. |
USER_EXCLUSION_TEMPORARY |
Sie können Nutzer vorübergehend aus dem Segment ausschließen, wenn sie die userExclusionCriteria -Bedingung erfüllen. |
USER_EXCLUSION_PERMANENT |
Nutzer, die die userExclusionCriteria -Bedingung erfüllen, werden dauerhaft aus dem Segment ausgeschlossen. |
SessionSegment
Sitzungssegmente sind Teilmengen der Sitzungen, die auf Ihrer Website oder in Ihrer App stattgefunden haben: etwa alle Sitzungen, die aus einer bestimmten Werbekampagne stammen.
JSON-Darstellung |
---|
{ "sessionInclusionCriteria": { object ( |
Felder | |
---|---|
sessionInclusionCriteria |
Definiert, welche Sitzungen in diesem Segment enthalten sind. Optional. |
exclusion |
Definiert, welche Sitzungen in diesem Segment ausgeschlossen werden. Optional. |
SessionSegmentCriteria
Eine Sitzung erfüllt ein Kriterium, wenn die Ereignisse der Sitzung die Bedingungen in den Kriterien erfüllen.
JSON-Darstellung |
---|
{
"andConditionGroups": [
{
object ( |
Felder | |
---|---|
andConditionGroups[] |
Eine Sitzung erfüllt diese Kriterien, wenn sie 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 ein- oder ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Umfang wird definiert, wie viele Ereignisse die Optional. Wenn kein Wert angegeben ist, wird als |
segmentFilterExpression |
Daten werden je nachdem, ob sie mit diesem Ausdruck übereinstimmen, in das Segment ein- oder daraus ausgeschlossen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter angegeben. |
SessionCriteriaScoping
Durch die Definition des Gültigkeitsbereichs wird angegeben, welche Ereignisse bei der Bewertung berücksichtigt werden, ob eine Sitzung ein Kriterium erfüllt.
Enums | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Nicht spezifizierter Kriteriumsumfang. Machen Sie keine Angaben. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien bei einem Ereignis erfüllt werden, erfüllt die Sitzung die Kriterien. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Wenn die Kriterien innerhalb einer Sitzung erfüllt werden, erfüllt die Sitzung die Kriterien. |
SessionSegmentExclusion
Gibt an, welche Sitzungen in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "sessionExclusionDuration": enum ( |
Felder | |
---|---|
sessionExclusionDuration |
Gibt an, wie lange ein Ausschluss gilt, wenn eine Sitzung mit dem Optional. Wenn kein Wert angegeben ist, wird als |
sessionExclusionCriteria |
Wenn eine Sitzung diese Bedingung erfüllt, wird sie von der Mitgliedschaft im Segment für die |
SessionExclusionDuration
Zählt Optionen für die Dauer eines Ausschlusses auf, wenn eine Sitzung mit dem sessionExclusionCriteria
übereinstimmt.
Enums | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Machen Sie keine Angaben. |
SESSION_EXCLUSION_TEMPORARY |
Sie können Sitzungen vorübergehend aus dem Segment ausschließen, wenn die Sitzung die sessionExclusionCriteria -Bedingung erfüllt. |
SESSION_EXCLUSION_PERMANENT |
Sie können Sitzungen dauerhaft aus dem Segment ausschließen, wenn sie die Bedingung „sessionExclusionCriteria “ erfüllen. |
EventSegment
Ereignissegmente sind Teilmengen von Ereignissen, die auf Ihrer Website oder in Ihrer App ausgelöst wurden. z. B. alle Kaufereignisse an einem bestimmten Standort app_exception-Ereignisse, die unter einem bestimmten Betriebssystem aufgetreten sind.
JSON-Darstellung |
---|
{ "eventInclusionCriteria": { object ( |
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 in den Kriterien erfüllt.
JSON-Darstellung |
---|
{
"andConditionGroups": [
{
object ( |
Felder | |
---|---|
andConditionGroups[] |
Ein Ereignis erfüllt diese Kriterien, wenn es mit jeder 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 kein Wert angegeben ist, wird als |
segmentFilterExpression |
Daten werden je nachdem, ob sie mit diesem Ausdruck übereinstimmen, in das Segment ein- oder daraus ausgeschlossen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter angegeben. |
EventCriteriaScoping
Die Definition des Gültigkeitsbereichs gibt an, welche Ereignisse bei der Bewertung berücksichtigt werden, ob ein Ereignis ein Kriterium erfüllt.
Enums | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Nicht spezifizierter Kriteriumsumfang. Machen Sie keine Angaben. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien bei einem Ereignis erfüllt werden, entspricht das Ereignis den Kriterien. |
EventSegmentExclusion
Gibt an, welche Ereignisse in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "eventExclusionDuration": enum ( |
Felder | |
---|---|
eventExclusionDuration |
Optional. Wenn kein Wert angegeben ist, wird ein |
eventExclusionCriteria |
Wenn ein Ereignis diese Bedingung erfüllt, wird es aus dem Segment für die |
EventExclusionDuration
Zählt Optionen für die Dauer eines Ausschlusses auf, wenn ein Ereignis mit dem eventExclusionCriteria
übereinstimmt.
Enums | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Machen Sie keine Angaben. |
EVENT_EXCLUSION_PERMANENT |
Schließen Sie Ereignisse dauerhaft aus dem Segment aus, wenn sie die eventExclusionCriteria -Bedingung erfüllen. |
FunnelSubReport
Trichter-Unterberichte enthalten die Werte für Dimensionen und Messwerte. Beispiel: 12 Nutzer haben den zweiten Schritt des Trichters erreicht.
JSON-Darstellung |
---|
{ "dimensionHeaders": [ { object ( |
Felder | |
---|---|
dimensionHeaders[] |
Beschreibt Dimensionsspalten. Trichterberichte enthalten immer die Dimension des Trichterschritts in Antworten für untergeordnete Berichte. Zusätzliche Dimensionen wie Aufschlüsselungen, Datumsangaben und nächste Aktionen können auf Anfrage in der Antwort enthalten sein. |
metricHeaders[] |
Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in den Antworten der Berichte. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussquote, Ausstiegsrate und Ausstiegsrate. |
rows[] |
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 auf Stichproben basieren, beschreibt dieser Wert den Prozentsatz der Ereignisse, die in diesem Trichterbericht verwendet wurden. Für jeden Zeitraum wird ein Wenn die Ergebnisse jedoch nicht auf Stichproben basieren, wird dieses Feld nicht definiert. |
SamplingMetadata
Falls die Ergebnisse des Trichterberichts auf Stichproben basieren, geben diese Metadaten den Prozentsatz der Ereignisse an, die in diesem Trichterbericht für einen bestimmten Zeitraum verwendet wurden. Bei einer Stichprobenerhebung wird eine Teilmenge aller Daten analysiert, um die aussagekräftigen Informationen im größeren Dataset zu ermitteln.
JSON-Darstellung |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Felder | |
---|---|
samplesReadCount |
Die Gesamtzahl der in diesem Stichprobenbericht für einen Zeitraum gelesenen Ereignisse. Der Umfang der Daten der Property, die in diesem Trichterbericht analysiert wurden. |
samplingSpaceSize |
Die Gesamtzahl der in den Daten dieser Property vorhandenen Ereignisse, die in diesem Trichterbericht für einen bestimmten Zeitraum hätten analysiert werden können. Durch das Sampling werden die aussagekräftigen Informationen über das größere Dataset aufgedeckt. Dies ist die Größe des größeren Datasets. Um den Prozentsatz der verfügbaren Daten zu berechnen, die in diesem Trichterbericht verwendet wurden, berechnen Sie |
PropertyQuota
Aktueller Status aller Kontingente für diese Analytics-Property. Wenn ein Kontingent für ein Attribut erschöpft ist, wird bei allen Anfragen an dieses Attribut der Fehler „Resource Exhausted“ zurückgegeben.
JSON-Darstellung |
---|
{ "tokensPerDay": { object ( |
Felder | |
---|---|
tokensPerDay |
In Analytics-Standard-Properties können pro Tag bis zu 200.000 Tokens verwendet werden. In Analytics 360-Properties können pro Tag 2.000.000 Tokens verwendet werden. Die meisten Anfragen benötigen weniger als 10 Tokens. |
tokensPerHour |
In Analytics-Standard-Properties können bis zu 40.000 Tokens pro Stunde verwendet werden. In Analytics 360-Properties können pro Stunde 400.000 Tokens verwendet werden. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen stündlichen, täglichen und projektbasierten Stundenkontingenten abgezogen wird. |
concurrentRequests |
Standard-Analytics-Properties können bis zu 10 Anfragen gleichzeitig senden. In Analytics 360-Properties können bis zu 50 Anfragen gleichzeitig verwendet werden. |
serverErrorsPerProjectPerHour |
Bei standardmäßigen Analytics-Properties und Cloud-Projekt-Paaren können bis zu zehn Serverfehler pro Stunde auftreten. Bei Paaren von Analytics 360-Properties und Cloud-Projekten können bis zu 50 Serverfehler pro Stunde auftreten. |
potentiallyThresholdedRequestsPerHour |
In Analytics-Properties können pro Stunde bis zu 120 Anfragen mit Dimensionen mit potenziell Grenzwerten gesendet werden. In einer Batchanfrage wird jede Berichtsanfrage einzeln für dieses Kontingent gezählt, wenn die Anfrage Dimensionen mit potenziell Grenzwerten umfasst. |
tokensPerProjectPerHour |
In Analytics-Properties können bis zu 35% der Tokens pro Projekt und Stunde verwendet werden. In Analytics-Standard-Properties können bis zu 14.000 Tokens pro Projekt und Stunde verwendet werden. Bei Analytics 360-Properties sind 140.000 Tokens pro Projekt und Stunde möglich. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen stündlichen, täglichen und projektbasierten Stundenkontingenten abgezogen wird. |
QuotaStatus
Aktueller Status für eine bestimmte Kontingentgruppe.
JSON-Darstellung |
---|
{ "consumed": integer, "remaining": integer } |
Felder | |
---|---|
consumed |
Von dieser Anfrage verbrauchtes Kontingent. |
remaining |
Verbleibendes Kontingent nach dieser Anfrage. |