Gibt einen benutzerdefinierten Pivot-Bericht Ihrer Google Analytics-Ereignisdaten zurück. Pivot-Berichte sind komplexere und aussagekräftigere Formate als normale Berichte. In einem Pivot-Bericht sind Dimensionen nur sichtbar, wenn sie in einem Pivot enthalten sind. Zur weiteren Analyse der Daten können mehrere Pivots angegeben werden.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport
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 In einer Batchanfrage sollte dieses Attribut entweder nicht angegeben sein oder mit dem Attribut auf Batchebene übereinstimmen. Beispiel: properties/1234 |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "dimensions": [ { object ( |
Felder | |
---|---|
dimensions[] |
Die angeforderten Abmessungen. Alle definierten Dimensionen müssen mit einem der folgenden Werte verwendet werden: „dimensionExpression“, „dimensionFilter“, „Pivots“ oder „orderBys“. |
metrics[] |
Die angeforderten Messwerte. Es muss mindestens ein Messwert angegeben werden. Alle definierten Messwerte müssen von einem der folgenden Messwerte verwendet werden: metric_expression, metricFilter, orderBys. |
dateRanges[] |
Der Zeitraum, in dem Ereignisdaten für den Bericht abgerufen werden. Wenn mehrere Zeiträume angegeben sind, werden im Bericht Ereignisdaten aus den einzelnen Zeiträumen verwendet. Eine spezielle Dimension mit dem Feldnamen „dateRange“ kann in die Feldnamen eines Pivots aufgenommen werden. Sofern vorhanden, werden die Zeiträume im Bericht verglichen. In einer Kohortenanfrage darf |
pivots[] |
Beschreibt das visuelle Format der Berichtsdimensionen in Spalten oder Zeilen. Die Zusammenführung der „fieldNames“ (Dimensionsnamen) in allen Pivots muss eine Teilmenge der in „Dimensionen“ definierten Dimensionsnamen sein. Zwei Pivots können keine gemeinsame Dimension haben. Eine Dimension ist nur sichtbar, wenn sie in einem Pivot enthalten ist. |
dimensionFilter |
Die Filterklausel für Dimensionen. Dimensionen müssen angefordert werden, damit sie in diesem Filter verwendet werden können. Messwerte können in diesem Filter nicht verwendet werden. |
metricFilter |
Die Filterklausel für Messwerte. Wird in der Post-Aggregationsphase angewendet, ähnlich wie bei SQL mit Klausel. Messwerte müssen zur Verwendung in diesem Filter angefordert werden. In diesem Filter können keine Dimensionen verwendet werden. |
currencyCode |
Ein Währungscode im ISO4217-Format, z. B. „AED“, „USD“ oder „JPY“. Wenn das Feld leer ist, wird im Bericht die Standardwährung der Property verwendet. |
cohortSpec |
Die mit dieser Anfrage verknüpfte Kohortengruppe. Wenn die Anfrage eine Kohortengruppe enthält, muss die Dimension „Kohorte“ vorhanden sein. |
keepEmptyRows |
Wenn „false“ oder nicht angegeben, wird nicht jede Zeile zurückgegeben, bei der alle Messwerte gleich 0 sind. Bei „true“ werden diese Zeilen zurückgegeben, wenn sie nicht separat durch einen Filter entfernt werden. Unabhängig von dieser Wenn für eine Property beispielsweise nie ein |
returnPropertyQuota |
Gibt an, ob der aktuelle Status des Kontingents dieser Analytics-Property zurückgegeben werden soll. Das Kontingent wird in PropertyQuota zurückgegeben. |
comparisons[] |
Optional. Die Konfiguration der angeforderten und angezeigten Vergleiche. Für die Anfrage sind sowohl ein Vergleichsfeld als auch eine Vergleichsdimension erforderlich, damit in der Antwort eine Vergleichsspalte zu sehen ist. |
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von RunPivotReportResponse
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics