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

Bạn có thể tạo báo cáo về Quyền truy cập vào dữ liệu bằng phương thức Admin API phiên bản 1 runAccessReport. Báo cáo này cho biết mỗi khi người dùng đọc dữ liệu Google Analytics. Hồ sơ truy cập dữ liệu được lưu giữ 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 về quyền truy cập vào dữ liệu.

Yêu cầu Báo cáo quyền truy cập vào 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 Truy cập dữ liệu là sử dụng thư viện ứng dụng.

Xem Hướng dẫn bắt đầu nhanh để biết thông tin 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 một 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 chính

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

Tìm hiểu kỹ thông tin tổng quan về báo cáo chính trong Data API phiên bản 1, sau đó quay lại trang này để tìm hiểu thêm về báo cáo Quyền truy cập vào dữ liệu.

Tạo báo cáo về quyền truy cập vào dữ liệu

Sử dụng phương thức runAccessReport để yêu cầu Báo cáo 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 chính 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 chỉ định Tài sản Google Analytics bên trong một đườ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 hồ sơ quyền truy cập dữ liệu của Google Analytics cho Tài sản Google Analytics được chỉ định.

Nếu đang sử dụng một trong các thư viện ứng dụng Admin API, bạn không cần phải thao tác với đường dẫn URL yêu cầu theo cách thủ công. Hầu hết các ứng dụng API đều cung cấp một 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 các phản hồi báo cáo là chuỗi.

Chỉ số là các số đo đị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 Sơ đồ 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 yêu cầu báo cáo 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 bằng các tham số yêu cầu sau:

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

Sau đâ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 ra một danh sách email người dùng, thời gian gần đây nhất mà 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 câu trả lời

Phản hồi của báo cáo Quyền truy cập vào dữ liệu chủ yếu là tiêu đề và các hàng. Phần đầu trang bao gồm AccessDimensionHeaders và AccessMetricHeaders. Đây là những 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 nhất quán trong yêu cầu, tiêu đề và mọi hàng.

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

{
  "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 để giới hạn phản hồi báo cáo đối với các 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 riêng lẻ, lọc trên các 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 đối với các giá trị chỉ số cụ thể khớp với bộ lọc.

Ví dụ sau đây 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

Bạn có thể thử một số báo cáo mẫu sau đây.

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

Sau đây là báo cáo truy cập mẫu có thể được tạo bằng runAccessReport:

Bạn có thể tạo báo cáo này bằng cách truy vấn phương diện mostRecentAccessEpochTimeMicros, userEmail và accessCount chỉ số. 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 bằng micrô giây theo hệ thống Unix kể từ thời gian bắt đầu) cho mỗi hàng.

Thông tin 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à thông tin chi tiết về 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 phương diện mostRecentAccessEpochTimeMicros, userEmail, accessMechanism và accessCount chỉ số.

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 thời gian gần đây nhất mà 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 chi tiết về từng người dùng. Ví dụ: báo cáo sau đây cho biết tần suất truy cập vào một tài sản bằng nhiều cơ chế truy cập:

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

Báo cáo này có 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 từng dữ liệu

Để tạo báo cáo trong đó mỗi hàng dựa trên một bản ghi quyền 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 trong báo cáo đều chứa thông tin về một lần truy cập dữ liệu duy nhất.

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 các phương diện epochTimeMicros, userEmail, accessedPropertyId, accessedPropertyName, userIP, accessMechanism, costDataReturned, revenueDataReturned.