Berichte zum Datenzugriff

Sie können Berichte zum Datenzugriff mit der Admin API v1-Methode runAccessReport erstellen. In diesem Bericht sehen Sie, wann ein Nutzer Google Analytics-Daten abgerufen hat. Datenzugriffsdaten werden bis zu zwei Jahre aufbewahrt. Berichte zum Datenzugriff sind nur für Nutzer mit der Rolle Administrator verfügbar.

Bericht zum Datenzugriff mit der Clientbibliothek anfordern

Die schnellste Möglichkeit, mit Berichten zum Datenzugriff zu beginnen, ist die Verwendung der Clientbibliotheken.

In der Kurzanleitung erfahren Sie, wie Sie die Google Analytics-Clientbibliotheken installieren und konfigurieren.

Hier ist ein Beispiel mit der Python-Clientbibliothek, in dem eine Abfrage für den Datenzugriff ausgeführt und die Antwort ausgegeben wird.

from datetime import datetime

from google.analytics.admin import AnalyticsAdminServiceClient
from google.analytics.admin_v1alpha.types import (
    AccessDateRange,
    AccessDimension,
    AccessMetric,
    RunAccessReportRequest,
)


def run_sample():
    """Runs the sample."""
    # TODO(developer): Replace this variable with your Google Analytics 4
    #  property ID (e.g. "123456") before running the sample.
    property_id = "YOUR-GA4-PROPERTY-ID"
    run_access_report(property_id)


def run_access_report(property_id: str, transport: str = None):
    """
    Runs an access report for a Google Analytics property. The report will
    aggregate over dimensions `userEmail`, `accessedPropertyId`,
    `reportType`, `revenueDataReturned`, `costDataReturned`,
    `userIP`, and return the access count, as well as the most recent access
    time for each combination.
    See https://developers.google.com/analytics/devguides/config/admin/v1/access-api-schema
    for the description of each field used in a data access report query.
    Args:
        property_id(str): The Google Analytics Property ID.
        transport(str): The transport to use. For example, "grpc"
            or "rest". If set to None, a transport is chosen automatically.
    """
    client = AnalyticsAdminServiceClient(transport=transport)
    request = RunAccessReportRequest(
        entity=f"properties/{property_id}",
        dimensions=[
            AccessDimension(dimension_name="userEmail"),
            AccessDimension(dimension_name="accessedPropertyId"),
            AccessDimension(dimension_name="reportType"),
            AccessDimension(dimension_name="revenueDataReturned"),
            AccessDimension(dimension_name="costDataReturned"),
            AccessDimension(dimension_name="userIP"),
            AccessDimension(dimension_name="mostRecentAccessEpochTimeMicros"),
        ],
        metrics=[AccessMetric(metric_name="accessCount")],
        date_ranges=[AccessDateRange(start_date="yesterday", end_date="today")],
    )

    access_report = client.run_access_report(request)

    print("Result:")
    print_access_report(access_report)


def print_access_report(response):
    """Prints the access report."""
    print(f"{response.row_count} rows received")
    for dimensionHeader in response.dimension_headers:
        print(f"Dimension header name: {dimensionHeader.dimension_name}")
    for metricHeader in response.metric_headers:
        print(f"Metric header name: {metricHeader.metric_name})")

    for rowIdx, row in enumerate(response.rows):
        print(f"\nRow {rowIdx}")
        for i, dimension_value in enumerate(row.dimension_values):
            dimension_name = response.dimension_headers[i].dimension_name
            if dimension_name.endswith("Micros"):
                # Convert microseconds since Unix Epoch to datetime object.
                dimension_value_formatted = datetime.utcfromtimestamp(
                    int(dimension_value.value) / 1000000
                )
            else:
                dimension_value_formatted = dimension_value.value
            print(f"{dimension_name}: {dimension_value_formatted}")

        for i, metric_value in enumerate(row.metric_values):
            metric_name = response.metric_headers[i].metric_name
            print(f"{metric_name}: {metric_value.value}")

properties_run_access_report.py

Gemeinsame Funktionen mit Basisberichten

Anfragen für Berichte zum Datenzugriff haben für viele gängige Funktionen dieselbe Semantik wie Anfragen für Kernberichte. So funktionieren beispielsweise Paginierung, Dimensionsfilter und Zeiträume bei beiden Berichtstypen gleich.

Sehen Sie sich die Übersicht der Hauptberichte in der Data API v1 an und kehren Sie dann zu dieser Seite zurück, um mehr über Berichte zum Datenzugriff zu erfahren.

Bericht zum Datenzugriff erstellen

Verwenden Sie die Methode runAccessReport, um einen Bericht zum Datenzugriff anzufordern.

Berichtseinheit auswählen

