- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Zeitraum
- Trichter
- Trichterschritt
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Vorgang
- NumericValue (Numerischer Wert)
- BetweenFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- Trichteraufschlüsselung
- Dimension
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- FunnelNextAction
- FunnelVisualizationType
- Segment
- Nutzersegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentAusschluss
- UserAusschlussDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentAusschluss
- SessionAusschlussDuration
- EventSegment
- EventSegmentCriteria.
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentAusschluss
- EventAusschlussDuration
- FilterExpression
- FilterExpressionList
- Filter
- FunnelSubReport
- DimensionHeader
- MetricHeader
- Messwerttyp
- Zeile
- DimensionsValue
- Messwert
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- Kontingentstatus
- Testen!
Gibt einen benutzerdefinierten Trichterbericht mit Ihren Google Analytics-Ereignisdaten zurück. Die von der API zurückgegebenen Daten liegen als Tabelle mit Spalten für die angeforderten Dimensionen und Messwerte vor.
Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden. Wie werden z. B. aus potenziellen Kunden Besucher und letztendlich Käufer? Wie werden Neukunden zu Bestandskunden? Anhand dieser Informationen können Sie dann entsprechende Optimierungen vornehmen. Weitere Informationen
Diese Methode wird in der Alpha-Entwicklungsphase eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Über Feedback zu Google Analytics Data API-Trichterberichten können Sie uns Feedback zu dieser API geben.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
property |
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 Innerhalb einer Batchanfrage sollte dieses Attribut entweder nicht angegeben werden 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[] |
Datumsbereiche 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 |
Die Konfiguration des Trichters für diese Anfrage. Diese Trichterkonfiguration ist erforderlich. |
funnelBreakdown |
Wenn angegeben, wird durch diese Aufschlüsselung der Antwort des Teilberichts zur 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 |
Wenn angegeben, wird mit „Nächste Aktion“ der Antwort des Teilberichts zur Trichtervisualisierung eine Dimension hinzugefügt. Mit der Dimension „Nächste Aktion“ wird jeder Trichterschritt zu den eindeutigen Werten der nächsten Aktion erweitert. Bei einer nächsten Aktion der Dimension Die nächste Aktion unterstützt nur |
funnelVisualizationType |
Mit dem Typ „Trichtervisualisierung“ werden die Dimensionen in der Antwort des Teilberichts zur Trichtervisualisierung gesteuert. Falls nichts angegeben wird, wird |
segments[] |
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 identifiziert. Der Segmentparameter ist optional. Anfragen sind auf vier Segmente beschränkt. |
limit |
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 die angeforderte Anzahl von |
dimensionFilter |
Mit Dimensionsfiltern können Sie nach bestimmten Dimensionswerten im Bericht fragen. Weitere Informationen finden Sie unter Bericht erstellen: Dimensionsfilter. Messwerte können in diesem Filter nicht verwendet werden. |
returnPropertyQuota |
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 sind 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, der den Trichterschritt, das Segment, die Aufschlüsselungsdimension, die aktiven Nutzer, die Abschlussrate, die Ausstiege und die Ausstiegsrate enthält. Die Segmentdimension ist nur in dieser Antwort 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, Dimension „Nächste Aktion“ und aktiven Nutzern. Die Segmentdimension ist nur in dieser Antwort vorhanden, wenn ein Segment angefordert wurde. Die Datumsdimension ist in dieser Antwort nur vorhanden, wenn sie über den Trichtertyp |
propertyQuota |
Der Kontingentstatus dieser Analytics-Property, einschließlich dieser Anfrage. |
kind |
Gibt an, um welche Art von Ressource diese Nachricht geht. Diese |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
DateRange
Aufeinanderfolgende Tage: startDate
, startDate + 1
, ..., endDate
. Anfragen sind für bis zu vier Zeiträume zulässig.
JSON-Darstellung |
---|
{ "startDate": string, "endDate": string, "name": string } |
Felder | |
---|---|
startDate |
Das einschließende Startdatum für die Abfrage im Format |
endDate |
Das einschließende Enddatum für die Abfrage im Format |
name |
Weist diesem Zeitraum einen Namen zu. Die Dimension „ |
Trichter
Konfiguriert den Trichter in einer Trichterberichtsanfrage. In einem Trichter werden Daten zu Nutzern in einer Abfolge von Schritten erfasst.
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 den Trichter bei jedem Schritt betreten. Bei einem geschlossenen Trichter muss er im ersten Schritt betreten werden. Optional. Wenn nicht angegeben, wird ein geschlossener Trichter verwendet. |
steps[] |
Die sequenziellen Schritte dieses Trichters. |
Trichterschritt
Mit Schritten wird der Kaufprozess definiert, den Sie analysieren möchten. Schritte enthalten eine oder mehrere Bedingungen, die Ihre Nutzer erfüllen müssen, um in diesem Schritt des Trichterpfads aufgenommen 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 auf 1 basierenden indexierten Namen benannt (z. B. „0. ", "1. „ usw.). Mit diesem Namen wird der Stringwert definiert, der von der Dimension |
isDirectlyFollowedBy |
Wenn dieser Wert „true“ ist, 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 Trichterprozesses aufgenommen zu werden. |
withinDurationFromPriorStep |
Wenn angegeben, muss dieser Schritt innerhalb der Dauer nach Abschluss des vorherigen Schritts abgeschlossen werden.
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 Ereignisse eines einzelnen Ereignisnamens zurückgibt. 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 in Bezug auf Strings. |
inListFilter |
Ein Filter für Listenwerte. |
numericFilter |
Ein Filter für numerische oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
StringFilter
Filter für String
JSON-Darstellung |
---|
{
"matchType": enum ( |
Felder | |
---|---|
matchType |
Die Keyword-Option für diesen Filter. |
value |
Der für den Abgleich verwendete Stringwert. |
caseSensitive |
Wenn „true“, wird beim Stringwert die Groß-/Kleinschreibung beachtet. |
MatchType
Der Übereinstimmungstyp eines Stringfilters
Enums | |
---|---|
MATCH_TYPE_UNSPECIFIED |
Ohne Angabe |
EXACT |
Genaue Übereinstimmung mit dem Stringwert. |
BEGINS_WITH |
Beginnt mit dem Stringwert. |
ENDS_WITH |
Er endet mit dem Stringwert. |
CONTAINS |
Enthält den Stringwert. |
FULL_REGEXP |
Vollständige Übereinstimmung für den regulären Ausdruck mit dem Stringwert. |
PARTIAL_REGEXP |
Teilübereinstimmung für den regulären Ausdruck mit dem Stringwert. |
InListFilter
Das Ergebnis muss in einer Liste von Stringwerten enthalten sein.
JSON-Darstellung |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Felder | |
---|---|
values[] |
Die Liste der Stringwerte. Das Feld darf nicht leer sein. |
caseSensitive |
Wenn „true“, wird beim Stringwert die Groß-/Kleinschreibung beachtet. |
Numerischer Filter
Filter für numerische oder Datumswerte
JSON-Darstellung |
---|
{ "operation": enum ( |
Felder | |
---|---|
operation |
Der Vorgangstyp für diesen Filter. |
value |
Ein numerischer Wert oder ein Datumswert. |
Vorgang
Der Vorgang, der auf einen numerischen Filter angewendet wird
Enums | |
---|---|
OPERATION_UNSPECIFIED |
Nicht angegeben |
EQUAL |
Gleich |
LESS_THAN |
Weniger als |
LESS_THAN_OR_EQUAL |
kleiner als oder gleich |
GREATER_THAN |
größer als |
GREATER_THAN_OR_EQUAL |
größer als oder gleich |
NumericValue
Für eine Zahl.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_value . Einer der numerischen Werte one_value kann nur einer der folgenden Werte sein: |
|
int64Value |
Ganzzahlwert |
doubleValue |
Doppelter Wert |
Zwischen Filter
Um auszudrücken, dass das Ergebnis zwischen zwei Zahlen (einschließlich) liegen muss.
JSON-Darstellung |
---|
{ "fromValue": { object ( |
Felder | |
---|---|
fromValue |
Beginnt mit dieser Zahl. |
toValue |
Endet mit dieser Nummer. |
FunnelEventFilter (Trichter-Ereignisfilter)
Erstellt einen Filter, der Ereignisse eines einzelnen Ereignisnamens zurückgibt. 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 |
Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich. |
funnelParameterFilterExpression |
Wenn angegeben, werden mit diesem Filter Ereignisse abgeglichen, 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 |
Die Parameter „FunnelParameterFilterExpression“ in |
orGroup |
Die Parameter „FunnelParameterFilterExpression“ in |
notExpression |
FunnelParameterFilterExpression ist NICHT von |
funnelParameterFilter |
Ein einfacher Trichterparameterfilter. |
FunnelParameterFilterExpressionList
Eine Liste mit Ausdrü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. Ereignisparameter umfassen 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 Elementparameter verwendet werden. |
itemParameterName |
Dieser Filter wird anhand des angegebenen „item“-Parameters ausgewertet. Artikelparameter werden als Parameter im Element-Array protokolliert. Zu den 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 Elementparameter 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 in Bezug auf Strings. |
inListFilter |
Ein Filter für Listenwerte. |
numericFilter |
Ein Filter für numerische oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
Trichteraufschlüsselung
Bei der Aufschlüsselung wird der Antwort auf den Teilbericht der Trichtertabelle eine Dimension hinzugefügt.
JSON-Darstellung |
---|
{
"breakdownDimension": {
object ( |
Felder | |
---|---|
breakdownDimension |
Die Spalte „Dimension“, die zur Antwort auf den Teilbericht der Trichtertabelle hinzugefügt wurde. Die Dimension „Aufschlüsselung“ schlüsselt jeden Schritt im Trichter auf. Ein gültiger |
limit |
Die maximale Anzahl unterschiedlicher Werte der Aufschlüsselungsdimension, die in der Antwort zurückgegeben werden soll. Ein |
Dimension
Dimensionen sind Attribute Ihrer Daten. Die Dimension „Stadt“ gibt beispielsweise den Ort an, von dem ein Ereignis ausgeht. Dimensionswerte in Berichtsantworten sind Strings. Für die Stadt kann beispielsweise „Paris“ oder „New York“ angegeben sein.
JSON-Darstellung |
---|
{
"name": string,
"dimensionExpression": {
object ( |
Felder | |
---|---|
name |
Der Name der Dimension. Eine Liste der Dimensionsnamen, die von wichtigen Berichtsmethoden wie Wenn In |
dimensionExpression |
Eine Dimension kann das Ergebnis eines Ausdrucks mit mehreren Dimensionen sein. Beispiel: Die Dimension „Land, Stadt“: verketten(Land, „, „, Stadt). |
DimensionExpression
Wird verwendet, um eine Dimension auszudrücken, die das Ergebnis einer Formel aus mehreren Dimensionen ist. Anwendungsbeispiele: 1) Kleinbuchstaben(Dimension) 2) Verketten(Dimension1, Symbol, Abmessung2).
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_expression . Geben Sie einen Typ des Dimensionsausdrucks für DimensionExpression an. Für one_expression ist nur einer der folgenden Werte zulässig: |
|
lowerCase |
Damit wird ein Dimensionswert in Kleinbuchstaben umgewandelt. |
upperCase |
Damit wird ein Dimensionswert in Großbuchstaben umgewandelt. |
concatenate |
Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zu kombinieren. Beispiel: Die Dimension „Land, Stadt“: verketten(Land, „, „, Stadt). |
CaseExpression
Damit wird ein Dimensionswert in einen einzelnen Fall umgewandelt.
JSON-Darstellung |
---|
{ "dimensionName": string } |
Felder | |
---|---|
dimensionName |
Name einer Dimension. Der Name muss sich auf einen Namen im Dimensionsfeld der Anfrage beziehen. |
Verkettenausdruck
Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zu kombinieren.
JSON-Darstellung |
---|
{ "dimensionNames": [ string ], "delimiter": string } |
Felder | |
---|---|
dimensionNames[] |
Namen der Dimensionen. Die Namen müssen sich auf Namen im Dimensionsfeld der Anfrage beziehen. |
delimiter |
Das Trennzeichen zwischen den Dimensionsnamen. Als Trennzeichen werden häufig einzelne Zeichen wie „|“ oder „“ verwendet. Es kann sich aber auch um längere Strings handeln. Wenn ein Dimensionswert das Trennzeichen enthält, sind beide Antworten ohne Unterscheidung vorhanden. Wenn beispielsweise der Wert von Dimension 1 „US,FR“, der Wert der Dimension 2 „JP“ und das Trennzeichen = „,“ ist, enthält die Antwort „US,FR,JP“. |
TrichterNächsteAktion
Die nächsten Aktionen geben den Wert für eine Dimension an, nachdem der Nutzer einen Schritt erreicht hat, aber bevor er den nächsten Schritt erreicht hat. Beispiel: Wenn nextActionDimension
den Wert eventName
hat, gibt nextActionDimension
in der Zeile i
. Trichterschritts das erste Ereignis nach dem Ereignis zurück, durch das der Nutzer zum i
. Trichterschritt, aber vor dem i+1
. Schritt im Trichter qualifiziert wurde.
JSON-Darstellung |
---|
{
"nextActionDimension": {
object ( |
Felder | |
---|---|
nextActionDimension |
Die Dimensionsspalte, die der Antwort auf den Teilbericht 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 soll. Ein |
FunnelVisualizationType
Damit werden die Dimensionen in der Antwort des Teilberichts zur Trichtervisualisierung gesteuert.
Enums | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Nicht definierter Typ. |
STANDARD_FUNNEL |
Ein standardmäßiger (abgestufter) Trichter. Der Teilbericht zur Trichtervisualisierung in der Antwort enthält kein Datum. |
TRENDED_FUNNEL |
Ein Trichter mit Trend (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-Segmentierungstool.
JSON-Darstellung |
---|
{ "name": string, // Union field |
Felder | |
---|---|
name |
Der Name für dieses Segment. Wenn keine Vorgabe erfolgt, 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 Umfang 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. |
Nutzersegment
Nutzersegmente sind Teilmengen von Nutzern, die mit Ihrer Website oder App interagiert haben, z. B. Nutzer, die bereits einen Kauf abgeschlossen haben oder 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 |
Legt fest, welche Nutzer in diesem Segment ausgeschlossen werden. Optional. |
NutzerSegmentkriterien
Ein Nutzer erfüllt ein Kriterium, wenn die Ereignisse des Nutzers die Bedingungen in dem Kriterium 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 |
Die Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Gültigkeitsbereich wird definiert, über wie viele Ereignisse Optional. Wenn nicht angegeben, wird |
segmentFilterExpression |
Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt. |
Umfang der Nutzerkriterien
Der Umfang gibt an, welche Ereignisse bei der Bewertung, ob ein Nutzer ein Kriterium erfüllt, berücksichtigt werden.
Enums | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Kriterienumfang. Keine Angabe. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt der Nutzer die Kriterien. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Wenn die Kriterien innerhalb einer Sitzung erfüllt sind, erfüllt der Nutzer die Kriterien. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Wenn ein Ereignis die Kriterien für den Nutzer 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 eine Filterart für SegmentFilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Die SegmentFilterExpression in |
orGroup |
Die SegmentFilterExpression in |
notExpression |
SegmentFilterExpression ist NICHT |
segmentFilter |
Ein einfacher Segmentfilter. |
segmentEventFilter |
Erstellt einen Filter, der Ereignisse eines einzelnen Ereignisnamens zurückgibt. 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[] |
Die 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 Umfang 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 in Bezug auf Strings. |
inListFilter |
Ein Filter für Listenwerte. |
numericFilter |
Ein Filter für numerische oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
Segmentfilter
Ü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 Wenn der Kriterienumfang |
SegmentEventFilter
Erstellt einen Filter, der Ereignisse eines einzelnen Ereignisnamens zurückgibt. 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 |
Mit diesem Filter werden Ereignisse mit diesem einzelnen Ereignisnamen abgeglichen. Ereignisname ist erforderlich. |
segmentParameterFilterExpression |
Wenn angegeben, werden mit diesem Filter Ereignisse abgeglichen, 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 des Segmentfilters 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 |
Die SegmentParameterFilterExpression in |
notExpression |
SegmentParameterFilterExpression ist NICHT |
segmentParameterFilter |
Ein einfacher Segmentparameter-Filter. |
SegmentParameterFilterExpressionList
Eine Liste mit Segmentparameter-Filterausdrücken.
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 anhand des angegebenen Ereignisparameters ausgewertet. Ereignisparameter werden als Parameter des Ereignisses protokolliert. Ereignisparameter umfassen 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 Elementparameter verwendet werden. |
itemParameterName |
Dieser Filter wird anhand des angegebenen „item“-Parameters ausgewertet. Artikelparameter werden als Parameter im Element-Array protokolliert. Zu den 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 Elementparameter 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 in Bezug auf Strings. |
inListFilter |
Ein Filter für Listenwerte. |
numericFilter |
Ein Filter für numerische oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
SegmentParameterFilterScoping
Mit Bereichsparametern wird festgelegt, wie mehrere Ereignisse bei der Auswertung eines Segmentparameterfilters berücksichtigt werden.
JSON-Darstellung |
---|
{ "inAnyNDayPeriod": string } |
Felder | |
---|---|
inAnyNDayPeriod |
Kumuliert den Parameter über den angegebenen Zeitraum von Tagen, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Kriterienumfang Beispiel: Wenn Der Zeitraum wird nicht erweitert, um ein volles N-Tage-Fenster kurz vor Beginn des Zeitraums zu haben. Wenn ein Bericht beispielsweise für den Zeitraum vom 01.11.2021 bis zum 10.11.2021 und
|
NutzerSegmentSequenzgruppe
Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge auftreten müssen, damit der User Mitglied beim Segment wird.
JSON-Darstellung |
---|
{ "sequenceScoping": enum ( |
Felder | |
---|---|
sequenceScoping |
Alle Sequenzschritte müssen im Bereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Beispiel: Bei Optional. Wenn nicht angegeben, wird |
sequenceMaximumDuration |
Definiert den Zeitraum, in dem die gesamte Sequenz stattfinden muss, z. B. 30 Minuten.
Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
userSequenceSteps[] |
Eine geordnete Abfolge von Bedingungsschritten. Die Ereignisse eines Nutzers müssen alle Schritte abschließen, damit der Nutzer dem |
UserSequenceStep
Eine Bedingung, die in der angegebenen Schrittreihenfolge eintreten muss, damit dieser 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 zwischen dem vorherigen und diesem Schritt Ereignisse auftreten. |
stepScoping |
Dieser Sequenzschritt muss im Bereich erfüllt sein, damit der Nutzer der Sequenz entspricht. Beispiel: Bei Optional. Wenn nicht angegeben, verwendet |
segmentFilterExpression |
Ein Nutzer stimmt mit diesem Sequenzschritt überein, wenn seine Ereignisse mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt. |
Ausschluss von Nutzersegmenten
Gibt an, welche Nutzer in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "userExclusionDuration": enum ( |
Felder | |
---|---|
userExclusionDuration |
Gibt an, wie lange ein Ausschluss gelten soll, wenn ein Nutzer mit Optional. Wenn nicht angegeben, wird |
userExclusionCriteria |
Erfüllt ein Nutzer diese Bedingung, wird er von der Mitgliedschaft im Segment für |
NutzerAusschlussdauer
Listet Optionen auf, die bestimmen, wie lange ein Ausschluss bestehen bleibt, wenn ein Nutzer mit userExclusionCriteria
übereinstimmt.
Enums | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
USER_EXCLUSION_TEMPORARY |
Nutzer vorübergehend aus dem Segment ausschließen, wenn sie die Bedingung userExclusionCriteria erfüllen. |
USER_EXCLUSION_PERMANENT |
Nutzer, die die Bedingung userExclusionCriteria erfüllen, werden dauerhaft aus dem Segment ausgeschlossen. |
Sitzungssegment
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 |
Legt fest, welche Sitzungen in diesem Segment enthalten sind. Optional. |
exclusion |
Legt fest, welche Sitzungen in diesem Segment ausgeschlossen werden. Optional. |
SitzungSegmentkriterien
Eine Sitzung entspricht einem Kriterium, wenn die darin enthaltenen Ereignisse die Bedingungen in den Kriterien erfüllen.
JSON-Darstellung |
---|
{
"andConditionGroups": [
{
object ( |
Felder | |
---|---|
andConditionGroups[] |
Eine Sitzung entspricht diesen 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 |
Die Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Mit diesem Gültigkeitsbereich wird definiert, über wie viele Ereignisse Optional. Wenn kein Wert angegeben ist, wird |
segmentFilterExpression |
Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt. |
Sitzungskriterienbereich
Der Umfang gibt an, welche Ereignisse bei der Bewertung, ob eine Sitzung ein Kriterium erfüllt, berücksichtigt werden.
Enums | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Kriterienumfang. Keine Angabe. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, 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. |
Sitzung –Segmentausschluss
Gibt an, welche Sitzungen in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "sessionExclusionDuration": enum ( |
Felder | |
---|---|
sessionExclusionDuration |
Gibt an, wie lange ein Ausschluss gelten soll, wenn eine Sitzung mit dem Optional. Wenn kein Wert angegeben ist, wird |
sessionExclusionCriteria |
Erfüllt eine Sitzung diese Bedingung, wird sie von der Mitgliedschaft im Segment für |
Dauer des Sitzungsausschlusses
Listet Optionen für die Dauer eines Ausschlusses auf, wenn eine Sitzung mit dem sessionExclusionCriteria
übereinstimmt.
Enums | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
SESSION_EXCLUSION_TEMPORARY |
Sitzungen aus dem Segment vorübergehend ausschließen, wenn die Sitzung die Bedingung sessionExclusionCriteria erfüllt. |
SESSION_EXCLUSION_PERMANENT |
Sitzungen aus dem Segment werden dauerhaft ausgeschlossen, wenn sie die Bedingung sessionExclusionCriteria erfüllen. |
Ereignissegment
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 |
Legt fest, welche Ereignisse in diesem Segment ausgeschlossen werden. Optional. |
EventSegmentCriteria
Ein Ereignis entspricht einem Kriterium, wenn es die darin enthaltenen Bedingungen erfüllt.
JSON-Darstellung |
---|
{
"andConditionGroups": [
{
object ( |
Felder | |
---|---|
andConditionGroups[] |
Ein Ereignis entspricht diesen Kriterien, wenn es jedem dieser |
EventSegmentConditionGroup
Mithilfe von Bedingungen können Sie festlegen, welche Daten Ihr Analytics-Segment enthält und welche ausgeschlossen werden.
JSON-Darstellung |
---|
{ "conditionScoping": enum ( |
Felder | |
---|---|
conditionScoping |
Optional. Wenn kein Wert angegeben ist, wird |
segmentFilterExpression |
Daten werden in das Segment ein- oder daraus ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Mit Ausdrücken werden Kriterien für Dimensionen, Messwerte und/oder Parameter ausgedrückt. |
EventCriteriaScoping
Mit der Bereichsdefinition legen Sie fest, welche Ereignisse bei der Beurteilung berücksichtigt werden, ob ein Ereignis ein Kriterium erfüllt.
Enums | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Kriterienumfang. Keine Angabe. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt es auch die Kriterien. |
EventSegmentAusschluss
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 |
EventAusschlussDauer
Aufzählung der Optionen für die Dauer eines Ausschlusses, wenn ein Ereignis mit eventExclusionCriteria
übereinstimmt
Enums | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
EVENT_EXCLUSION_PERMANENT |
Ereignisse aus dem Segment dauerhaft ausschließen, falls sie die Bedingung eventExclusionCriteria erfüllen. |
FilterExpression
Zum Ausdruck von Dimensions- oder Messwertfiltern. Die Felder in derselben FilterExpression müssen entweder alle Dimensionen oder alle Messwerte enthalten.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Geben Sie eine Art von Filterausdruck für FilterExpression an. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Die FilterExpressions in andGroup haben eine AND-Beziehung. |
orGroup |
Die FilterExpressions in orGroup haben eine OR-Beziehung. |
notExpression |
FilterExpression ist NICHT "notExpression". |
filter |
Ein einfacher Filter. In derselben FilterExpression müssen alle Feldnamen des Filters entweder alle Dimensionen oder alle Messwerte sein. |
FilterExpressionList
Eine Liste mit Filterausdrücken.
JSON-Darstellung |
---|
{
"expressions": [
{
object ( |
Felder | |
---|---|
expressions[] |
Eine Liste mit Filterausdrücken. |
Filter
Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.
JSON-Darstellung |
---|
{ "fieldName": string, // Union field |
Felder | |
---|---|
fieldName |
Name der Dimension oder des Messwerts Muss ein in Dimensionen oder Messwerten definierter Name sein. |
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 in Bezug auf Strings. |
inListFilter |
Ein Filter für Listenwerte. |
numericFilter |
Ein Filter für numerische oder Datumswerte. |
betweenFilter |
Ein Filter für zwei Werte. |
Trichterunterbericht
Trichter-Unterberichte enthalten die Dimensions- und Messwertdatenwerte. Beispielsweise haben 12 Nutzer den zweiten Schritt des Trichters erreicht.
JSON-Darstellung |
---|
{ "dimensionHeaders": [ { object ( |
Felder | |
---|---|
dimensionHeaders[] |
Beschreibt Dimensionsspalten. Trichterberichte enthalten in Antworten auf Teilberichte immer die Dimension „Trichterschritt“. In der Antwort können auf Anfrage zusätzliche Dimensionen wie Aufschlüsselungen, Daten und nächste Aktionen enthalten sein. |
metricHeaders[] |
Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in Antworten von Teilberichten. Die Trichtertabelle enthält zusätzliche Messwerte wie Abschlussrate, Ausstiege und Ausstiegsrate. |
rows[] |
Zeilen mit Kombinationen aus Dimensionswerten und Messwerten im Bericht. |
metadata |
Metadaten für den Trichterbericht. |
DimensionHeader
Beschreibt eine Dimensionsspalte im Bericht. In einem Bericht angeforderte Dimensionen erzeugen Spalteneinträge in Zeilen und DimensionHeaders. Dimensionen, die ausschließlich in Filtern oder Ausdrücken verwendet werden, generieren jedoch keine Spalten in einem Bericht. Daher werden für diese Dimensionen auch keine Überschriften angezeigt.
JSON-Darstellung |
---|
{ "name": string } |
Felder | |
---|---|
name |
Der Name der Dimension |
MetricHeader
Beschreibt eine Messwertspalte im Bericht. Sichtbare Messwerte, die in einem Bericht angefordert werden, erzeugen Spalteneinträge in Zeilen und MetricHeaders. Für Messwerte, die ausschließlich in Filtern oder Ausdrücken verwendet werden, werden jedoch keine Spalten in einem Bericht erzeugt. Daher werden für diese Messwerte auch keine Überschriften erzeugt.
JSON-Darstellung |
---|
{
"name": string,
"type": enum ( |
Felder | |
---|---|
name |
Der Name des Messwerts. |
type |
Der Datentyp des Messwerts. |
MetricType
Der Werttyp eines Messwerts.
Enums | |
---|---|
METRIC_TYPE_UNSPECIFIED |
Nicht definierter Typ. |
TYPE_INTEGER |
Ganzzahltyp. |
TYPE_FLOAT |
Gleitkommatyp. |
TYPE_SECONDS |
Eine Dauer von Sekunden (ein spezieller Gleitkommatyp). |
TYPE_MILLISECONDS |
Dauer in Millisekunden; ein spezieller Gleitkommatyp |
TYPE_MINUTES |
Dauer in Minuten; ein spezieller Gleitkommatyp |
TYPE_HOURS |
Dauer in Stunden; ein spezieller Gleitkommatyp |
TYPE_STANDARD |
Ein benutzerdefinierter Messwert vom Typ „Standard“; ein spezieller Gleitkommatyp |
TYPE_CURRENCY |
Ein Geldbetrag; ein spezieller Gleitkommatyp. |
TYPE_FEET |
Eine Länge in Fuß; ein spezieller Gleitkommatyp. |
TYPE_MILES |
Eine Länge in Meilen; ein spezieller Gleitkommatyp. |
TYPE_METERS |
Eine Länge in Metern; ein spezieller Gleitkommatyp. |
TYPE_KILOMETERS |
Eine Länge in Kilometern; ein spezieller Gleitkommatyp |
Row
Berichtsdaten für jede Zeile. Wenn RunReportRequest beispielsweise Folgendes enthält:
"dimensions": [
{
"name": "eventName"
},
{
"name": "countryId"
}
],
"metrics": [
{
"name": "eventCount"
}
]
Eine Zeile mit „in_app_purchase“ als „eventName“, „JP“ als countryId und „15“ als „eventCount“:
"dimensionValues": [
{
"value": "in_app_purchase"
},
{
"value": "JP"
}
],
"metricValues": [
{
"value": "15"
}
]
JSON-Darstellung |
---|
{ "dimensionValues": [ { object ( |
Felder | |
---|---|
dimensionValues[] |
Liste der angeforderten Dimensionswerte. In einem PivotReport werden dimensionsValues nur für Dimensionen aufgelistet, die in einem Pivot enthalten sind. |
metricValues[] |
Liste der angeforderten sichtbaren Messwerte. |
DimensionValue
Der Wert einer Dimension.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_value . Für den Dimensionswert one_value ist nur einer der folgenden Werte zulässig: |
|
value |
Wert als String, wenn der Dimensionstyp ein String ist. |
MetricValue
Der Wert eines Messwerts.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_value . Einer der folgenden Messwerte ist für den Messwert one_value zulässig: |
|
value |
Messwert Informationen zum Typ finden Sie unter MetricHeader. |
FunnelResponseMetadata
Die Antwortmetadaten des Trichterberichts enthalten zusätzliche Informationen zum Trichterbericht.
JSON-Darstellung |
---|
{
"samplingMetadatas": [
{
object ( |
Felder | |
---|---|
samplingMetadatas[] |
Falls es sich bei den Ergebnissen des Trichterberichts um Stichproben handelt, ist hier der Prozentsatz der Ereignisse angegeben, der im Trichterbericht verwendet wurde. Für jeden Zeitraum wird ein Wenn die Ergebnisse jedoch nicht auf Stichproben basieren, wird dieses Feld nicht definiert. |
SamplingMetadata
Falls es sich bei den Ergebnissen des Trichterberichts um Stichproben handelt, geben diese Metadaten an, welcher Prozentsatz der Ereignisse in diesem Trichterbericht für einen Zeitraum verwendet wurde. Als Stichprobenerhebung wird eine Teilmenge aller Daten analysiert, um aussagekräftige Informationen in einem größeren Dataset zu erhalten.
JSON-Darstellung |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Felder | |
---|---|
samplesReadCount |
Die Gesamtzahl der in diesem Stichprobenbericht gelesenen Ereignisse für einen Zeitraum. Die Größe der Teilmenge der Daten dieser Property, die in diesem Trichterbericht analysiert wurde. |
samplingSpaceSize |
Die Gesamtzahl der Ereignisse in den Daten dieser Property, die in diesem Trichterbericht für einen Zeitraum hätten analysiert werden können. Durch Stichprobenerhebung werden aussagekräftige Informationen über das größere Dataset ermittelt. Dies ist die Größe des größeren Datasets. 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 und für Analytics 360-Properties bis zu 2.000.000 Tokens pro Tag möglich. Die meisten Anfragen benötigen weniger als 10 Tokens. |
tokensPerHour |
Für Standard-Analytics-Properties sind bis zu 40.000 Tokens pro Stunde und für Analytics 360-Properties bis zu 400.000 Tokens pro Stunde möglich. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen Stundenkontingenten pro Stunde, Tag und Projekt abgezogen wird. |
concurrentRequests |
Standard-Analytics-Properties können bis zu 10 gleichzeitige Anfragen senden. Analytics 360-Properties können bis zu 50 gleichzeitige Anfragen verwenden. |
serverErrorsPerProjectPerHour |
Standardmäßige Paare von Analytics-Properties und Cloud-Projekten können bis zu 10 Serverfehler pro Stunde enthalten. Paare aus Analytics 360-Properties und Cloud-Projekten können bis zu 50 Serverfehler pro Stunde enthalten. |
potentiallyThresholdedRequestsPerHour |
Analytics-Properties können bis zu 120 Anfragen mit Dimensionen pro Stunde senden, für die möglicherweise Grenzwerte festgelegt wurden. In einer Batchanfrage wird jede Berichtsanfrage für dieses Kontingent einzeln gezählt, wenn die Anfrage Dimensionen mit potenziell Grenzwerten enthält. |
tokensPerProjectPerHour |
In Analytics-Properties können bis zu 35% der Tokens pro Projekt und Stunde verwendet werden. Das bedeutet, dass Standard-Analytics-Properties bis zu 14.000 Tokens pro Projekt und Stunde und Analytics 360-Properties 140.000 Tokens pro Projekt und Stunde verwenden können. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens, die von allen Stundenkontingenten pro Stunde, Tag und Projekt abgezogen wird. |
QuotaStatus
Aktueller Status einer bestimmten Kontingentgruppe.
JSON-Darstellung |
---|
{ "consumed": integer, "remaining": integer } |
Felder | |
---|---|
consumed |
Von dieser Anfrage verbrauchtes Kontingent. |
remaining |
Nach dieser Anfrage verbleibendes Kontingent. |