Erweiterte Anwendungsfälle

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

Einführung

Nachdem Sie einen einfachen Bericht erstellt haben, können Sie mit den folgenden Funktionen erweiterte Berichte generieren:

Pivots

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

Anfragen

Mit dem folgenden API-Aufruf werden Sitzungen nach Land angefordert und die Ergebnisse im Browser neu ermittelt:

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"
            }
          ]
        }
      ]
    }
  ]
}

Überschrift der Antwortspalte

Im für eine Pivot-Anfrage zurückgegebenen Berichtsobjekt enthält metricHeader eine Liste von pivotHeaders-Objekten, deren pivotHeaderEntries-Felder die Reihenfolge der Pivot-Dimensionswerte und der 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 Objekts reportData 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 in der Kopfzeile der Antwortspalte aufgeführt sind.

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

Der Bericht enthält nur drei Pivot-Werte, da maxGroupCount in der ursprünglichen Anfrage den Wert 3 hat. Aufgrund von "totalPivotGroupsCount": 7 können bis zu sieben Werte vorhanden sein.

Beispiel für eine Zeile in einer Pivot-Tabelle

In der obigen Beispielantwort wird die Zeile für das Land United States in der folgenden Pivot-Tabelle dargestellt:

Land
Sitzungen insgesamt
Internet Explorer-
-Sitzungen
FireFox-
-Sitzungen

-Sitzungen im Android-Browser
Indien 12 3 2 4
USA 192 21 18 1
Vereinigtes Königreich 35 12 2 0

Kohorten

Eine Kohorte ist eine Gruppe von Nutzenden mit einem gemeinsamen Merkmal. 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 der Kohortenspezifischen Dimensionen und Messwerte finden Sie unter Dimensionen und Messwerte für Kohorten- und Lifetime-Wert (LTV).

Zum Definieren einer Kohortenanfrage musst du 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"
            }
          }
        ]
      }
    }
  ]
}

Sehen Sie sich das Beispiel oben im API Explorer an.

Kohorteneinschränkungen

Für eine gültige Kohortenanfrage gelten die folgenden Einschränkungen:

  • Die Dimension „ga:cohort“ ist nur dann enthalten, wenn die Anfrage eine oder mehrere Kohortendefinitionen enthält.
  • Der Kohortenname muss eindeutig sein.
  • In einer Anfrage sind maximal 12 Kohorten zulässig.
  • 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 Anfragen ohne Kohorte sollten nicht in derselben batchGet-Anfrage enthalten sein.
  • Der Zeitraum in Kohorten muss nach dem 1. Februar 2015 liegen.

Lifetime-Wert (LTV)

Im Bericht „Lifetime-Wert“ sehen Sie, wie sich der Nutzerwert (Umsatz) und die Interaktion (App-Aufrufe, Abschlüsse für Zielvorhaben, Sitzungen und Sitzungsdauer) in den 90 Tagen nach der Akquisition eines Nutzers erhöhen. LTV-spezifische Dimensionen und Messwerte aufrufen

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
      }
    }
  ]
}

Sehen Sie sich das Beispiel oben im API Explorer an.

Dimensionen und Messwerte für Kohorten und Lifetime-Wert (LTV)

Abmessungen

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-basierte Abweichung pro Tag bezogen auf das Datum der Kohortendefinition. Beispiel: Wenn eine Kohorte mit dem Datum des ersten Besuchs als 2015-09-01 definiert ist, dann ist ga:cohortNthDay für das Datum 2015-09-04 3.
ga:cohortNthMonth 0-basierte Monatsverschiebung bezogen auf das Datum der Kohortendefinition.
ga:cohortNthWeek 0-basierte Wochenverschiebung bezogen auf das Datum der Kohortendefinition.
ga:acquisitionTrafficChannel Traffic-Channel, über den der Nutzer akquiriert wurde. Sie wird aus der ersten Sitzung des Nutzers extrahiert. Der Traffic-Channel wird basierend auf den Standard-Channelgruppierungsregeln (auf Datenansichtsebene, sofern verfügbar) zum Zeitpunkt der Nutzergewinnung berechnet.
ga:acquisitionSource Die Quelle, über die der Nutzer akquiriert wurde. Aus der ersten Sitzung des Nutzers abgeleitet.
ga:acquisitionMedium Das Medium, über das der Nutzer akquiriert wurde. Aus der ersten Sitzung des Nutzers abgeleitet.
ga:acquisitionSourceMedium Der kombinierte Wert aus ga:userAcquisitionSource und ga:acquisitionMedium.
ga:acquisitionCampaign Die Kampagne, über die der Nutzer akquiriert wurde. Aus der ersten Sitzung des Nutzers abgeleitet.

Messwerte

Name des Messwerts Definition
ga:cohortActiveUsers Dieser Messwert ist im Zusammenhang mit den 0-basierten Offset-Dimensionen (ga:cohortNthDay, ga:cohortNthWeek oder ga:cohortNthMonth) relevant. Er gibt die Anzahl der Nutzer in der Kohorte an, die in dem Zeitraum aktiv sind, der dem n-ten Tag/Woche/Monat der Kohorte entspricht. Beispiel: Für ga:cohortNthWeek = 1 die Anzahl der Nutzer (in der Kohorte), die in der zweiten Woche aktiv sind. Wenn eine Anfrage weder ga:cohortNthDay, ga:cohortNthWeek noch ga:cohortNthMonth enthält, hat dieser Messwert denselben Wert wie ga:cohortTotalUsers.
ga:cohortTotalUsers Die Anzahl der Nutzer, die zur Kohorte gehören (auch Kohortengröße genannt).
ga:cohortAppviewsPerUser App-Aufrufe pro Nutzer für eine Kohorte.
ga:cohortGoalCompletionsPerUser Abschlüsse für Zielvorhaben pro Nutzer für eine Kohorte.
ga:cohortPageviewsPerUser Seitenaufrufe pro Nutzer für eine Kohorte.
ga:cohortRetentionRate Bindungsrate der Kohorte.
ga:cohortRevenuePerUser 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

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