Diese Seite wurde von der Cloud Translation API übersetzt.

Erweiterte Anwendungsfälle

In diesem Dokument werden die erweiterten Funktionen der Google Analytics Reporting API Version 4 beschrieben. Eine ausführliche Referenz zur API finden Sie im Referenzhandbuch.

Einführung

Verwenden Sie nach dem Erstellen eines einfachen Berichts diese Funktionen, um erweiterte Berichte zu erstellen:

Pivot-Tabellen
Kohorten
Lifetime-Wert

Drehpunkte

Mit der Google Analytics Reporting API Version 4 können Sie Pivot-Tabellen erstellen. Um eine Anfrage mit einer Pivot-Tabelle zu erstellen, definieren Sie das Feld Pivot in ReportRequest. Das Objekt Pivot hat eigene Dimensionen und Messwerte sowie die optionalen Werte startGroup und maxGroupCount, um die Anzahl der Dimensionen anzugeben, die in der Pivot-Tabelle enthalten sein sollen.

Anfragen

Der folgende API-Aufruf fordert Sitzungen nach Land an und ändert die Ergebnisse im Browser:

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dateRanges":
      [
        {
          "startDate": "2014-11-01",
          "endDate": "2014-11-30"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:sessions"
        }
      ],
      "dimensions":
      [
        {
          "name": "ga:country"
        }
      ],
      "pivots":
      [
        {
          "dimensions":
          [
            {
              "name": "ga:browser"
            }
          ],
          "maxGroupCount": 3,
          "startGroup": 3,
          "metrics":
          [
            {
              "expression": "ga:sessions"
            }
          ]
        }
      ]
    }
  ]
}

Spaltenüberschrift für Antwort

Das zurückgegebene report-Objekt für eine Pivot-Anfrage enthält die Liste metricHeader mit einer Liste von pivotHeaders-Objekten, deren pivotHeaderEntries-Felder die Reihenfolge der Pivot-Dimensionswerte und die entsprechenden Messwerte definieren. Beispiel:

"columnHeader": {
    "dimensions": [
        "ga:country"
    ],
    "metricHeader": {
        "metricHeaderEntries": [
            {
                "name": "ga:sessions",
                "type": "INTEGER"
            }
        ],
        "pivotHeaders": [
            {
                "pivotHeaderEntries": [
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Internet Explorer"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    },
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Firefox"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    },
                    {
                        "dimensionNames": [
                            "ga:browser"
                        ],
                        "dimensionValues": [
                            "Android Browser"
                        ],
                        "metric": {
                            "name": "ga:sessions",
                            "type": "INTEGER"
                        }
                    }
                ],
                "totalPivotGroupsCount": 7
            }
        ]
    }
},

Antwortzeilen

Jede Zeile des reportData-Objekts definiert ein Array von dateRangeValue-Objekten, von denen jedes eine Reihe von pivotValue-Objekten enthält. Die Reihenfolge der Werte entspricht der Reihenfolge der Messwerte, die in den Pivot-Headern im Header der Antwortspalte aufgeführt sind.

"rows": [
    ...
    {
        "dimensions": [
            "United States"
        ],
        "metrics": [
            {
                "pivotValues": [
                    {
                        "values": [
                            "21",
                            "18",
                            "1"
                        ]
                    }
                ],
                "values": [
                    "192"
                ]
            }
        ]
    }
],

Im Bericht gibt es nur drei Pivot-Werte, da in der ursprünglichen Anfrage maxGroupCount den Wert 3 hat. Aufgrund von "totalPivotGroupsCount": 7 kann es bis zu sieben Werte geben.

Beispiel für eine Pivot-Tabellenzeile

In der Beispielantwort oben ist die mit dem Land USA verknüpfte Zeile in der folgenden Pivot-Tabelle dargestellt:

Land	Sitzungen insgesamt	Internet Explorer -Sitzungen	FireFox -Sitzungen	-Sitzungen im Android-Browser
Indien	12	3	2	4
Vereinigte Staaten	192	21	18	1
Vereinigtes Königreich	35	12	2	0

Kohorten

Eine Kohorte ist eine Gruppe von Nutzern mit gemeinsamen Eigenschaften. Beispielsweise gehören alle Nutzer mit demselben Akquisitionsdatum zur selben Kohorte. Mithilfe des Berichts "Kohortenanalyse" können Sie das Kohortenverhalten isolieren und analysieren. Eine Liste Kohortenspezifischer Dimensionen und Messwerte finden Sie unter Kohorten- und Lifetime-Werte (LTV).

