- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- DateRange
- Trichter
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Vorgang
- NumericValue (Numerischer Wert)
- BetweenFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- Dimension
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- 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
- FilterExpression
- FilterExpressionList
- Filtern
- FunnelSubReport
- DimensionHeader
- MetricHeader
- MetricType
- Zeile
- DimensionValue
- MetricValue
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus (Kontingentstatus)
- 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. Senden Sie uns Feedback zu dieser API. Senden Sie uns dazu Feedback zu Trichterberichten zur Google Analytics Data 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 GA4-Property-ID in Google Analytics, deren Ereignisse erfasst werden. Wird im URL-Pfad und nicht im Text angegeben. Weitere Informationen zum Ermitteln der Property-ID Dieses Attribut sollte in einer Batchanfrage 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 entsprechenden 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 Teilberichts 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. Falls angegeben, wird mit der nächsten Aktion der Antwort des Teilberichts zur Trichtervisualisierung eine Dimension hinzugefügt. Mit der Dimension „Nächste Aktion“ wird jeder Trichterschritt auf die eindeutigen Werte der nächsten Aktion erweitert. Bei der nächsten Aktion der Dimension Die nächste Aktion unterstützt nur |
funnelVisualizationType |
Optional. Mit dem Typ „Trichtervisualisierung“ werden die Dimensionen festgelegt, die in der Antwort auf den Teilbericht „Trichtervisualisierung“ enthalten sein sollen. 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 angefordert werden. Die API kann auch weniger Zeilen als die angefragte |
dimensionFilter |
Optional. Mit Dimensionsfiltern können Sie nur nach bestimmten Dimensionswerten im Bericht 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 sind unterschiedliche Kombinationen aus Dimensionen und Messwerten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "funnelTable": { object ( |
Felder | |
---|---|
funnelTable |
Die Trichtertabelle ist ein Bericht mit Trichterschritt, Segment, Aufschlüsselungsdimension, aktiven Nutzern, Abschlussrate, Ausstiegs- 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 in dieser Antwort nur dann vorhanden, wenn sie über den Trichtertyp |
propertyQuota |
Der Kontingentstatus dieser Analytics-Property, einschließlich dieser Anfrage. |
kind |
Gibt an, welche Art von Ressource diese Nachricht ist. Diese |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
DateRange
Aufeinander folgende 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. 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 |
In einem offenen Trichter können Nutzer den Trichter bei jedem Schritt betreten, bei einem geschlossenen Trichter erst einmal. Optional. Wenn keine Vorgabe erfolgt, 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 kein Wert angegeben ist, 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 |
Wenn „true“ festgelegt ist, muss dieser Schritt direkt auf den vorherigen Schritt folgen. Bei „false“ können Ereignisse zwischen dem vorherigen und diesem Schritt auftreten. Wenn keine Vorgabe erfolgt, wird |
filterExpression |
Die Bedingung, die Nutzer erfüllen müssen, um bei diesem Schritt des Trichters berücksichtigt zu werden. |
withinDurationFromPriorStep |
Wenn angegeben, muss dieser Schritt innerhalb der Dauer des Abschlusses 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 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 Ausdrücken für Trichterfilter.
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 eine Filterart an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Filter für 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. |
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 |
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 |
Teilweise Ü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. Darf nicht leer sein. |
caseSensitive |
Wenn „true“, wird beim Stringwert die Groß-/Kleinschreibung beachtet. |
NumericFilter
Filter für numerische Werte 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
Zur Darstellung einer Zahl.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_value . Einer der folgenden numerischen Werte ist one_value : |
|
int64Value |
Ganzzahlwert |
doubleValue |
Doppelter Wert |
BetweenFilter
Damit wird ausgedrückt, 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
Erstellt einen Filter, der 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 dieses Flag angegeben ist, sucht dieser Filter nach Ereignissen, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. Im Parameterfilterausdruck 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 |
„FunnelParameterFilterExpression“ in |
orGroup |
Die 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. 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 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 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 eine Filterart an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Filter für 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 auf Unterbericht der Trichtertabelle eine Dimension hinzugefügt.
JSON-Darstellung |
---|
{
"breakdownDimension": {
object ( |
Felder | |
---|---|
breakdownDimension |
Die Dimensionsspalte, die in der Antwort auf den Unterbericht der Trichtertabelle hinzugefügt wurde. Mit der Dimension „Aufschlüsselung“ werden die einzelnen Trichterschritte 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 |
Dimension
Dimensionen sind Attribute Ihrer Daten. Die Dimension „Stadt“ gibt beispielsweise den Ort an, von dem aus das Ereignis stammt. Dimensionswerte in Berichtsantworten sind Strings. Die Stadt könnte z. B. „Paris“ oder „New York“ sein.
JSON-Darstellung |
---|
{
"name": string,
"dimensionExpression": {
object ( |
Felder | |
---|---|
name |
Der Name der Dimension. Unter API-Dimensionen finden Sie eine Liste der Dimensionsnamen, die von wichtigen Berichtsmethoden wie Wenn In |
dimensionExpression |
Eine Dimension kann das Ergebnis eines Ausdrucks mit mehreren Dimensionen sein. Beispiel: Dimension „Land, Stadt“: verketten(Land, ", ", Stadt). |
DimensionExpression
Damit wird eine Dimension ausgedrückt, die das Ergebnis einer Formel mit mehreren Dimensionen ist. Anwendungsbeispiele: 1) Kleinbuchstaben(Dimension) 2) verketten(Dimension1, Symbol, Dimension2).
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_expression . Geben Sie eine Art von Dimensionsausdruck 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 |
Damit werden Dimensionswerte zu einer einzelnen Dimension kombiniert. Beispiel: Dimension „Land, Stadt“: verketten(Land, ", ", Stadt). |
CaseExpression
Damit wird ein Dimensionswert in Groß- und Kleinschreibung umgewandelt.
JSON-Darstellung |
---|
{ "dimensionName": string } |
Felder | |
---|---|
dimensionName |
Name einer Dimension. Der Name muss sich auf einen Namen im Dimensionsfeld der Anfrage beziehen. |
ConcatenateExpression
Damit werden Dimensionswerte zu einer einzelnen Dimension kombiniert.
JSON-Darstellung |
---|
{ "dimensionNames": [ string ], "delimiter": string } |
Felder | |
---|---|
dimensionNames[] |
Namen der Dimensionen. Die Namen müssen sich auf die Namen im Dimensionsfeld der Anfrage beziehen. |
delimiter |
Trennzeichen zwischen Dimensionsnamen Trennzeichen sind häufig einzelne Zeichen wie „|“ oder „“, können aber auch längere Strings sein. Wenn ein Dimensionswert das Trennzeichen enthält, sind beide Antworten ohne Unterscheidung vorhanden. Beispiel: Wenn für Dimension 1 der Wert „US,FR“, der Wert der Dimension 2 den Wert „JP“ und das Trennzeichen den Wert „,“ hat, enthält die Antwort „US,FR,JP“. |
FunnelNextAction
Unter „Nächste Aktionen“ wird der Wert für eine Dimension angegeben, nachdem der Nutzer einen Schritt, aber noch 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
. Trichterschritt gelangt ist, aber bevor er den i+1
. Trichterschritt erreicht hat.
JSON-Darstellung |
---|
{
"nextActionDimension": {
object ( |
Felder | |
---|---|
nextActionDimension |
Die Dimensionsspalte, die in der Antwort des Teilberichts zur Trichtervisualisierung hinzugefügt wurde. Die Dimension „Nächste Aktionsdimension“ 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 |
FunnelVisualizationType
Damit 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 |
Ein Trichter mit Zeitverlauf (Liniendiagramm). Der Teilbericht zur 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 „Segment“ genannt. 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 der Ereignisse, 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 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 |
Definiert, welche Nutzer in diesem Segment ausgeschlossen werden. Optional. |
UserSegmentCriteria
Ein Nutzer erfüllt ein Kriterium, wenn seine Ereignisse 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 ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Dieser Gültigkeitsbereich definiert, für wie viele Ereignisse Optional. Wenn nicht angegeben, wird |
segmentFilterExpression |
Die Daten werden in das Segment ein- oder ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter aus. |
UserCriteriaScoping
Der Gültigkeitsbereich gibt an, welche Ereignisse bei der Beurteilung, ob ein Nutzer ein Kriterium erfüllt, berücksichtigt werden.
Enums | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Kriteriumsumfang. 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 sind, erfüllt der Nutzer sie. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Wenn ein Ereignis die Kriterien für den Nutzer erfüllt, 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 |
SegmentFilterExpression in |
notExpression |
SegmentFilterExpression ist NICHT |
segmentFilter |
Ein einfacher Segmentfilter. |
segmentEventFilter |
Erstellt einen Filter, der 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[] |
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 eine Filterart für Filter an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Filter für Strings. |
inListFilter |
Ein Filter für in Listenwerten. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte. |
betweenFilter |
Ein Filter für zwischen zwei Werten. |
SegmentFilterScoping
Bereiche geben an, wie die Dimensionen und Messwerte mehrerer Ereignisse bei der Bewertung eines Segmentfilters berücksichtigt werden sollen.
JSON-Darstellung |
---|
{ "atAnyPointInTime": boolean } |
Felder | |
---|---|
atAnyPointInTime |
Wenn Der Dieser Lautet der Kriterienumfang |
SegmentEventFilter
Erstellt einen Filter, der 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 dieses Flag angegeben ist, sucht dieser Filter nach Ereignissen, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. Im Parameterfilterausdruck sind nur Parameterfilter verfügbar. |
SegmentParameterFilterExpression
Gibt Kombinationen von Segmentfiltern für Parameter an.
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 von 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 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 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 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 eine Filterart an. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Filter für 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
Bereiche geben an, wie mehrere Ereignisse bei der Auswertung eines Segmentparameterfilters berücksichtigt werden.
JSON-Darstellung |
---|
{ "inAnyNDayPeriod": string } |
Felder | |
---|---|
inAnyNDayPeriod |
Akkumuliert den Parameter über einen bestimmten Zeitraum von Tagen, bevor der Filter angewendet wird. Wird nur unterstützt, wenn der Kriterienumfang Beispiel: Wenn Der Zeitraum wird nicht erweitert, um ein Zeitfenster von n Tagen kurz vor Beginn des Zeitraums zu haben. Beispiel: Wenn ein Bericht für den 01.11.2021 bis 10.11.2021 gilt und
|
UserSegmentSequenceGroup
Definieren Sie Bedingungen, die in einer bestimmten Reihenfolge eintreten 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. Beispiel: Bei Optional. Wenn nicht angegeben, 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 alle Schritte abschließen, damit der Nutzer mit |
UserSequenceStep
Eine Bedingung, die in der angegebenen Schrittreihenfolge eintreten muss, damit der Nutzer der Sequenz entspricht.
JSON-Darstellung |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
Felder | |
---|---|
isDirectlyFollowedBy |
Wenn der Wert „true“ ist, 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. So können beispielsweise Ereignisse zwischen dem vorherigen und diesem Schritt auftreten. |
stepScoping |
Dieser Sequenzschritt muss im Gültigkeitsbereich erfüllt sein, damit der Nutzer der Sequenz entsprechen kann. Beispiel: Bei Optional. Wenn kein Wert angegeben ist, verwendet |
segmentFilterExpression |
Ein Nutzer entspricht diesem Sequenzschritt, wenn seine Ereignisse mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter aus. |
UserSegmentExclusion
Gibt an, welche Nutzer in diesem Segment ausgeschlossen werden.
JSON-Darstellung |
---|
{ "userExclusionDuration": enum ( |
Felder | |
---|---|
userExclusionDuration |
Gibt an, wie lange ein Ausschluss bestehen bleibt, wenn ein Nutzer mit Optional. Wenn kein Wert angegeben ist, wird |
userExclusionCriteria |
Erfüllt ein Nutzer diese Bedingung, wird er von der Mitgliedschaft im Segment für |
UserExclusionDuration
Listet Optionen für die Dauer eines Ausschlusses auf, wenn ein Nutzer mit userExclusionCriteria
übereinstimmt.
Enums | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
USER_EXCLUSION_TEMPORARY |
Schließen Sie vorübergehend Nutzer aus dem Segment aus, wenn sie die Bedingung userExclusionCriteria erfüllen. |
USER_EXCLUSION_PERMANENT |
Nutzer, die die Bedingung userExclusionCriteria 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 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 ausgeschlossen, je nachdem, ob sie mit der Bedingungsgruppe übereinstimmen. Dieser Gültigkeitsbereich definiert, für wie viele Ereignisse Optional. Wenn kein Wert angegeben ist, wird |
segmentFilterExpression |
Die Daten werden in das Segment ein- oder ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter aus. |
SessionCriteriaScoping
Mit dem Umfang legen Sie fest, welche Ereignisse bei der Beurteilung, ob eine Sitzung ein Kriterium erfüllt, berücksichtigt werden.
Enums | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Nicht angegebener Kriteriumsumfang. Keine Angabe. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt die Sitzung diese Kriterien. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Wenn die Kriterien innerhalb einer Sitzung erfüllt sind, erfüllt die Sitzung sie. |
SessionSegmentExclusion
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 |
Wenn eine Sitzung diese Bedingung erfüllt, wird sie von der Mitgliedschaft im Segment für |
SessionExclusionDuration
Listet Optionen für die Dauer eines Ausschlusses auf, wenn eine Sitzung mit sessionExclusionCriteria
übereinstimmt.
Enums | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Nicht angegebene Ausschlussdauer. Keine Angabe. |
SESSION_EXCLUSION_TEMPORARY |
Schließen Sie Sitzungen in Zeiträumen, in denen die Sitzung die Bedingung sessionExclusionCriteria erfüllt, vorübergehend aus dem Segment aus. |
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 entspricht diesen 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 |
Die Daten werden in das Segment ein- oder ausgeschlossen, je nachdem, ob sie mit diesem Ausdruck übereinstimmen. Ausdrücke geben Kriterien für Dimensionen, Messwerte und/oder Parameter aus. |
EventCriteriaScoping
Mit dem Umfang 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 Kriteriumsumfang. Keine Angabe. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Wenn die Kriterien innerhalb eines Ereignisses erfüllt sind, erfüllt es auch das Kriterium. |
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
Zählt Optionen für die Dauer eines Ausschlusses auf, 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, wenn sie die Bedingung eventExclusionCriteria erfüllen. |
FilterExpression
Zum Ausdrucken 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 NOT von notExpression. |
filter |
Ein einfacher Filter. In derselben FilterExpression müssen alle Feldnamen des Filters entweder alle Dimensionen oder alle Messwerte sein. |
FilterExpressionList
Eine Liste von Filterausdrücken.
JSON-Darstellung |
---|
{
"expressions": [
{
object ( |
Felder | |
---|---|
expressions[] |
Eine Liste von Filterausdrücken. |
Filtern
Ein Ausdruck zum Filtern von Dimensions- oder Messwerten.
JSON-Darstellung |
---|
{ "fieldName": string, // Union field |
Felder | |
---|---|
fieldName |
Der Name der Dimension oder des Messwerts Muss ein Name sein, der in Dimensionen oder Messwerten definiert ist. |
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 für 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. |
FunnelSubReport
Untergeordnete Berichte vom Typ „Trichter“ 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, Datumsangaben und nächste Aktionen in der Antwort enthalten sein. |
metricHeaders[] |
Beschreibt Messwertspalten. Trichterberichte enthalten immer aktive Nutzer in Antworten auf untergeordnete Berichte. 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. Die in einem Bericht angeforderten 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 Kopfzeilen generiert.
JSON-Darstellung |
---|
{ "name": string } |
Felder | |
---|---|
name |
Der Name der Dimension |
MetricHeader
Beschreibt eine Messwertspalte im Bericht. Sichtbare Messwerte, die in einem Bericht angefordert werden, generieren 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 generiert. Daher werden für diese Messwerte auch keine Überschriften generiert.
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 |
Eine Dauer in Millisekunden; ein spezieller Gleitkommatyp. |
TYPE_MINUTES |
Eine Dauer in Minuten; ein spezieller Gleitkommatyp. |
TYPE_HOURS |
Eine Dauer in Stunden; ein spezieller Gleitkommatyp. |
TYPE_STANDARD |
Ein benutzerdefinierter Messwert vom Typ „Standard“, also 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. Beispiel: „RunReportRequest“ enthält Folgendes:
"dimensions": [
{
"name": "eventName"
},
{
"name": "countryId"
}
],
"metrics": [
{
"name": "eventCount"
}
]
Eine Zeile mit „in_app_purchase“ als „eventName“, „JP“ als countryId und 15 als „eventCount“ würde wie folgt aussehen:
"dimensionValues": [
{
"value": "in_app_purchase"
},
{
"value": "JP"
}
],
"metricValues": [
{
"value": "15"
}
]
JSON-Darstellung |
---|
{ "dimensionValues": [ { object ( |
Felder | |
---|---|
dimensionValues[] |
Liste der angeforderten Dimensionswerte. In Pivot-Berichten werden „dimensionValues“ nur für Dimensionen aufgeführt, 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 eine Art von 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 Messwerte one_value kann nur einer der folgenden Werte sein: |
|
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, die im Trichterbericht verwendet wurden. Für jeden Zeitraum wird ein Wenn für die Ergebnisse jedoch keine Stichproben verwendet werden, wird dieses Feld nicht definiert. |
SamplingMetadata
Wenn es sich bei den Ergebnissen des Trichterberichts um Stichproben handelt, 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 |
Die Gesamtzahl der Ereignisse, die in diesem Stichprobenbericht für einen bestimmten 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 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 eine Property erschöpft ist, wird bei allen Anfragen an diese Property der Fehler „Ressource erschöpft“ zurückgegeben.
JSON-Darstellung |
---|
{ "tokensPerDay": { object ( |
Felder | |
---|---|
tokensPerDay |
Für Standard-Analytics-Properties sind pro Tag bis zu 200.000 Tokens 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 Standard-Analytics-Properties sind bis zu 40.000 Tokens pro Stunde und für Analytics 360-Properties 400.000 Tokens pro Stunde möglich. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens und diese Zahl wird von allen Stunden-, Tages- und Projektkontingenten abgezogen. |
concurrentRequests |
Standard-Analytics-Properties können bis zu 10 gleichzeitige Anfragen senden, bei Analytics 360-Properties sind es bis zu 50 gleichzeitige Anfragen. |
serverErrorsPerProjectPerHour |
Standardmäßige Analytics-Properties und Cloud-Projektpaare können bis zu 10 Serverfehler pro Stunde enthalten. Paare von Analytics 360-Properties und Cloud-Projekten können bis zu 50 Serverfehler pro Stunde haben. |
potentiallyThresholdedRequestsPerHour |
Analytics-Properties können pro Stunde bis zu 120 Anfragen mit Dimensionen senden, für die möglicherweise Grenzwerte festgelegt wurden. Bei einer Batchanfrage wird jede Berichtsanfrage einzeln für dieses Kontingent gezählt, wenn die Anfrage Dimensionen mit potenziell Grenzwerten enthält. |
tokensPerProjectPerHour |
Analytics-Properties können bis zu 35% der Tokens pro Projekt und Stunde verwenden. Standardmäßige Analytics-Properties können also bis zu 14.000 Tokens pro Projekt und Stunde verwenden, Analytics 360-Properties dagegen 140.000 Tokens pro Projekt und Stunde. Eine API-Anfrage verbraucht eine einzelne Anzahl von Tokens und diese Zahl wird von allen Stunden-, Tages- und Projektkontingenten abgezogen. |
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. |