Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bạn có thể sử dụng Data API để truy cập vào dữ liệu báo cáo của Google Analytics (Google Analytics) theo phương thức lập trình. API này không tương thích với các tài sản Universal Analytics cũ.
Dưới đây là một số ví dụ về những thông tin bạn có thể báo cáo bằng Google Analytics Data API phiên bản 1:
Số người dùng hoạt động hằng ngày của ứng dụng Android trong tuần qua.
Số lượt xem trang của 10 trang hàng đầu trên trang web của bạn trong 28 ngày qua.
Số người dùng đang hoạt động ở mỗi quốc gia mà ứng dụng iOS của bạn có được trong 30 phút qua.
Bạn cũng có thể sử dụng Google Analytics Data API phiên bản 1 để làm những việc sau:
Tạo các trang tổng quan tuỳ chỉnh để trình bày dữ liệu Google Analytics.
Tự động hoá các nhiệm vụ báo cáo phức tạp để tiết kiệm thời gian.
Tích hợp dữ liệu Google Analytics với các ứng dụng kinh doanh khác.
Bắt đầu
Để bắt đầu, hãy xem hướng dẫn nhanh về thư viện ứng dụng. Có các thư viện ứng dụng trong Java,
Python, Node.js và các ngôn ngữ khác để đơn giản hoá việc triển khai.
Các phương thức có sẵn
Dưới đây là danh sách các phương thức API Dữ liệu. Để biết thêm thông tin chi tiết, hãy xem tài liệu tham khảo.
batchRunReports Đây là phiên bản hàng loạt của phương thức runReport cho phép bạn tạo nhiều báo cáo bằng một lệnh gọi API duy nhất.
runPivotReport Phương thức này trả về một báo cáo tổng hợp tuỳ chỉnh của dữ liệu sự kiện Google Analytics. Báo cáo tổng hợp là định dạng nâng cao và biểu đạt hơn so với báo cáo thông thường. Mỗi bảng tổng hợp mô tả các cột và hàng phương diện hiển thị trong phản hồi báo cáo.
batchRunPivotReports
Đây là phiên bản hàng loạt của phương thức runPivotReport, cho phép bạn tạo nhiều báo cáo bằng một lệnh gọi API.
getMetadata Phương thức này trả về siêu dữ liệu cho các phương diện và chỉ số có trong các phương thức báo cáo. Dùng để khám phá các phương diện và chỉ số. Phản hồi của phương thức này cũng bao gồm các Phương diện và chỉ số tuỳ chỉnh có sẵn cho tài sản Google Analytics đã chỉ định.
checkCompatibility Phương thức này liệt kê các phương diện và chỉ số có thể được thêm vào yêu cầu báo cáo và duy trì khả năng tương thích.
runRealtimeReport Phương thức này trả về một báo cáo tuỳ chỉnh về dữ liệu sự kiện theo thời gian thực cho tài sản của bạn. Sự kiện xuất hiện trong báo cáo theo thời gian thực vài giây sau khi được gửi đến Google Analytics. Báo cáo theo thời gian thực cho thấy các sự kiện và dữ liệu sử dụng trong khoảng thời gian từ thời điểm hiện tại đến 30 phút trước (tối đa 60 phút đối với tài sản Google Analytics 360).
properties.recurringAudienceLists(Bản xem trước sớm) Một nhóm phương thức cho phép bạn quản lý các lượt Xuất đối tượng định kỳ. Tính năng xuất đối tượng định kỳ sẽ tạo ra danh sách đối tượng mới mỗi ngày.
runFunnelReport(Bản xem trước sớm) Phương thức này trả về báo cáo
phễu tuỳ chỉnh của dữ liệu sự kiện Google Analytics. Dữ liệu khám phá phễu cho phép bạn thể hiện các bước mà người dùng cần thực hiện để hoàn tất một hành động bằng hình ảnh, và xem nhanh mức độ mà họ hoàn tất hoặc không hoàn tất ở mỗi bước.
Các phương diện và chỉ số được hỗ trợ
Để biết danh sách tất cả phương diện và chỉ số mà API Dữ liệu hỗ trợ, hãy xem tài liệu về giản đồ API.
[null,null,["Cập nhật lần gần đây nhất: 2025-03-10 UTC."],[[["\u003cp\u003eThe Google Analytics Data API (v1) allows programmatic access to Google Analytics report data, excluding Universal Analytics properties.\u003c/p\u003e\n"],["\u003cp\u003eThis API offers methods for retrieving various report types, including standard, pivot, realtime, and funnel reports, and enables tasks like building custom dashboards and automating reporting.\u003c/p\u003e\n"],["\u003cp\u003eUsers can leverage client libraries in Java, Python, Node.js, and other languages for streamlined implementation.\u003c/p\u003e\n"],["\u003cp\u003eThe API is currently in Alpha and Beta stages with potential for breaking changes, particularly in Alpha features.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive documentation, including API schema, quickstart guides, and reference materials, are available to aid developers in utilizing the API effectively.\u003c/p\u003e\n"]]],["The Google Analytics Data API allows programmatic access to report data, excluding legacy Universal Analytics properties. It offers Alpha and Beta channels with varying stability. Key actions include generating reports (simple, pivot, funnel, real-time), batching reports, retrieving metadata, and checking compatibility. The API can build dashboards, automate reporting, and integrate data with other apps. Client libraries simplify implementation. Methods include `runReport`, `runPivotReport`, `runFunnelReport`, and managing audience exports, among others.\n"],null,["# Google Analytics Data API Overview\n\nYou can use the [Data API](/analytics/devguides/reporting/data/v1/rest) to\nprogrammatically access Google Analytics (Google Analytics) report data. This\nAPI isn't compatible with legacy Universal Analytics properties.\n\n[Learn more about Google Analytics\nproperties](//support.google.com/analytics/answer/9325020).\n| This API provides features in Alpha and Beta channels. Alpha and Beta products may have limited support, and changes to these products may not be compatible with other Alpha and Beta versions.\n|\n| **Alpha**:\n| Features are in an early preview stage. While we try to notify you of\n| upcoming changes, expect to encounter breaking changes before the API is publicly released.\n|\n| **Beta**:\n| No breaking changes are expected in this channel.\n|\n| For official Google Analytics API announcements, subscribe to the\n| [Google Analytics API Notify Group](https://groups.google.com/forum/#!forum/google-analytics-api-notify).\n\nHere are some examples you might report on using the Google Analytics Data API v1:\n\n- How many daily active users has your Android app had in the last week.\n- How many page views the top 10 pages on your site had in the last 28 days.\n- How many active users per country your iOS app had in the last 30 minutes.\n\nYou can also use the Google Analytics Data API v1 to do the following:\n\n- Build custom dashboards to display Google Analytics data.\n- Automate complex reporting tasks to save time.\n- Integrate your Google Analytics data with other business applications.\n\nGet started\n-----------\n\nTo get started, see the [client library\nquickstart](/analytics/devguides/reporting/data/v1/quickstart-client-libraries). There are client libraries in Java,\nPython, Node.js, and other languages to simplify your implementation.\n\nAvailable methods\n-----------------\n\nHere's a list of the Data API methods. For more details, see the [reference\ndocumentation](/analytics/devguides/reporting/data/v1/rest).\n\n- [`runReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport) This method returns a customized report of your Google Analytics event data and is the preferred method for [simple report queries](/analytics/devguides/reporting/data/v1/basics).\n- [`batchRunReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunReports) This is a batch version of the runReport method which lets you generate multiple reports using a single API call.\n- [`runPivotReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runPivotReport) This method returns a customized [pivot report](/analytics/devguides/reporting/data/v1/pivots) of you Google Analytics event data. Pivot reports are more advanced and expressive formats than regular reports. Each pivot describes the visible dimension columns and rows in the report response.\n- [`batchRunPivotReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunPivotReports) This is a batch version of the runPivotReport method which lets you generate multiple reports using a single API call.\n- [`getMetadata`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) This method returns metadata for dimensions and metrics available in reporting methods. Used to explore the dimensions and metrics. The response of this method also includes the Custom dimensions and metrics available for the specified Google Analytics property.\n- [`checkCompatibility`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/checkCompatibility) This method lists dimensions and metrics that can be added to a report request and maintain compatibility.\n- [`runRealtimeReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) This method returns a customized [report of realtime event data](/analytics/devguides/reporting/data/v1/realtime-basics) for your property. Events appear in realtime reports seconds after they have been sent to the Google Analytics. Realtime reports show events and usage data for the periods of time ranging from the present moment to 30 minutes ago (up to 60 minutes for Google Analytics 360 properties).\n- [`properties.audienceExports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports) A group of methods that let you [generate Audience\n Exports](/analytics/devguides/reporting/data/v1/audience-export-basics), which include a snapshot of the users in an audience.\n- [`properties.recurringAudienceLists`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists) **(Early preview)** A group of methods that let you manage recurring Audience Exports. A recurring audience export produces new audience lists each day.\n- [`runFunnelReport`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runFunnelReport) **(Early preview)** This method returns a customized [funnel\n report](/analytics/devguides/reporting/data/v1/funnels) of your Google Analytics event data. Funnel exploration lets you visualize the steps your users take to complete a task and quickly see how well they are succeeding or failing at each step.\n\nSupported dimensions and metrics\n--------------------------------\n\nFor a list of all the dimensions and metrics supported by the Data API, see the\n[API schema documentation](/analytics/devguides/reporting/data/v1/api-schema)."]]