Ähnlich wie bei den grundlegenden Berichtsfunktionen der Data API v1 muss bei der Methode runAccessReport der Google Analytics Admin API v1 die Google Analytics-Property-ID in einem URL-Anfragepfad in Form von properties/GA_PROPERTY_ID angegeben werden, z. B.:

  POST  https://analyticsadmin.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runAccessReport

Der Bericht zum Datenzugriff wird anhand der Google Analytics-Datenzugriffseinträge für die angegebene Google Analytics-Property erstellt.

Wenn Sie eine der Admin API-Clientbibliotheken verwenden, müssen Sie den URL-Pfad der Anfrage nicht manuell bearbeiten. Die meisten API-Clients bieten einen property-Parameter an, für den ein String in Form von properties/GA_PROPERTY_ID erwartet wird. Im Code-Snippet am Anfang dieser Seite finden Sie ein Beispiel für die Verwendung der Clientbibliotheken.

Dimensionen und Messwerte auswählen

Mit Dimensionen werden Zugriffsdaten für Ihre Property beschrieben und gruppiert. Die Dimension userEmail gibt beispielsweise die E-Mail-Adresse des Nutzers an, der auf Berichtsdaten zugegriffen hat. Dimensionswerte in Berichtsantworten sind Strings.

Messwerte sind die quantitativen Messungen eines Berichts. Der Messwert accessCount gibt die Gesamtzahl der Datenzugriffseinträge zurück.

Im Schema für den Datenzugriff finden Sie eine vollständige Liste der Dimensionen und Messwerte, die in Berichtsanfragen für den Datenzugriff verwendet werden können.

Bericht anfordern

Wenn Sie Berichte zum Datenzugriff anfordern möchten, erstellen Sie ein RunAccessReportRequest-Objekt. Wir empfehlen, mit diesen Anfrageparametern zu beginnen:

• Mindestens ein gültiger Eintrag im Feld date ranges.
• Mindestens ein gültiger Eintrag im Feld Dimensionen
• Wenn Sie die Dimension epochTimeMicros nicht verwenden, muss im Feld Messwerte mindestens ein gültiger Eintrag vorhanden sein, damit quantitative Daten für jede Kombination von Dimensionswerten in einem Bericht erfasst werden.

Hier ist eine Beispielanfrage mit den empfohlenen Feldern. Mit dieser Abfrage wird eine Liste mit E-Mail-Adressen von Nutzern, dem letzten Zugriff auf die angegebene Property in den letzten sieben Tagen und der entsprechenden Zugriffszahl generiert.

POST https://analyticsadmin.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runAccessReport
{
  "dateRanges": [
    {
      "startDate": "7daysAgo",
      "endDate": "today"
    }
  ],
  "dimensions": [
    {
      "dimensionName": "mostRecentAccessEpochTimeMicros"
    },
    {
      "dimensionName": "userEmail"
    }
  ],
  "metrics": [
    {
      "metricName": "accessCount"
    }
  ]
}

Antwort lesen

Die Antwort des Berichts zum Datenzugriff besteht hauptsächlich aus einer Überschrift und Zeilen. Der Header besteht aus den Elementen AccessDimensionHeaders und AccessMetricHeaders, in denen die Spalten im Bericht aufgeführt sind.

Jede Zeile des Zugriffsberichts besteht aus AccessDimensionValues und AccessMetricValues für die Spalten im Bericht. Die Spaltenreihenfolge ist in der Anfrage, in der Überschrift und in jeder Zeile konsistent.

Hier ist eine Beispielantwort auf die vorherige Beispielanfrage:

{
  "dimensionHeaders": [
    {
      "dimensionName": "mostRecentAccessEpochTimeMicros"
    },
    {
      "dimensionName": "userEmail"
    }
  ],
  "metricHeaders": [
    {
      "metricName": "accessCount"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "1667591408427733"
        },
        {
          "value": "Bola@example.net"
        }
      ],
      "metricValues": [
        {
          "value": "1238"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1667710959827161"
        },
        {
          "value": "Alex@example.net"
        }
      ],
      "metricValues": [
        {
          "value": "475"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1667868650762743"
        },
        {
          "value": "Mahan@example.net"
        }
      ],
      "metricValues": [
        {
          "value": "96"
        }
      ]
    }
  ],
  "rowCount": 3
}

Nach Zugriffsdatensätzen filtern

Verwenden Sie das Feld dimensionFilter des Objekts RunAccessReportRequest, um die Berichtsantwort auf bestimmte Dimensionswerte einzuschränken, die mit dem Filter übereinstimmen.

