Báo cáo Truy cập dữ liệu

Bạn có thể tạo báo cáo Quyền truy cập dữ liệu bằng phương thức Admin API v1 runAccessReport. Báo cáo này cho bạn biết mỗi khi người dùng đọc dữ liệu Google Analytics. Hệ thống sẽ lưu giữ bản ghi truy cập dữ liệu trong tối đa 2 năm. Chỉ những người dùng có vai trò Quản trị viên mới có thể xem báo cáo Truy cập dữ liệu.

Yêu cầu báo cáo Quyền truy cập dữ liệu bằng thư viện ứng dụng

Cách nhanh nhất để bắt đầu sử dụng báo cáo Quyền truy cập dữ liệu là sử dụng thư viện ứng dụng.

Hãy xem Hướng dẫn bắt đầu nhanh để biết nội dung giải thích về cách cài đặt và định cấu hình thư viện ứng dụng Google Analytics.

Dưới đây là ví dụ về cách sử dụng thư viện ứng dụng Python để chạy truy vấn truy cập dữ liệu và in phản hồi.

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

Các tính năng được chia sẻ với Báo cáo cốt lõi

Các yêu cầu báo cáo Truy cập dữ liệu có ngữ nghĩa giống với các yêu cầu báo cáo cốt lõi đối với nhiều tính năng phổ biến. Ví dụ: tính năng Phân trang, Bộ lọc phương diện và Phạm vi ngày hoạt động giống nhau trong cả hai loại báo cáo.

Làm quen với thông tin tổng quan về các báo cáo Core trong Data API v1, sau đó quay lại trang này để tìm hiểu thêm về các báo cáo Quyền truy cập dữ liệu.

Tạo báo cáo Truy cập dữ liệu

Sử dụng phương thức runAccessReport để yêu cầu báo cáo Quyền truy cập dữ liệu.

Chọn một pháp nhân báo cáo

Tương tự như chức năng báo cáo cốt lõi của Data API phiên bản 1, phương thức runAccessReport của Google Analytics Admin API phiên bản 1 yêu cầu bạn phải chỉ định giá trị nhận dạng tài sản Google Analytics bên trong đường dẫn yêu cầu URL ở dạng properties/GA_PROPERTY_ID, chẳng hạn như:

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

Báo cáo Truy cập dữ liệu thu được được tạo dựa trên các bản ghi truy cập dữ liệu của Google Analytics cho tài sản Google Analytics đã chỉ định.

Nếu bạn đang sử dụng một trong các thư viện ứng dụng Admin API, thì bạn không cần phải thao tác theo cách thủ công với đường dẫn URL yêu cầu. Hầu hết các ứng dụng API đều cung cấp tham số property yêu cầu một chuỗi ở dạng properties/GA_PROPERTY_ID. Hãy xem đoạn mã ở đầu trang này để biết ví dụ về cách sử dụng thư viện ứng dụng.

Chọn phương diện và chỉ số

Phương diện mô tả và nhóm dữ liệu truy cập cho tài sản của bạn. Ví dụ: phương diện userEmail cho biết email của người dùng đã truy cập vào dữ liệu báo cáo. Giá trị phương diện trong phản hồi báo cáo là chuỗi.

Chỉ số thể hiện các số liệu định lượng của một báo cáo. Chỉ số accessCount trả về tổng số bản ghi truy cập dữ liệu.

Hãy xem Giản đồ quyền truy cập dữ liệu để biết danh sách đầy đủ các tên phương diện và chỉ số có trong các yêu cầu báo cáo Quyền truy cập dữ liệu.

Yêu cầu báo cáo

Để yêu cầu báo cáo Truy cập dữ liệu, hãy tạo một đối tượng RunAccessReportRequest. Bạn nên bắt đầu với các tham số yêu cầu sau:

• Có ít nhất một mục hợp lệ trong trường phạm vi ngày.
• Có ít nhất một mục hợp lệ trong trường phương diện.
• Nếu không sử dụng phương diện epochTimeMicros, thì ít nhất một mục nhập hợp lệ trong trường chỉ số để nhận dữ liệu định lượng cho mỗi tổ hợp giá trị phương diện trong báo cáo.

Dưới đây là một yêu cầu mẫu có các trường được đề xuất. Truy vấn này sẽ tạo một danh sách email của người dùng, thời điểm gần đây nhất họ truy cập vào tài sản được chỉ định trong khoảng thời gian 7 ngày qua và số lượt truy cập tương ứng.

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

