Core Reporting API – Referenzhandbuch

Beachten Sie bei der Verwendung von dimensions in einer Datenanfrage die folgenden Einschränkungen:

• Sie können in einer Abfrage maximal 7 Dimensionen angeben.
• Sie können keine Abfrage senden, die nur aus Dimensionen besteht. Sie müssen alle angeforderten Dimensionen mit mindestens einem Messwert kombinieren.
• Nur bestimmte Dimensionen können in derselben Abfrage abgefragt werden. Mit dem gültigen Kombinationstool in der Referenz zu Dimensionen und Messwerten können Sie sehen, welche Dimensionen zusammen verwendet werden können.

• Jede Anfrage muss mindestens einen Messwert enthalten. Eine Anfrage darf nicht nur aus Dimensionen bestehen.
• Sie können für jede Abfrage maximal zehn Messwerte angeben.
• Die meisten Kombinationen von Messwerten aus mehreren Kategorien können gemeinsam verwendet werden, sofern keine Dimensionen angegeben sind.
• Ein Messwert kann in Kombination mit anderen Dimensionen oder Messwerten verwendet werden, aber nur, wenn für diesen Messwert gültige Kombinationen gelten. Weitere Informationen finden Sie in der Referenz zu Dimensionen und Messwerten.

Eine Liste von Messwerten und Dimensionen, die die Sortierreihenfolge und Sortierrichtung für die zurückgegebenen Daten angibt.

• Die Reihenfolge wird in der Reihenfolge der aufgeführten Messwerte und Dimensionen von links nach rechts festgelegt.
• Die Richtung wird standardmäßig aufsteigend sortiert und kann durch Verwendung eines Minuszeichens (-) im angeforderten Feld in absteigend geändert werden.

Wenn Sie die Ergebnisse einer Abfrage sortieren, können Sie verschiedene Fragen zu Ihren Daten stellen. Beispielsweise zur Beantwortung der Frage „Was sind meine wichtigsten Länder und welche Browser werden am häufigsten verwendet?“ können Sie eine Abfrage mit dem folgenden Parameter erstellen. Es wird zuerst in aufsteigender Reihenfolge nach ga:country und dann nach ga:browser sortiert:

sort=ga:country,ga:browser

sort=ga:browser,ga:country

Beachte bei der Verwendung des Parameters sort Folgendes:

• Sortieren Sie nur nach Dimensionen oder Messwerten, die Sie in den Parametern dimensions oder metrics verwendet haben. Wenn die Anfrage nach einem Feld sortiert wird, das weder im Parameter „dimensions“ noch im Messwert angegeben ist, erhalten Sie eine Fehlermeldung.
• Standardmäßig sind Strings in der Sprache en-US in aufsteigender alphabetischer Reihenfolge sortiert.
• Zahlen werden standardmäßig in aufsteigender numerischer Reihenfolge sortiert.
• Standardmäßig sind die Datumsangaben in aufsteigender Reihenfolge nach Datum sortiert.

Der Abfragestringparameter filters schränkt die von Ihrer Anfrage zurückgegebenen Daten ein. Wenn Sie den Parameter filters verwenden möchten, geben Sie eine Dimension oder einen Messwert für den Filter an, gefolgt vom Filterausdruck. Beispiel: Die folgende Abfrage fordert ga:pageviews und ga:browser für die Datenansicht (Profil) 12134 an, wobei die Dimension ga:browser mit dem String Firefox beginnt:

https://www.googleapis.com/analytics/v3/data/ga
?ids=ga:12134
&dimensions=ga:browser
&metrics=ga:pageviews
&filters=ga:browser%3D~%5EFirefox
&start-date=2007-01-01
&end-date=2007-12-31

Gefilterte Abfragen schränken die Zeilen ein, die in das Ergebnis aufgenommen werden (oder nicht). Jede Zeile im Ergebnis wird mit dem Filter verglichen: Wenn der Filter übereinstimmt, wird die Zeile beibehalten und wenn sie nicht übereinstimmt, wird die Zeile gelöscht.

• URL-Codierung: Die Google API-Clientbibliotheken codieren die Filteroperatoren automatisch.
• Dimensionsfilter: Die Filterung wird vor der Aggregation von Dimensionen durchgeführt. Die zurückgegebenen Messwerte stellen also nur die Gesamtsumme für die relevanten Dimensionen dar. Im Beispiel oben ist nur die Anzahl der Seitenaufrufe gemeint, bei denen Firefox der Browser ist.
• Messwertfilterung: Das Filtern von Messwerten wird nach dem Zusammenfassen der Messwerte durchgeführt.
• Gültige Kombinationen: Sie können nach einer Dimension oder einem Messwert filtern, die nicht Teil Ihrer Abfrage ist, sofern alle Dimensionen/Messwerte in der Anfrage und der Filter gültige Kombinationen enthalten. Beispielsweise können Sie nach einer Liste von Seitenaufrufen abfragen und nach einem bestimmten Browser filtern. Weitere Informationen finden Sie in der Referenz zu Dimensionen und Messwerten.

Filtersyntax

Für einen einzelnen Filter wird folgendes Format verwendet:

ga:name operator expression

In dieser Syntax gilt:

• name: Der Name der Dimension oder des Messwerts, nach dem gefiltert wird. Beispiel: ga:pageviews filtert nach dem Messwert „Seitenaufrufe“.
• operator – Definiert die Art der zu verwendenden Filterübereinstimmung. Operatoren beziehen sich speziell auf Dimensionen oder Messwerte.
• Ausdruck: Gibt die Werte an, die in den Ergebnissen enthalten oder davon ausgeschlossen sein sollen. Für Ausdrücke wird die Syntax von regulären Ausdrücken verwendet.

