Tài liệu này cung cấp thông tin tổng quan cấp cao về API Báo cáo chính của Google Analytics phiên bản 3.0. Để biết tài liệu tham khảo chi tiết về API này, hãy xem Hướng dẫn tham khảo.
Giới thiệu
API Báo cáo chính của Google Analytics cho phép bạn truy cập vào hầu hết dữ liệu báo cáo trong Google Analytics. Với API Báo cáo chính, bạn có thể:
- Tạo trang tổng quan tuỳ chỉnh để trình bày dữ liệu Google Analytics.
- Tiết kiệm thời gian bằng cách tự động hoá các công việc báo cáo phức tạp.
- Tích hợp dữ liệu Google Analytics với các ứng dụng khác dành cho doanh nghiệp.
Chọn phiên bản
Gần đây, chúng tôi đã ra mắt phiên bản mới của API báo cáo chính.
- Bạn muốn tạo một ứng dụng mới? – Bạn nên sử dụng phiên bản 3.0 mới nhất.
- Bạn đang sử dụng phiên bản cũ 2.3? – Đọc Hướng dẫn di chuyển để biết thông tin chi tiết về cách cập nhật ứng dụng nhằm sử dụng phiên bản mới.
Bắt đầu
Bạn muốn bắt đầu ngay? Hãy đọc Hướng dẫn về API Hello Analytics.
Mỗi ứng dụng sử dụng API sẽ phải trải qua một vài bước để đăng ký, uỷ quyền cho người dùng và làm việc với API. Hướng dẫn này sẽ hướng dẫn bạn qua từng bước và cuối cùng, bạn sẽ có một ứng dụng đang hoạt động có thể tuỳ chỉnh.
Tổng quan về khái niệm
API Báo cáo chính trả về dữ liệu báo cáo bao gồm số liệu thống kê bắt nguồn từ dữ liệu do mã theo dõi Google Analytics thu thập. Mỗi báo cáo được sắp xếp theo phương diện và chỉ số. Bạn sử dụng API Báo cáo chính để truy vấn các phương diện và chỉ số nhằm tạo báo cáo tuỳ chỉnh.
Có 3 khái niệm cơ bản làm cơ sở cho API báo cáo chính:
- Mối liên hệ của báo cáo với người dùng và chế độ xem (hồ sơ).
- Cấu trúc của báo cáo và cách tạo truy vấn
- Xử lý phản hồi của API
Báo cáo, Người dùng và Chế độ xem (Hồ sơ)
Để yêu cầu dữ liệu báo cáo cho một người dùng, ứng dụng của bạn phải xác định người dùng đó và chỉ định một chế độ xem (hồ sơ) để truy xuất dữ liệu. Người dùng được xác định bằng cách lấy thông tin xác thực uỷ quyền và truyền những thông tin đó vào từng yêu cầu API. Chế độ xem (hồ sơ) là một phần thuộc hệ phân cấp cấu hình của Google Analytics và được xác định bằng mã chế độ xem (hồ sơ).
Có một số cách để tìm mã chế độ xem (hồ sơ) của bạn.
- Ứng dụng của bạn có thể sử dụng API Quản lý để truyền tải hệ phân cấp cấu hình của Quản lý nhằm lấy mã chế độ xem (hồ sơ).
- Trong URL của từng báo cáo trong Google Analytics.
chụp màn hình
- Trong Google Analytics, hãy nhấp vào mục
Quản trị trên thanh trình đơn. Chọn tài khoản và tài sản chứa
chế độ xem đó. Trong cột CHẾ ĐỘ XEM, hãy nhấp vào Cài đặt chế độ xem
để lấy mã chế độ xem.
chụp màn hình
Truy vấn phương diện và chỉ số
Bạn truy vấn API cho dữ liệu báo cáo của Google Analytics. Dữ liệu này bao gồm các phương diện và chỉ số. Chỉ số là các phép đo riêng lẻ về hoạt động của người dùng trên tài sản của bạn, chẳng hạn như số phiên và số lượt xem trang. Phương diện phân tích các chỉ số theo một số tiêu chí phổ biến, chẳng hạn như quốc gia hoặc trình duyệt. Khi tạo truy vấn, bạn sẽ chỉ định phương diện và chỉ số mà bạn muốn có trong dữ liệu báo cáo của mình.
Sử dụng Hướng dẫn tham khảo về phương diện và chỉ số mang tính tương tác để khám phá tất cả các phương diện và chỉ số được hiển thị qua API. Ngoài ra, hãy đọc Hướng dẫn tham khảo chính về API Báo cáo để tìm hiểu cách chỉ định các phương diện và chỉ số trong truy vấn API.
Làm việc với báo cáo
Dữ liệu được trả về từ API có thể được coi là một bảng có tiêu đề và danh sách hàng. Mỗi phản hồi của API bao gồm một tiêu đề mô tả tên và loại dữ liệu của từng cột. Phản hồi cũng chứa danh sách các hàng, trong đó mỗi hàng là một danh sách các ô có dữ liệu theo cùng thứ tự với tiêu đề. Bạn sử dụng thông tin trong tiêu đề để xác định loại dữ liệu trong mỗi ô.
Hãy đọc Hướng dẫn tham khảo chính về API Báo cáo chính để biết thêm thông tin về phản hồi của API.
Chính sách về hạn mức và việc ngừng sử dụng
API của Google Analytics xử lý hàng triệu hoạt động. Để bảo vệ hệ thống không phải nhận nhiều hoạt động hơn khả năng xử lý và để đảm bảo phân bổ tài nguyên hệ thống một cách công bằng, cần phải sử dụng hệ thống hạn mức. Hãy đọc hướng dẫn về Hạn mức và hạn mức để biết các hạn mức cụ thể.
Để biết thông tin chi tiết về cách xử lý những thay đổi đối với các cột API báo cáo chính (tức là các phương diện và chỉ số), hãy đọc Chính sách về việc không dùng dữ liệu. Để tìm hiểu cách sử dụng API siêu dữ liệu nhằm kiểm tra các cột không dùng nữa, hãy xem Hướng dẫn phát triển API siêu dữ liệu.
Các bước tiếp theo
Giờ đây, khi bạn đã hiểu cách hoạt động của API này, chúng tôi có một số tài nguyên để giúp bạn bắt đầu:
- Đọc Hướng dẫn cho nhà phát triển để tìm hiểu cách làm việc với API.
- Sử dụng công cụ tương tác Trình khám phá truy vấn để tạo truy vấn một cách trực quan và xem phản hồi thông qua API.
- Đọc bài viết Truy vấn phổ biến, liệt kê một số truy vấn phổ biến nhất về API Báo cáo chính.
- Hãy xem tài liệu tham khảo về Phương diện và chỉ số để biết danh sách tất cả dữ liệu có sẵn thông qua API.
- Hãy xem trang Thư viện và mẫu để biết danh sách tất cả thư viện ứng dụng có thể dùng với API này.