Zum Definieren einer Kohortenanfrage müssen Sie ein Kohortenobjekt mit name, type und dateRange definieren:

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dimensions":
      [
        {
          "name": "ga:cohort"
        },
        {
          "name": "ga:cohortNthDay"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:cohortActiveUsers"
        },
        {
          "expression": "ga:cohortTotalUsers"
        }
      ],
      "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"
            }
          }
        ]
      }
    }
  ]
}

Ein entsprechendes Beispiel finden Sie oben im API Explorer.

Einschränkungen für Kohorten

Eine gültige Kohortenanfrage muss die folgenden Einschränkungen erfüllen:

Die Dimension ga:cohort wird nur dann einbezogen, wenn die Anfrage eine oder mehrere Kohortendefinitionen enthält.
Der Kohortenname muss eindeutig sein.
Die maximale Anzahl von Kohorten in einer Anfrage beträgt 12.
Wenn ga:cohortNthWeek definiert ist, muss das Startdatum Sonntag und das Enddatum Samstag sein. Wenn ga:cohortNthMonth definiert ist, muss das Startdatum der erste Tag des Monats und das Enddatum der letzte Tag des Monats sein. Wenn ga:cohortNthDay definiert ist, muss der Zeitraum genau einen Tag umfassen.
Kohortenanfragen mit dem heutigen Datum sind nicht zulässig.
Kohortenanfragen und andere Anfragen sollten sich nicht in derselben batchGet-Anfrage befinden.
Der Zeitraum in Kohorten muss nach dem 1. Februar 2015 liegen.

Lifetime-Wert (LTV)

Der Bericht zum Lifetime-Wert zeigt, wie der Nutzerwert (Umsatz) und die Interaktion (App-Aufrufe, Abschlüsse für Zielvorhaben, Sitzungen und Sitzungsdauer) während der 90 Tage nach der Akquisition eines Nutzers steigen. LTV-spezifische Dimensionen und Messwerte ansehen

Eine LTV-Anfrage ist als Kohorte definiert, wobei das Feld lifetimeValue auf true gesetzt ist. Beispiel:

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
  "reportRequests":
  [
    {
      "viewId": "XXXX",
      "dimensions":
      [
        {
          "name": "ga:cohort"
        },
        {
          "name": "ga:cohortNthWeek"
        }
      ],
      "metrics":
      [
        {
          "expression": "ga:cohortTotalUsersWithLifetimeCriteria"
        },
        {
          "expression": "ga:cohortRevenuePerUser"
        }
      ],
      "cohortGroup":
      {
        "cohorts":
        [
          {
            "name": "cohort 1",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-08-01",
              "endDate": "2015-09-01"
            }
          },
          {
            "name": "cohort 2",
            "type": "FIRST_VISIT_DATE",
            "dateRange":
            {
              "startDate": "2015-07-01",
              "endDate": "2015-08-01"
            }
          }
        ],
        "lifetimeValue": true
      }
    }
  ]
}

Ein Beispiel finden Sie oben im API Explorer.

Dimensionen und Messwerte (Kohorte und Lifetime-Wert)

Dimensionen

Dimensionsname	Definition
`ga:cohort`	Name der Kohorte, zu der ein Nutzer gehört. Je nachdem, wie Kohorten definiert sind, kann ein Nutzer mehreren Kohorten angehören, ähnlich wie ein Nutzer mehreren Segmenten angehören kann.
`ga:cohortNthDay`	0-basierter Tag-Offset relativ zum Kohortendefinitionsdatum. Wenn beispielsweise eine Kohorte mit dem Datum des ersten Besuchs als `2015-09-01` definiert ist, dann lautet der `ga:cohortNthDay` für das Datum `2015-09-04`.
`ga:cohortNthMonth`	0-basierter Monatsversatz im Verhältnis zum Kohortendefinitionsdatum.
`ga:cohortNthWeek`	0-basierte Wochenverschiebung im Verhältnis zum Kohortendefinitionsdatum.
`ga:acquisitionTrafficChannel`	Traffic-Kanal, über den der Nutzer akquiriert wurde. Sie wird aus der ersten Sitzung des Nutzers extrahiert. Der Traffic-Channel wird anhand der Standard-Channelgruppierungsregeln (auf Datenansichtsebene, sofern verfügbar) zum Zeitpunkt der Nutzergewinnung berechnet.
`ga:acquisitionSource`	Die Quelle, über die der Nutzer akquiriert wurde. Abgeleitet aus der ersten Sitzung des Nutzers.
`ga:acquisitionMedium`	Das Medium, über das der Nutzer akquiriert wurde. Abgeleitet aus der ersten Sitzung des Nutzers.
`ga:acquisitionSourceMedium`	Der Gesamtwert von `ga:userAcquisitionSource` und `ga:acquisitionMedium`.
`ga:acquisitionCampaign`	Die Kampagne, über die der Nutzer akquiriert wurde. Abgeleitet aus der ersten Sitzung des Nutzers.