Operatoren filtern

Es gibt sechs Filteroperatoren für Dimensionen und sechs Filteroperatoren für Messwerte. Die Operatoren müssen URL-codiert sein, um in URL-Abfragestrings eingefügt zu werden.

Tipp: Verwende den Datenfeed-Abfrage-Explorer zum Entwerfen von Filtern, die eine URL-Codierung erfordern, da der Abfrage-Explorer URLS mit Strings und Leerzeichen automatisch codiert.

Filterausdrücke

Für Filterausdrücke gibt es einige wichtige Regeln:

• Zeichen mit URL-Reservierung: Zeichen wie & müssen wie gewohnt URL-codiert werden.
• Reservierte Zeichen: Semikolon und Komma müssen mit einem umgekehrten Schrägstrich maskiert werden, wenn sie in einem Ausdruck vorkommen:
  • Semikolon \;
  • Komma \,
• Reguläre Ausdrücke: Sie können auch reguläre Ausdrücke in Filterausdrücken mit den Operatoren =~ und !~ verwenden. Ihre Syntax ähnelt der regulären Perl-Ausdrücken und es gelten folgende zusätzliche Regeln:
  • Maximale Länge: 128 Zeichen: Reguläre Ausdrücke, die länger als 128 Zeichen sind, führen zum Statuscode 400 Bad Request, der vom Server zurückgegeben wird.
  • Groß-/Kleinschreibung beachten: Beim Abgleich regulärer Ausdrücke wird die Groß- und Kleinschreibung nicht berücksichtigt.

Filter kombinieren

Filter können mit den booleschen Operatoren OR und AND kombiniert werden. So können Sie die Beschränkung von 128 Zeichen für einen Filterausdruck effektiv erhöhen.

ODER

Der Operator OR wird durch ein Komma (,) definiert. Er hat Vorrang vor dem Operator AND und darf NICHT verwendet werden, um Dimensionen und Messwerte im selben Ausdruck zu kombinieren.

UND

Der Operator AND wird durch ein Semikolon (;) definiert. Vor ihm steht der Operator OR und CAN kann verwendet werden, um Dimensionen und Messwerte im selben Ausdruck zu kombinieren.

Ausführliche Informationen dazu, wie Sie ein Segment in der Core Reporting API anfordern, finden Sie im Entwicklerleitfaden für Segmente.

Eine konzeptionelle Übersicht über Segmente finden Sie in der Hilfe unter Segmentfunktion für Segmente und Segmente.

Dimensionen und Messwerte in Segmenten zulässig.
Nicht alle Dimensionen und Messwerte können in Segmenten verwendet werden. Im Explorer für Dimensionen und Messwerte sehen Sie, welche Dimensionen und Messwerte in Segmenten zulässig sind.

• DEFAULT: gibt die Antwort mit einer Beispielgröße zurück, die Geschwindigkeit und Genauigkeit ausgleicht.
• FASTER: Gibt eine schnelle Antwort mit einer kleineren Stichprobengröße zurück.
• HIGHER_PRECISION: Gibt mit einer großen Stichprobe eine genauere Antwort zurück, was jedoch dazu führen kann, dass die Antwort langsamer ist.

• json: Gibt das Standardattribut rows in der Antwort aus, das ein JSON-Objekt enthält.
• dataTable: Gibt das Attribut dataTable in der Antwort aus, das ein Datentabellenobjekt enthält. Dieses Data Table -Objekt kann direkt mit Google Charts-Visualisierungen verwendet werden.

Gibt an, welche Felder in einer Teilantwort zurückgegeben werden sollen. Wenn Sie in der API-Antwort nur einen Teil der Felder verwenden, können Sie mit dem Parameter fields angeben, welche Felder berücksichtigt werden sollen.

Das Format des Parameterwerts für die Feldanfrage basiert lose auf der XPath-Syntax. Die unterstützte Syntax ist unten zusammengefasst.

• Zur Auswahl mehrerer Felder verwenden Sie eine durch Kommas getrennte Liste.
• Verwenden Sie a/b, um ein Feld b auszuwählen, das in Feld a verschachtelt ist. Verwenden Sie a/b/c, um ein Feld c auszuwählen, das in b verschachtelt ist.
• Verwenden Sie eine Unterauswahl, um einen Satz bestimmter Unterfelder von Arrays oder Objekten anzufordern. Setzen Sie Ausdrücke in Klammern "( )", um sie auszuwählen.
  Beispiel: fields=columnHeaders(name,dataType) gibt nur die Felder name und dataType im Array columnHeaders zurück. Sie können auch ein einzelnes Unterfeld angeben, wobei fields=columnHeader(name) gleich fields=columnHeader/name ist.

Gibt die Antwort in einem für Menschen lesbaren Format zurück, wenn true. Standardwert: false.

Damit können Sie pro Nutzer die Kontingente einer serverseitigen Anwendung erzwingen, auch wenn die IP-Adresse des Nutzers unbekannt ist. Dies ist beispielsweise bei Anwendungen der Fall, die Cronjobs in App Engine im Namen eines Nutzers ausführen. Sie können einen beliebigen String auswählen, der einen Nutzer eindeutig identifiziert. Dieser ist jedoch auf 40 Zeichen beschränkt.

Dadurch wird userIp überschrieben, wenn beide angegeben werden.