Im folgenden Beispiel wird ein Bericht basierend auf einzelnen Datenzugriffssätzen generiert. Dabei wird nach Zugriffssätzen eines einzelnen Nutzers mit der E-Mail-Adresse Alex@example.net gefiltert. Der Bericht enthält die Uhrzeit jedes Zugriffs, die E-Mail-Adresse und die IP-Adresse des Nutzers.

POST https://analyticsadmin.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runAccessReport
{
  "dateRanges": [
    {
      "startDate": "7daysAgo",
      "endDate": "today"
    }
  ],
  "dimensions": [
    {
      "dimensionName": "epochTimeMicros"
    },
    {
      "dimensionName": "userEmail"
    },
    {
      "dimensionName": "userIP"
    }
  ],
  "dimensionFilter": {
    "accessFilter": {
      "fieldName": "userEmail",
      "stringFilter": {
        "matchType": "EXACT",
        "value": "Alex@example.net"
      }
    }
  }
}

Ebenso kann das Feld metricFilter des Objekts RunAccessReportRequest verwendet werden, um die Berichtsantwort auf bestimmte Messwertwerte zu beschränken, die mit dem Filter übereinstimmen.

Im folgenden Beispiel wird ein Bericht mit E-Mail-Adressen und Zugriffszahlen aller Nutzer generiert, die mehr als 100-mal auf die angegebene Property zugegriffen haben.

{
  "dateRanges": [
    {
      "startDate": "7daysAgo",
      "endDate": "today"
    }
  ],
  "dimensions": [
    {
      "dimensionName": "userEmail"
    }
  ],
  "metricFilter": {
    "accessFilter": {
      "numericFilter": {
        "operation": "GREATER_THAN",
        "value": {
          "int64Value": 100
        }
      },
      "fieldName": "accessCount"
    }
  },
  "metrics": [
    {
      "metricName": "accessCount"
    }
  ]
}

Beispielberichte

Hier sind einige Beispielberichte, die Sie ausprobieren können.

Letzter Zugriff

Im folgenden Beispiel wird ein Beispielzugriffsbericht gezeigt, der mit runAccessReport erstellt werden kann:

Dieser Bericht kann durch Abfragen der Dimensionen mostRecentAccessEpochTimeMicros, userEmail und des Messwerts accessCount generiert werden. Der Bericht enthält eine Zeile pro Nutzer: Die Dimension mostRecentAccessEpochTimeMicros aggregiert Datenzugriffsdatensätze für jeden Nutzer, der auf die Property zugreift, und gibt für jede Zeile die Zeit des letzten Zugriffs (in Unix-Mikrosekunden seit der Epoche) zurück.

Aufschlüsselung des Nutzerzugriffs

Ein weiteres Beispiel für einen nützlichen Bericht ist eine Aufschlüsselung der Nutzerzugriffe nach Zugriffsmechanismus (z. B. Google Analytics-Benutzeroberfläche, API usw.).

Dieser Bericht kann durch Abfragen der Dimensionen mostRecentAccessEpochTimeMicros, userEmail, accessMechanism und des accessCount-Messwerts generiert werden.

Der Bericht enthält eine Zeile pro Kombination aus Nutzer und Zugriffsmechanismus. Die Dimension mostRecentAccessEpochTimeMicros enthält das Datum, an dem ein Nutzer zuletzt über den angegebenen Zugriffsmechanismus auf die Property zugegriffen hat.

Property-Zugriff – Übersicht

Es ist möglich, einen Bericht für eine Property zu erstellen, ohne die Daten nach einzelnen Nutzern aufzuschlüsseln. Im folgenden Bericht sehen Sie beispielsweise, wie oft über verschiedene Zugriffsmechanismen auf eine Property zugegriffen wird:

Dieser Bericht kann durch Abfragen der Dimensionen accessedPropertyId, accessedPropertyName, accessMechanism und des accessCount-Messwerts generiert werden.

Der Bericht enthält eine Zeile pro Kombination aus Property-ID und Zugriffsmechanismus.

Individueller Datenzugriff

Wenn Sie einen Bericht erstellen möchten, bei dem jede Zeile auf einem einzelnen Datenzugriffsdatensatz basiert, lassen Sie die Dimension mostRecentAccessEpochTimeMicros aus einer Abfrage aus und verwenden Sie stattdessen die Dimension epochTimeMicros. Es ist nicht erforderlich, den Messwert accessCount abzufragen, da jede Zeile des Berichts Informationen zu einem einzelnen Datenzugriff enthält.

Der folgende Bericht enthält detaillierte Informationen zu jedem Mal, wenn ein Nutzer auf die angegebene Property zugegriffen hat.

Dieser Bericht kann durch Abfragen der Dimensionen epochTimeMicros, userEmail, accessedPropertyId, accessedPropertyName, userIP, accessMechanism, costDataReturned und revenueDataReturned generiert werden.