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.

Einleitung

Nachdem Sie einen einfachen Bericht erstellt haben, können Sie mit diesen Funktionen erweiterte Berichte erstellen:

• Pivot-Tabellen
• Kohorten
• Lifetime-Wert

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 Pivot-Objekt hat eigene Dimensionen und Messwerte sowie optional 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 pivotiert 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"
            }
          ]
        }
      ]
    }
  ]
}

Überschrift der Antwortspalte

Im zurückgegebenen Objekt report für eine Pivot-Anfrage enthält das metricHeader-Objekt 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 mit 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 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:

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).

Um eine Kohortenanfrage zu definieren, 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 obige Beispiel im API Explorer an.

Kohorteneinschränkungen

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

• Die Dimension „ga:cohort“ ist nur 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 betragen.
• Kohortenanfragen mit dem heutigen Datum sind nicht zulässig.
• Anfragen für Kohorten und andere Kohorten dürfen 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 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 wachsen. 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 obige Beispiel im API Explorer an.

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

Abmessungen

Messwerte

Messwerte zum Lifetime-Wert (LTV)