Messwerte

Name des Messwerts	Definition
`ga:cohortActiveUsers`	Dieser Messwert ist im Kontext der 0-basierten Offset-Dimensionen (`ga:cohortNthDay`, `ga:cohortNthWeek` oder `ga:cohortNthMonth`) relevant. Er gibt die Anzahl der Nutzer in der Kohorte an, die im Zeitfenster der Kohorte des n. Tages/Woches/Monats aktiv sind. Beispiel: Für `ga:cohortNthWeek = 1` die Anzahl der Nutzer (in der Kohorte), die in der zweiten Woche aktiv waren. Wenn eine Anfrage weder `ga:cohortNthDay` noch `ga:cohortNthWeek` oder `ga:cohortNthMonth` enthält, hat dieser Messwert denselben Wert wie `ga:cohortTotalUsers`.
`ga:cohortTotalUsers`	Anzahl der Nutzer, die zur Kohorte gehören, auch als Kohortengröße bezeichnet.
`ga:cohortAppviewsPerUser`	App-Aufrufe pro Nutzer für eine Kohorte.
`ga:cohortGoalCompletionsPerUser`	Abschlüsse für Zielvorhaben pro Nutzer in einer Kohorte
`ga:cohortPageviewsPerUser`	Seitenaufrufe pro Nutzer für eine Kohorte.
`ga:cohortRetentionRate`	Bindungsrate bei Kohorten
`ga:cohortRevenuePerUser`	Der Umsatz pro Nutzer für eine Kohorte.
`ga:cohortVisitDurationPerUser`	Sitzungsdauer pro Nutzer für eine Kohorte.
`ga:cohortSessionsPerUser`	Sitzungen pro Nutzer für eine Kohorte.

Messwerte zum Lifetime-Wert (LTV)

Name des Messwerts	Definition
`ga:cohortTotalUsersWithLifetimeCriteria`	Dies ist im Zusammenhang mit einer Anfrage relevant, die die Dimensionen `ga:acquisitionTrafficChannel`, `ga:acquisitionSource`, `ga:acquisitionMedium` oder `ga:acquisitionCampaign` hat. Er steht für die Anzahl der Nutzer in den Kohorten, die über den aktuellen Channel, die Quelle, das Medium oder die Kampagne akquiriert wurden. Für `ga:acquisitionTrafficChannel=Direct` steht er beispielsweise für die Anzahl der Nutzer in der Kohorte, die direkt akquiriert wurden. Wenn keine der genannten Dimensionen vorhanden ist, ist der Wert `ga:cohortTotalUsers` (nur App-Aufrufe).
`ga:cohortAppviewsPerUserWithLifetimeCriteria`	App-Aufrufe pro Nutzer für die Akquisitionsdimension für eine Kohorte (nur App-Aufrufe).
`ga:cohortGoalCompletionsPerUserWithLifetimeCriteria`	Abschlüsse für Zielvorhaben pro Nutzer für die Akquisitionsdimension für eine Kohorte (nur App-Aufrufe)
`ga:cohortPageviewsPerUserWithLifetimeCriteria`	Seitenaufrufe pro Nutzer für die Akquisitionsdimension für eine Kohorte (nur App-Aufrufe).
`ga:cohortRevenuePerUserWithLifetimeCriteria`	Umsatz pro Nutzer für die Akquisitionsdimension für eine Kohorte (nur App-Aufrufe).
`ga:cohortSessionsPerUserWithLifetimeCriteria`	Sitzungsdauer pro Nutzer für die Akquisitionsdimension für eine Kohorte (nur App-Aufrufe).