Đọc phản hồi

Phản hồi báo cáo Truy cập dữ liệu chủ yếu là tiêu đề và các hàng. Tiêu đề bao gồm AccessDimensionHeaders và AccessMetricHeaders liệt kê các cột trong Báo cáo.

Mỗi hàng báo cáo truy cập bao gồm AccessDimensionValues và AccessMetricValues cho các cột trong báo cáo. Thứ tự của các cột phải nhất quán trong yêu cầu, tiêu đề và mọi hàng.

Dưới đây là phản hồi mẫu cho yêu cầu mẫu trước đó:

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

Lọc theo bản ghi truy cập

Sử dụng trường dimensionFilter của đối tượng RunAccessReportRequest để hạn chế phản hồi báo cáo ở một số giá trị phương diện cụ thể khớp với bộ lọc.

Ví dụ sau đây tạo một báo cáo dựa trên các bản ghi truy cập dữ liệu cá nhân, lọc theo bản ghi truy cập của một người dùng có email Alex@example.net. Báo cáo này chứa thời gian của từng bản ghi truy cập, email và địa chỉ IP của người dùng.

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

Tương tự, bạn có thể sử dụng trường metricFilter của đối tượng RunAccessReportRequest để hạn chế phản hồi báo cáo ở một số giá trị chỉ số cụ thể khớp với bộ lọc.

Ví dụ sau đây sẽ tạo một báo cáo chứa email và số lượt truy cập của tất cả người dùng đã truy cập vào tài sản được chỉ định hơn 100 lần.

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

Báo cáo mẫu

Dưới đây là một số báo cáo mẫu mà bạn có thể thử.

Lần truy cập gần đây nhất

Bạn có thể tạo báo cáo truy cập mẫu sau đây bằng runAccessReport:

Bạn có thể tạo báo cáo này bằng cách truy vấn các phương diện mostRecentAccessEpochTimeMicros, userEmail và chỉ số accessCount. Báo cáo này chứa một hàng cho mỗi người dùng: phương diện mostRecentAccessEpochTimeMicros tổng hợp các bản ghi truy cập dữ liệu cho mỗi người dùng truy cập vào tài sản và trả về thời gian truy cập gần đây nhất (tính theo micrô giây Unix kể từ thời gian bắt đầu) cho mỗi hàng.

Bảng chi tiết về quyền truy cập của người dùng

Một ví dụ khác về báo cáo hữu ích là bảng chi tiết về số lượt truy cập của người dùng theo Cơ chế truy cập (ví dụ: Giao diện người dùng Google Analytics, API, v.v.).

Bạn có thể tạo báo cáo này bằng cách truy vấn các phương diện mostRecentAccessEpochTimeMicros, userEmail, accessMechanism và chỉ số accessCount.

Báo cáo này chứa một hàng cho mỗi tổ hợp người dùng/cơ chế truy cập. Phương diện mostRecentAccessEpochTimeMicros chứa lần gần đây nhất người dùng truy cập vào tài sản bằng cơ chế truy cập được chỉ định.

Tổng quan về quyền truy cập vào tài sản

Bạn có thể tạo báo cáo cho một tài sản mà không cần phân tích theo từng người dùng. Ví dụ: báo cáo sau đây cho biết tần suất một tài sản được truy cập bằng các cơ chế truy cập khác nhau:

Bạn có thể tạo báo cáo này bằng cách truy vấn các phương diện accessedPropertyId, accessedPropertyName, accessMechanism và chỉ số accessCount.

Báo cáo này chứa một hàng cho mỗi tổ hợp mã tài sản/cơ chế truy cập.

Quyền truy cập vào dữ liệu cá nhân

Để tạo một báo cáo trong đó mỗi hàng dựa trên một bản ghi truy cập dữ liệu riêng lẻ, hãy bỏ qua phương diện mostRecentAccessEpochTimeMicros khỏi truy vấn và sử dụng phương diện epochTimeMicros. Bạn không cần truy vấn chỉ số accessCount vì mỗi hàng của báo cáo đều chứa thông tin về một lần truy cập dữ liệu.

Báo cáo sau đây chứa thông tin chi tiết về mỗi lần người dùng truy cập vào tài sản được chỉ định.

Bạn có thể tạo báo cáo này bằng cách truy vấn phương diện epochTimeMicros, userEmail, accessedPropertyId, accessedPropertyName, userIP, accessMechanism, costDataReturned, revenueDataReturned.