- HTTP-Anfrage
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ReportRequest
- Stichproben
- Dimension
- DimensionFilterClause
- FilterLogicalOperator
- DimensionFilter
- Operator
- Messwert
- MetricType
- MetricFilterClause
- MetricFilter
- Operator
- OrderBy
- OrderType
- SortOrder
- Segment
- DynamicSegment
- SegmentDefinition
- SegmentFilter
- SimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- Operator
- SegmentMetricFilter
- Ebene
- Operator
- SequenceSegment
- SegmentSequenceStep
- MatchType
- Pivot-Tabelle
- CohortGroup
- Kohorte
- Typ
- Melden
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- ReportData
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasRemaining
- Testen!
Gibt die Analytics-Daten zurück.
HTTP-Anfrage
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung | |
---|---|
{
"reportRequests": [
{
object( |
Felder | |
---|---|
reportRequests[] |
Jede Anfrage erhält eine separate Antwort. Es sind maximal fünf Anfragen möglich. Alle Anfragen sollten dieselben Werte für |
useResourceQuotas |
Aktiviert ressourcenbasierte Kontingente (standardmäßig |
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Die Hauptantwortklasse, die die Berichte aus dem batchGet
-Aufruf der Reporting API enthält.
JSON-Darstellung | |
---|---|
{ "reports": [ { object( |
Felder | |
---|---|
reports[] |
Antworten, die den einzelnen Anfragen entsprechen. |
queryCost |
Die Menge der Ressourcenkontingenttokens, die zum Ausführen der Abfrage abgezogen wurden. Enthält alle Antworten. |
resourceQuotasRemaining |
Das verbleibende Ressourcenkontingent für die Property. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ReportRequest
Die Hauptanfrageklasse, die die Reporting API-Anfrage angibt.
JSON-Darstellung | |
---|---|
{ "viewId": string, "dateRanges": [ { object( |
Felder | |
---|---|
viewId |
Die ID der Analytics-Datenansicht, für die Daten abgerufen werden sollen Jede ReportRequest innerhalb einer |
dateRanges[] |
Zeiträume in der Anfrage. Die Anfrage kann maximal zwei Zeiträume umfassen. Die Antwort enthält eine Reihe von Messwerten für jede Kombination der Dimensionen für jeden Zeitraum in der Anfrage. Wenn es also zwei Zeiträume gibt, werden zwei Messwerte angezeigt: einer für den ursprünglichen Zeitraum und einer für den zweiten Zeitraum. Das Feld „ |
samplingLevel |
Die gewünschte Stichprobengröße für den Bericht. Wenn das Feld |
dimensions[] |
Die angeforderten Abmessungen. Anfragen können insgesamt 9 Dimensionen haben. |
dimensionFilterClauses[] |
Die Dimensionsfilterklauseln zum Filtern von Dimensionswerten Sie werden logisch mit dem Operator |
metrics[] |
Die angeforderten Messwerte. In Anfragen muss mindestens ein Messwert angegeben werden. Anfragen können insgesamt 10 Messwerte haben. |
metricFilterClauses[] |
Die Messwertfilterklauseln. Sie werden logisch mit dem Operator |
filtersExpression |
Dimensions- oder Messwertfilter, die die für Ihre Anfrage zurückgegebenen Daten einschränken. Wenn Sie |
orderBys[] |
Sortierreihenfolge der Ausgabezeilen. Um zwei Zeilen zu vergleichen, werden die folgenden Elemente der Reihe nach angewendet, bis eine Differenz gefunden wird. Alle Zeiträume in der Ausgabe erhalten dieselbe Zeilenreihenfolge. |
segments[] |
Segmentieren Sie die für die Anfrage zurückgegebenen Daten. Eine Segmentdefinition hilft dabei, einen Teil der Segmentanfrage zu betrachten. Eine Anfrage kann bis zu vier Segmente enthalten. Jeder ReportRequest innerhalb einer |
pivots[] |
Die Pivot-Definitionen Anfragen können maximal zwei Pivots haben. |
cohortGroup |
Die mit dieser Anfrage verknüpfte Kohortengruppe. Wenn die Anfrage eine Kohortengruppe enthält, muss die Dimension |
pageToken |
Fortsetzungs-Token für den Abruf der nächsten Ergebnisseite. Wenn Sie dies zur Anfrage hinzufügen, werden die Zeilen nach dem pageToken zurückgegeben. Das pageToken sollte der Wert sein, der im Parameter „nextPageToken“ in der Antwort auf die Anfrage „reports.batchGet“ zurückgegeben wird. |
pageSize |
Die Seitengröße gilt für das Paging und gibt die maximale Anzahl der zurückgegebenen Zeilen an. Die Seitengröße muss größer als 0 sein. Eine Abfrage gibt standardmäßig 1.000 Zeilen zurück. Die Analytics Core Reporting API gibt maximal 100.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen Sie anfordern. Es können auch weniger Zeilen als angefordert zurückgegeben werden, wenn nicht so viele Dimensionssegmente wie erwartet vorhanden sind. Wenn für |
includeEmptyRows |
Wenn der Wert auf „false“ gesetzt ist, enthält die Antwort keine Zeilen, wenn alle abgerufenen Messwerte gleich null sind. Der Standardwert ist „false“, wodurch diese Zeilen ausgeschlossen werden. |
hideTotals |
Wenn die Richtlinie auf „true“ gesetzt ist, wird die Summe aller Messwerte für alle übereinstimmenden Zeilen und für jeden Zeitraum ausgeblendet. Der Standardwert ist „false“ und gibt die Gesamtsummen zurück. |
hideValueRanges |
Wenn die Richtlinie auf „true“ gesetzt ist, werden die Mindest- und Höchstwerte in allen übereinstimmenden Zeilen ausgeblendet. Der Standardwert ist „false“ und die Wertebereiche werden zurückgegeben. |
Probenahme
Werte für die Stichprobenebene.
Enums | |
---|---|
SAMPLING_UNSPECIFIED |
Wenn das Feld samplingLevel nicht angegeben ist, wird die Stichprobenebene DEFAULT verwendet. |
DEFAULT |
Gibt die Antwort mit einer Stichprobengröße zurück, die ein Gleichgewicht zwischen Geschwindigkeit und Genauigkeit herstellt. |
SMALL |
Sie gibt eine schnelle Antwort mit einer kleineren Stichprobengröße zurück. |
LARGE |
Gibt mithilfe einer großen Stichprobe eine genauere Antwort zurück. Dies kann jedoch dazu führen, dass die Reaktionszeit langsamer ist. |
Dimension
Dimensionen sind Attribute Ihrer Daten. Die Dimension ga:city
gibt beispielsweise die Stadt an, in der die Sitzung gestartet wurde, etwa „Paris“ oder „New York“.
JSON-Darstellung | |
---|---|
{ "name": string, "histogramBuckets": [ string ] } |
Felder | |
---|---|
name |
Name der abzurufenden Dimension, z. B. |
histogramBuckets[] |
Wenn sie nicht leer ist, werden Dimensionswerte in Buckets nach dem String „int64“ platziert. Dimensionswerte, die nicht die Zeichenfolgendarstellung eines Integralwerts sind, werden in Null umgewandelt. Die Bucket-Werte müssen in aufsteigender Reihenfolge angegeben werden. Jeder Bucket wird am unteren Ende geschlossen und am oberen Ende offen. Der „erste“ Bucket enthält alle Werte, die kleiner als der erste Grenzwert sind, der „letzte“ Bucket alle Werte bis unendlich. Dimensionswerte, die in eine Gruppe fallen, werden in einen neuen Dimensionswert umgewandelt. Wenn zum Beispiel eine Liste mit "0, 1, 3, 4, 7" zurückgegeben wird, werden die folgenden Buckets zurückgegeben:
HINWEIS: Wenn Sie eine Histogrammmutation auf eine Dimension anwenden und diese Dimension zum Sortieren verwenden, sollten Sie hierfür den Sortiertyp „<50“, „1001+“, „121–1000“, „50–120“ Und die aufsteigende „<50“, „50–120“, „121–1000“, „1001+“ Der Client muss für eine mit dem Histogramm veränderte Dimension explizit |
DimensionFilterClause
Eine Gruppe von Dimensionsfiltern. Legen Sie den Operatorwert fest, um anzugeben, wie die Filter logisch kombiniert werden sollen.
JSON-Darstellung | |
---|---|
{ "operator": enum( |
Felder | |
---|---|
operator |
Der Operator zum Kombinieren mehrerer Dimensionsfilter. Wenn keine Angabe erfolgt, wird es als |
filters[] |
Der wiederholte Satz von Filtern. Sie werden basierend auf dem angegebenen Operator logisch kombiniert. |
FilterLogicalOperator
Wie die Filter logisch kombiniert werden.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Der Operator ist nicht angegeben. Er wird als OR behandelt. |
OR |
Der logische Operator OR . |
AND |
Der logische Operator AND . |
DimensionFilter
Mit einem Dimensionsfilter werden die Filteroptionen für eine Dimension festgelegt.
JSON-Darstellung | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
Felder | |
---|---|
dimensionName |
Die Dimension, nach der gefiltert werden soll. Ein DimensionsFilter muss eine Dimension enthalten. |
not |
Logischer |
operator |
Hiermit wird die Dimension mit dem Ausdruck abgeglichen. Der Standardwert ist REGEXP. |
expressions[] |
Strings oder regulärer Ausdruck für den Abgleich Für den Vergleich wird nur der erste Wert der Liste verwendet, es sei denn, der Operator ist |
caseSensitive |
Muss bei dem Abgleich zwischen Groß- und Kleinschreibung unterschieden werden? Der Standardwert ist "false". |
Operator
Es werden unterschiedliche Keyword-Optionen unterstützt.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Wenn der Übereinstimmungstyp nicht angegeben ist, wird er als REGEXP behandelt. |
REGEXP |
Der Übereinstimmungsausdruck wird als regulärer Ausdruck behandelt. Nicht alle Keyword-Optionen werden als reguläre Ausdrücke behandelt. |
BEGINS_WITH |
Stimmt mit dem Wert überein, der mit dem angegebenen Übereinstimmungsausdruck beginnt. |
ENDS_WITH |
Gleicht die Werte ab, die mit dem angegebenen Übereinstimmungsausdruck enden. |
PARTIAL |
Teilstring-Übereinstimmung. |
EXACT |
Der Wert sollte vollständig mit dem Übereinstimmungsausdruck übereinstimmen. |
NUMERIC_EQUAL |
Ganzzahlvergleichsfilter. Die Groß-/Kleinschreibung wird für diese Filter ignoriert und es wird angenommen, dass der Ausdruck ein String ist, der eine Ganzzahl darstellt. Fehlerbedingungen:
|
NUMERIC_GREATER_THAN |
Überprüft, ob die Dimension numerisch größer als der Übereinstimmungsausdruck ist. Lies dir die Beschreibung von NUMERIC_EQUALS durch, um Informationen zu Einschränkungen zu erhalten. |
NUMERIC_LESS_THAN |
Überprüft, ob die Dimension numerisch kleiner als der Übereinstimmungsausdruck ist. Lies dir die Beschreibung von NUMERIC_EQUALS durch, um Informationen zu Einschränkungen zu erhalten. |
IN_LIST |
Mit dieser Option wird ein Dimensionsfilter angegeben, dessen Ausdruck einen beliebigen Wert aus einer ausgewählten Werteliste annehmen kann. So vermeiden Sie, dass mehrere Dimensionsfilter vom Typ „Genau passend“ ausgewertet werden, die für jede einzelne Antwortzeile mit ODER verknüpft sind. Beispiel:
Jede Antwortzeile, deren Dimension den Wert A, B oder C hat, entspricht diesem DimensionsFilter. |
Messwert
Messwerte sind die quantitativen Messungen. Der Messwert ga:users
gibt beispielsweise die Gesamtzahl der Nutzer für den angeforderten Zeitraum an.
JSON-Darstellung | |
---|---|
{
"expression": string,
"alias": string,
"formattingType": enum( |
Felder | |
---|---|
expression |
Ein Messwertausdruck in der Anfrage. Ein Ausdruck wird aus einem oder mehreren Messwerten und Zahlen erstellt. Zulässige Operatoren sind: Plus (+), Minus (-), Negation (Unär -), Geteilt durch (/), Multipliziert durch (*), Klammern, positive Kardinalzahlen (0–9). Sie können Dezimalzahlen enthalten und sind auf 1.024 Zeichen beschränkt. Beispiel |
alias |
Ein Alias für den Messwertausdruck ist ein alternativer Name für den Ausdruck. Der Alias kann zum Filtern und Sortieren verwendet werden. Dieses Feld ist optional und nützlich, wenn der Ausdruck kein einzelner Messwert, sondern ein komplexer Ausdruck ist, der nicht zum Filtern und Sortieren verwendet werden kann. Der Alias wird auch in der Kopfzeile der Antwortspalte verwendet. |
formattingType |
Gibt an, wie der Messwertausdruck formatiert werden soll, z. B. |
MetricType
Die Arten von Messwerten.
Enums | |
---|---|
METRIC_TYPE_UNSPECIFIED |
Der Messwerttyp ist nicht angegeben. |
INTEGER |
Ganzzahliger Messwert. |
FLOAT |
Gleitkommawert. |
CURRENCY |
Messwert „Währung“. |
PERCENT |
Prozentsatz |
TIME |
Zeitmesswert im Format HH:MM:SS . |
MetricFilterClause
Stellt eine Gruppe von Messwertfiltern dar. Legen Sie den Operatorwert fest, um anzugeben, wie die Filter logisch kombiniert werden sollen.
JSON-Darstellung | |
---|---|
{ "operator": enum( |
Felder | |
---|---|
operator |
Der Operator zum Kombinieren mehrerer Messwertfilter. Wenn keine Angabe erfolgt, wird es als |
filters[] |
Der wiederholte Satz von Filtern. Sie werden basierend auf dem angegebenen Operator logisch kombiniert. |
MetricFilter
MetricFilter gibt den Filter für einen Messwert an.
JSON-Darstellung | |
---|---|
{
"metricName": string,
"not": boolean,
"operator": enum( |
Felder | |
---|---|
metricName |
Der Messwert, nach dem gefiltert wird. Ein Messwertfilter muss einen Messwertnamen enthalten. Ein Messwertname kann ein Alias sein, der zuvor als Messwert definiert wurde, oder er kann auch ein Messwertausdruck sein. |
not |
Logischer |
operator |
Ist der Messwert |
comparisonValue |
Wert, mit dem verglichen werden soll |
Operator
Verschiedene Vergleichstypen
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Wenn der Operator nicht angegeben ist, wird er als EQUAL behandelt. |
EQUAL |
Muss der Wert des Messwerts genau mit dem Vergleichswert übereinstimmen. |
LESS_THAN |
Der Wert des Messwerts sollte kleiner als der Vergleichswert sein. |
GREATER_THAN |
Gibt an, ob der Messwert größer als der Vergleichswert ist. |
IS_MISSING |
Überprüft, ob der Messwert fehlt. Der Vergleichswert wird nicht berücksichtigt. |
OrderBy
Gibt die Sortieroptionen an.
JSON-Darstellung | |
---|---|
{ "fieldName": string, "orderType": enum( |
Felder | |
---|---|
fieldName |
Das Feld, nach dem sortiert werden soll. Die Standardsortierreihenfolge ist aufsteigend. Beispiel: |
orderType |
Die Auftragsart. Der Standardwert für orderType ist |
sortOrder |
Die Sortierreihenfolge für das Feld. |
OrderType
OrderType steuert, wie die Sortierreihenfolge bestimmt wird.
Enums | |
---|---|
ORDER_TYPE_UNSPECIFIED |
Wenn der Bestelltyp nicht angegeben ist, wird er wie eine Sortierung auf Grundlage des Werts behandelt. |
VALUE |
Die Sortierreihenfolge basiert auf dem Wert der ausgewählten Spalte. Es wird nur der erste Zeitraum berücksichtigt. |
DELTA |
Die Sortierreihenfolge basiert auf der Differenz der Werte der ausgewählten Spalte zwischen den ersten beiden Datumsbereichen. Kann nur verwendet werden, wenn es genau zwei Zeiträume gibt. |
SMART |
Die Sortierreihenfolge basiert auf dem gewichteten Wert der ausgewählten Spalte. Wenn die Spalte das Format „n/d“ hat, ist der gewichtete Wert dieses Verhältnisses (n + totals.n)/(d + totals.d) . Er kann nur für Messwerte verwendet werden, die Verhältnisse darstellen. |
HISTOGRAM_BUCKET |
Der Typ der Histogrammreihenfolge gilt nur für Dimensionsspalten mit nicht leeren Histogramm-Buckets. |
DIMENSION_AS_INTEGER |
Wenn es sich bei den Abmessungen um Zahlen mit fester Länge handelt, reicht eine gewöhnliche Sortierung aus. DIMENSION_AS_INTEGER kann verwendet werden, wenn die Abmessungen aus Zahlen mit variabler Länge bestehen. |
SortOrder
Die Sortierreihenfolge der Sortierung.
Enums | |
---|---|
SORT_ORDER_UNSPECIFIED |
Wenn keine Sortierreihenfolge angegeben ist, wird standardmäßig aufsteigend verwendet. |
ASCENDING |
Aufsteigend. Das Feld wird aufsteigend sortiert. |
DESCENDING |
Absteigende Sortierung. Das Feld wird absteigend sortiert. |
Segment
Die Segmentdefinition, wenn der Bericht segmentiert werden muss Ein Segment ist eine Teilmenge der Analytics-Daten. Beispielsweise könnten Nutzer aus einem bestimmten Land oder einer bestimmten Stadt ein Segment aller Nutzer sein.
JSON-Darstellung | |
---|---|
{ // Union field |
Felder | ||
---|---|---|
Union-Feld dynamicOrById . Das Segment kann dynamisch über DynamicSegment oder über die ID eines integrierten oder benutzerdefinierten Segments definiert werden. Für dynamicOrById ist nur einer der folgenden Werte zulässig: |
||
dynamicSegment |
Eine dynamische Segmentdefinition in der Anfrage. |
|
segmentId |
Die Segment-ID eines integrierten oder benutzerdefinierten Segments, z. B. |
DynamicSegment
Dynamische Segmentdefinition zum Definieren des Segments in der Anfrage Für ein Segment können Nutzer, Sitzungen oder beides ausgewählt werden.
JSON-Darstellung | |
---|---|
{ "name": string, "userSegment": { object( |
Felder | |
---|---|
name |
Der Name des dynamischen Segments. |
userSegment |
Nutzersegment, um Nutzer auszuwählen, die in das Segment aufgenommen werden sollen. |
sessionSegment |
Sitzungssegment, um Sitzungen auszuwählen, die in das Segment aufgenommen werden sollen. |
SegmentDefinition
SegmentDefinition definiert ein Segment als ein Satz von SegmentFilters, die mit einer logischen AND
-Operation kombiniert werden.
JSON-Darstellung | |
---|---|
{
"segmentFilters": [
{
object( |
Felder | |
---|---|
segmentFilters[] |
Ein Segment wird durch eine Reihe von Segmentfiltern definiert, die mit einer logischen |
SegmentFilter
SegmentFilter definiert, ob das Segment entweder ein einfaches Segment oder ein Sequenzsegment ist. Eine einfache Segmentbedingung enthält Dimensions- und Messwertbedingungen zur Auswahl der Sitzungen oder Nutzer. Eine Bedingung für ein Sequenzsegment kann verwendet werden, um Nutzer oder Sitzungen basierend auf sequenziellen Bedingungen auszuwählen.
JSON-Darstellung | |
---|---|
{ "not": boolean, // Union field |
Felder | ||
---|---|---|
not |
Bei „true“ wird die Ergänzung des einfachen oder Sequenzsegments abgeglichen. Um beispielsweise alle Besuche abzugleichen, die nicht von „New York“ stammen, können wir das Segment wie folgt definieren:
|
|
Union-Feld simpleOrSequence . Handelt es sich um ein einfaches Segment oder eine Sequenzsegmentdefinition? Für simpleOrSequence ist nur einer der folgenden Werte zulässig: |
||
simpleSegment |
Einfache Segmentbedingungen bestehen aus mindestens einer Dimensions-/Messwertbedingung, die kombiniert werden kann |
|
sequenceSegment |
Sequenzbedingungen bestehen aus einem oder mehreren Schritten, wobei jeder Schritt durch eine oder mehrere Dimensions- oder Messwertbedingungen definiert ist. Mehrere Schritte können mit speziellen Sequenzoperatoren kombiniert werden. |
SimpleSegment
Einfache Segmentbedingungen bestehen aus mindestens einer Dimensions- oder Messwertbedingung, die kombiniert werden kann.
JSON-Darstellung | |
---|---|
{
"orFiltersForSegment": [
{
object( |
Felder | |
---|---|
orFiltersForSegment[] |
Eine Liste von Segmentfiltergruppen, die mit dem logischen Operator |
OrFiltersForSegment
Eine Liste der Segmentfilter in der Gruppe OR
wird mit dem logischen ODER-Operator kombiniert.
JSON-Darstellung | |
---|---|
{
"segmentFilterClauses": [
{
object( |
Felder | |
---|---|
segmentFilterClauses[] |
Liste der Segmentfilter, die mit einem |
SegmentFilterClause
Die in einer Segmentdefinition zu verwendende Filterklausel kann entweder ein Messwert oder ein Dimensionsfilter sein.
JSON-Darstellung | |
---|---|
{ "not": boolean, // Union field |
Felder | ||
---|---|---|
not |
Stimmt mit der Ergänzung ( |
|
Union-Feld dimensionOrMetricFilter . Dimension oder Messwertfilter. Für dimensionOrMetricFilter ist nur einer der folgenden Werte zulässig: |
||
dimensionFilter |
Dimensionsfilter für die Segmentdefinition. |
|
metricFilter |
Messwertfilter für die Segmentdefinition. |
SegmentDimensionFilter
Mit einem Dimensionsfilter werden die Filteroptionen für eine Dimension festgelegt.
JSON-Darstellung | |
---|---|
{
"dimensionName": string,
"operator": enum( |
Felder | |
---|---|
dimensionName |
Name der Dimension, auf die der Filter angewendet wird. |
operator |
Der Operator, mit dem die Dimension den Ausdrücken zugeordnet werden soll. |
caseSensitive |
Bei Übereinstimmung muss die Groß-/Kleinschreibung beachtet werden. Wird beim Operator |
expressions[] |
Liste der Ausdrücke – nur das erste Element wird für alle Operatoren verwendet |
minComparisonValue |
Minimale Vergleichswerte für |
maxComparisonValue |
Maximale Vergleichswerte für Keyword-Option |
Operator
Es werden unterschiedliche Keyword-Optionen unterstützt.
Enums | |
---|---|
OPERATOR_UNSPECIFIED |
Wenn der Übereinstimmungstyp nicht angegeben ist, wird er als REGEXP behandelt. |
REGEXP |
Der Übereinstimmungsausdruck wird als regulärer Ausdruck behandelt. Alle anderen Keyword-Optionen werden nicht als reguläre Ausdrücke behandelt. |
BEGINS_WITH |
Gleicht die Werte ab, die mit dem angegebenen Übereinstimmungsausdruck beginnen. |
ENDS_WITH |
Gleicht die Werte ab, die mit dem angegebenen Übereinstimmungsausdruck enden. |
PARTIAL |
Teilstring-Übereinstimmung. |
EXACT |
Der Wert sollte vollständig mit dem Übereinstimmungsausdruck übereinstimmen. |
IN_LIST |
Mit dieser Option wird ein Dimensionsfilter angegeben, dessen Ausdruck einen beliebigen Wert aus einer ausgewählten Werteliste annehmen kann. So vermeiden Sie, dass mehrere Dimensionsfilter vom Typ „Genau passend“ ausgewertet werden, die für jede einzelne Antwortzeile mit ODER verknüpft sind. Beispiel:
Jede Antwortzeile, deren Dimension den Wert A, B oder C hat, entspricht diesem DimensionsFilter. |
NUMERIC_LESS_THAN |
Ganzzahlvergleichsfilter. Die Groß-/Kleinschreibung wird für diese Filter ignoriert und es wird angenommen, dass der Ausdruck ein String ist, der eine Ganzzahl darstellt. Fehlerbedingungen:
Überprüft, ob die Dimension numerisch kleiner als der Übereinstimmungsausdruck ist. |
NUMERIC_GREATER_THAN |
Überprüft, ob die Dimension numerisch größer als der Übereinstimmungsausdruck ist. |
NUMERIC_BETWEEN |
Überprüft, ob die Dimension numerisch zwischen dem Minimum und dem Maximum des Übereinstimmungsausdrucks liegt, wobei Grenzen ausgeschlossen sind. |
SegmentMetricFilter
Messwertfilter, der in einer Segmentfilterklausel verwendet werden soll.
JSON-Darstellung | |
---|---|
{ "scope": enum( |
Felder | |
---|---|
scope |
Der Umfang eines Messwerts bestimmt, auf welcher Ebene er definiert wird. Der angegebene Messwertumfang muss mindestens dem primären Bereich entsprechen, der im Datenmodell definiert ist. Der primäre Umfang wird dadurch bestimmt, ob das Segment Nutzer oder Sitzungen auswählt. |
metricName |
Der Messwert, nach dem gefiltert wird. Ein |
operator |
Gibt den Vorgang an, der ausgeführt werden soll, um den Messwert zu vergleichen. Der Standardwert ist |
comparisonValue |
Wert, mit dem verglichen werden soll Wenn der Operator |
maxComparisonValue |
Der maximale Vergleichswert wird nur für den Operator |
Bereich
Der Umfang eines Messwerts definiert die Ebene, auf der der Messwert definiert ist: PRODUCT
, HIT
, SESSION
oder USER
. Messwerte können auch in Bereichen gemeldet werden, die größer als der primäre Bereich sind. Beispiel: ga:pageviews
und ga:transactions
können auf SESSION
- und USER
-Ebene erfasst werden. Dazu werden sie für jeden Treffer in diesen Sitzungen oder für diese Nutzer addiert.
Enums | |
---|---|
UNSPECIFIED_SCOPE |
Wenn kein Umfang angegeben ist, wird standardmäßig der Bedingungsbereich USER oder SESSION verwendet, je nachdem, ob mit dem Segment Nutzer oder Sitzungen ausgewählt werden sollen. |
PRODUCT |
Produktumfang. |
HIT |
Trefferbereich. |
SESSION |
Sitzungsumfang. |
USER |
Nutzerumfang. |
Operator
Verschiedene Vergleichstypen
Enums | |
---|---|
UNSPECIFIED_OPERATOR |
Ein nicht angegebener Operator wird als Operator LESS_THAN behandelt. |
LESS_THAN |
Überprüft, ob der Messwert kleiner als der Vergleichswert ist. |
GREATER_THAN |
Überprüft, ob der Messwert größer als der Vergleichswert ist. |
EQUAL |
Ist-Operator. |
BETWEEN |
Beim Operator „zwischen“ sind sowohl das Minimum als auch das Maximum ausgeschlossen. Zum Vergleich verwenden wir LT und GT . |
SequenceSegment
Sequenzbedingungen bestehen aus einem oder mehreren Schritten, wobei jeder Schritt durch eine oder mehrere Dimensions- oder Messwertbedingungen definiert ist. Mehrere Schritte können mit speziellen Sequenzoperatoren kombiniert werden.
JSON-Darstellung | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
Felder | |
---|---|
segmentSequenceSteps[] |
Die Liste der Schritte in der Sequenz. |
firstStepShouldMatchFirstHit |
Wenn festgelegt, muss die Bedingung für den ersten Schritt dem ersten Treffer des Besuchers (im Zeitraum) entsprechen. |
SegmentSequenceStep
Eine Definition der Segmentsequenz.
JSON-Darstellung | |
---|---|
{ "orFiltersForSegment": [ { object( |
Felder | |
---|---|
orFiltersForSegment[] |
Eine Sequenz wird mit einer Liste von oder gruppierten Filtern angegeben, die mit dem Operator |
matchType |
Gibt an, ob der Schritt dem nächsten Schritt unmittelbar vorausgeht oder ein beliebiger Zeitpunkt davor sein kann. |
MatchType
Die Keyword-Option für die Sequenz.
Enums | |
---|---|
UNSPECIFIED_MATCH_TYPE |
Eine nicht angegebene Keyword-Option wird als vorangestellt behandelt. |
PRECEDES |
Der Operator gibt an, dass der vorherige Schritt dem nächsten Schritt vorausgeht. |
IMMEDIATELY_PRECEDES |
Der Operator gibt an, dass der vorherige Schritt dem nächsten Schritt unmittelbar vorausgeht. |
Pivot ausführen
Der Pivot beschreibt den Pivot-Abschnitt in der Anfrage. Mithilfe der Pivot-Funktion können Sie die Informationen in der Tabelle für bestimmte Berichte neu anordnen, indem Ihre Daten in einer zweiten Dimension neu angeordnet werden.
JSON-Darstellung | |
---|---|
{ "dimensions": [ { object( |
Felder | |
---|---|
dimensions[] |
Eine Liste der Dimensionen, die als Pivot-Spalten angezeigt werden sollen. Ein Pivot kann maximal vier Dimensionen haben. Pivot-Dimensionen sind Teil der Einschränkung der Gesamtzahl der in der Anfrage zulässigen Dimensionen. |
dimensionFilterClauses[] |
DimensionFilterClauses werden logisch mit einem |
metrics[] |
Die Pivot-Messwerte. Pivot-Messwerte sind Teil der Einschränkung der Gesamtzahl der in der Anfrage zulässigen Messwerte. |
startGroup |
Wenn k Messwerte angefordert wurden, enthält die Antwort ein datenabhängiges Vielfaches von k Spalten im Bericht. Wenn Sie beispielsweise ein Drehpunkt auf die Dimension Im Folgenden können Sie auswählen, welche der Gruppen von k Spalten in der Antwort enthalten sein sollen. |
maxGroupCount |
Gibt die maximale Anzahl von Gruppen an, die zurückgegeben werden sollen. Der Standardwert ist 10, der Maximalwert ist 1.000. |
CohortGroup
Definiert eine Kohortengruppe. Beispiel:
"cohortGroup": {
"cohorts": [{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
},{
"name": "cohort 2"
"type": "FIRST_VISIT_DATE"
"dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
}]
}
JSON-Darstellung | |
---|---|
{
"cohorts": [
{
object( |
Felder | |
---|---|
cohorts[] |
Die Definition für die Kohorte. |
lifetimeValue |
Lifetime-Wert (LTV) aktivieren Der LTV misst den Lifetime-Wert für Nutzer, die über verschiedene Kanäle gewonnen wurden. Weitere Informationen finden Sie unter Kohortenanalyse und Lifetime-Wert, wenn der Lifetime-Wert falsch ist:
Wenn der „LifetimeValue“ wahr ist:
|
Cohort
Definiert eine Kohorte. Eine Kohorte ist eine Gruppe von Nutzenden mit einem gemeinsamen Merkmal. Beispielsweise gehören alle Nutzer mit demselben Akquisitionsdatum zur selben Kohorte.
JSON-Darstellung | |
---|---|
{ "name": string, "type": enum( |
Felder | |
---|---|
name |
Ein eindeutiger Name für die Kohorte. Wenn kein Name festgelegt ist, wird er automatisch mit den Werten „Kohorte_[1234...]“ generiert. |
type |
Typ der Kohorte. Derzeit wird nur der Typ |
dateRange |
Wird für die Kohorte „ |
Typ
Kohortentyp
Enums | |
---|---|
UNSPECIFIED_COHORT_TYPE |
Wenn keine Vorgabe erfolgt, wird sie als FIRST_VISIT_DATE behandelt. |
FIRST_VISIT_DATE |
Kohorten, die auf Grundlage des Datums des ersten Besuchs ausgewählt werden. |
Melden
Die Datenantwort, die der Anfrage entspricht.
JSON-Darstellung | |
---|---|
{ "columnHeader": { object( |
Felder | |
---|---|
columnHeader |
Die Spaltenüberschriften. |
data |
Antwortdaten. |
nextPageToken |
Seitentoken zum Abrufen der nächsten Seite mit Ergebnissen in der Liste. |
ColumnHeader
Spaltenüberschriften.
JSON-Darstellung | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
Felder | |
---|---|
dimensions[] |
Die Dimensionsnamen in der Antwort. |
metricHeader |
Messwertheader für die Messwerte in der Antwort. |
MetricHeader
Die Überschriften für die Messwerte.
JSON-Darstellung | |
---|---|
{ "metricHeaderEntries": [ { object( |
Felder | |
---|---|
metricHeaderEntries[] |
Header für die Messwerte in der Antwort. |
pivotHeaders[] |
Header für die Pivots in der Antwort. |
MetricHeaderEntry
Überschrift für die Messwerte.
JSON-Darstellung | |
---|---|
{
"name": string,
"type": enum( |
Felder | |
---|---|
name |
Der Name des Headers. |
type |
Der Typ des Messwerts, z. B. |
PivotHeader
Die Header für jeden der in der Anfrage definierten Pivot-Abschnitte.
JSON-Darstellung | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
Felder | |
---|---|
pivotHeaderEntries[] |
Eine einzelne Pivot-Abschnittsüberschrift. |
totalPivotGroupsCount |
Die Gesamtzahl der Gruppen für diesen Pivot. |
PivotHeaderEntry
Die Überschriften für die einzelnen Messwertspalten, die den im Pivots-Bereich der Antwort angeforderten Messwerten entsprechen.
JSON-Darstellung | |
---|---|
{
"dimensionNames": [
string
],
"dimensionValues": [
string
],
"metric": {
object( |
Felder | |
---|---|
dimensionNames[] |
Der Name der Dimensionen in der Pivot-Antwort. |
dimensionValues[] |
Die Werte für die Dimensionen im Pivot. |
metric |
Messwertüberschrift für den Messwert im Pivot. |
ReportData
Der Datenteil des Berichts.
JSON-Darstellung | |
---|---|
{ "rows": [ { object( |
Felder | |
---|---|
rows[] |
Für jede eindeutige Kombination von Dimensionen gibt es eine ReportRow. |
totals[] |
Für jeden angeforderten Zeitraum erhält jedes angeforderte Werteformat aus allen Zeilen, die mit der Abfrage übereinstimmen, eine Gesamtsumme. Die Gesamtsumme für ein Wertformat wird berechnet, indem zuerst die im Wertformat erwähnten Messwerte summiert und dann das Wertformat als skalarer Ausdruck ausgewertet wird. Beispiel: In den „Gesamtsummen“ für |
rowCount |
Gesamtzahl der übereinstimmenden Zeilen für diese Abfrage. |
minimums[] |
Minimal- und Maximalwerte, die in allen übereinstimmenden Zeilen angezeigt werden. Beide sind leer, wenn |
maximums[] |
Minimal- und Maximalwerte, die in allen übereinstimmenden Zeilen angezeigt werden. Beide sind leer, wenn |
samplesReadCounts[] |
Wenn die Ergebnisse Stichproben sind, wird die Gesamtzahl der gelesenen Stichproben zurückgegeben, ein Eintrag pro Zeitraum. Wenn die Ergebnisse nicht auf Stichproben basieren, wird dieses Feld nicht definiert. Weitere Informationen finden Sie im Entwicklerleitfaden. |
samplingSpaceSizes[] |
Handelt es sich um Stichproben, wird die Gesamtzahl der vorhandenen Stichproben mit einem Eintrag pro Zeitraum zurückgegeben. Wenn die Ergebnisse nicht auf Stichproben basieren, wird dieses Feld nicht definiert. Weitere Informationen finden Sie im Entwicklerleitfaden. |
isDataGolden |
Gibt an, ob die Antwort auf diese Anfrage golden ist oder nicht. Daten sind golden, wenn genau die gleiche Anfrage keine neuen Ergebnisse liefert, wenn sie zu einem späteren Zeitpunkt abgefragt werden. |
dataLastRefreshed |
Der Zeitpunkt, zu dem die Daten im Bericht zuletzt aktualisiert wurden. Alle Treffer vor diesem Zeitstempel werden in die Berechnung des Berichts einbezogen. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: |
ReportRow
Eine Zeile im Bericht.
JSON-Darstellung | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
Felder | |
---|---|
dimensions[] |
Liste der angeforderten Dimensionen. |
metrics[] |
Liste der Messwerte für jeden angeforderten DateRange. |
DateRangeValues
Wird verwendet, um eine Liste von Messwerten für eine einzelne Kombination aus Datumsbereich und Dimension zurückzugeben
JSON-Darstellung | |
---|---|
{
"values": [
string
],
"pivotValueRegions": [
{
object( |
Felder | |
---|---|
values[] |
Jeder Wert entspricht jedem Messwert in der Anfrage. |
pivotValueRegions[] |
Die Werte der einzelnen Pivot-Regionen. |
PivotValueRegion
Die Messwerte in der Pivot-Region.
JSON-Darstellung | |
---|---|
{ "values": [ string ] } |
Felder | |
---|---|
values[] |
Die Werte der Messwerte in jeder Pivot-Region. |
ResourceQuotasRemaining
Die Ressourcenkontingenttokens, die nach Abschluss der Anfrage für das Attribut verbleiben.
JSON-Darstellung | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
Felder | |
---|---|
dailyQuotaTokensRemaining |
Verbleibendes Tageskontingent für Ressourcen. |
hourlyQuotaTokensRemaining |
Verbleibende Tokens für stündliche Ressourcenkontingente. |