Nhập dữ liệu từ Google Analytics 4

Hai cách đưa số liệu GA4 vào đây: số liệu tổng hằng ngày để biết MousePlayer thực sự nhìn thấy bao nhiêu - và từng phiên GA4 từ dữ liệu xuất BigQuery cho các lượt truy cập chúng tôi không thể ghi.

1. Dữ liệu được nhập và dữ liệu không được nhập

Cả hai cách đều đọc từ tài khoản Google của bạn và được bật riêng. Chúng trả lời các câu hỏi khác nhau và bạn không cần cả hai.

CáchDữ liệu lấy vềMục đích
Data APISố liệu tổng hằng ngày: phiên, người dùng, lượt xem trang, phiên có tương tácCâu hỏi về độ bao phủ. GA4 đếm 3.000 phiên, MousePlayer ghi được 40 - không có số liệu tham chiếu thì thậm chí không thể nhận ra khác biệt.
Nhập từ BigQueryTừng phiên GA4 cùng các sự kiệnĐiều xảy ra trong lượt truy cập MousePlayer không thể ghi.

Không thể phát lại phiên đã nhập. GA4 không lưu ảnh chụp trang hay di chuyển chuột nên không có gì để dựng bản phát lại. Bạn nhận số liệu và sự kiện bên cạnh các bản ghi - chỉ vậy và chúng tôi không trình bày quá mức.

Dữ liệu nhập được lưu trong các bảng riêng và không bao giờ trộn vào bản ghi của bạn. Nếu không, ý nghĩa của mọi số liệu suy ra sẽ âm thầm thay đổi - hồ sơ hành vi, đánh giá giá trị khách, phân tích trở ngại - và sau đó không ai có thể phân biệt hàng nào được đo, hàng nào được lấy về.

2. Cách 1: Data API

Bạn cần hai thứ: ID thuộc tính và khóa tài khoản dịch vụ.

ID thuộc tính không phải mã đo lường

Đây là lỗi thử kết nối thường gặp nhất và thông báo lỗi của chính Google không nêu rõ. Mã đo lường có dạng G-ABC123XYZ, nằm trong đoạn mã theo dõi và hiển thị ở mọi nơi. ID thuộc tính chỉ gồm chữ số và chỉ xuất hiện trong khu vực quản trị, tại Quản trị, Cài đặt thuộc tính. Cần giá trị thứ hai; chúng tôi từ chối giá trị thứ nhất kèm ghi chú thay vì để bạn gặp lỗi 400.

Tạo và cấp quyền cho tài khoản dịch vụ

  • Trong Google Cloud Console, tạo tài khoản dịch vụ và tạo khóa JSON.
  • Trong cùng dự án, bật Google Analytics Data API.
  • Trong GA4, tại Quản trị, Quản lý quyền truy cập thuộc tính, thêm địa chỉ email của tài khoản dịch vụ với vai trò Người xem. Tài khoản dịch vụ là người dùng riêng; nếu thiếu bước này Google trả lỗi 403 mà không nói lý do.

Dán nội dung tệp JSON vào trường. Nội dung được lưu có mã hóa và sau đó chỉ hiển thị dạng rút gọn.

3. Cách 2: nhập từ BigQuery

Cách này đọc dữ liệu xuất thô GA4. Bạn phải thiết lập một lần trong GA4: Quản trị, Liên kết BigQuery. Các bảng chỉ xuất hiện từ ngày hôm sau - trước đó chức năng nhập không tìm thấy gì và đó không phải lỗi.

Thông tin bạn nhập

  • ID dự án GCP chứa dữ liệu xuất. Không nhất thiết là cùng dự án bạn xuất dữ liệu MousePlayer vào.
  • ID tập dữ liệu. GA4 đặt tên là analytics_<propertyId>.
  • Khóa tài khoản dịch vụ có quyền BigQuery Data Viewer trên tập dữ liệu và BigQuery Job User trong dự án. Quyền đọc là đủ; vui lòng không cấp thêm.

Chi phí và bên thanh toán

BigQuery tính phí theo số byte được đọc và bạn chịu khoản phí đó. Vì vậy chức năng nhập chỉ đọc vài ngày mỗi lần chạy và luôn chỉ chạy một truy vấn - truy vấn thứ hai sẽ đọc lại cùng các bảng. Ngoài ra, giới hạn cứng hủy truy vấn trước khi chi phí tăng cao; khi đó thông báo trong nhật ký gửi nhận cho biết khoảng thời gian quá lớn.

Tần suất

Mặc định mỗi sáu giờ và mỗi lần chạy lấy lại ba ngày gần nhất. Đây không phải lựa chọn tùy ý: GA4 bổ sung dữ liệu muộn trong tối đa 48 giờ và dữ liệu xuất hằng ngày chỉ xuất hiện vào ngày hôm sau. Truy vấn thường xuyên hơn không cho số liệu mới hơn mà chỉ trả lại số liệu cũ.

4. Khóa liên kết hai phía

Nếu bạn cũng đặt cầu nối phân tích thành GA4, MousePlayer ghi ID máy khách từ cookie _ga trong mỗi phiên. Đó chính là giá trị dữ liệu xuất BigQuery mang theo dưới dạng user_pseudo_id.

Nhờ đó có thể đối chiếu một phiên GA4 với một bản ghi của bạn - và ngược lại, bạn thấy GA4 đã đếm gì trong cùng lượt truy cập. Không có cầu nối, hai phía chỉ nằm cạnh nhau mà không được kết nối.

Cùng trường đó cũng chứa mã định danh khách hàng riêng của bạn nếu bạn dùng setUserId(). Bạn không thể có cả hai: hoặc ID máy khách Google ở đó, hoặc mã riêng của bạn.

5. Sự đồng ý, lưu giữ, xóa

Dữ liệu được nhập đã có cookie

Chỉ nhập các hàng có user_pseudo_id. Khi khách từ chối, GA4 gửi lượt truy cập không có cookie theo Consent Mode và chúng không có mã này - nên tự bị loại mà không cần ai cam đoan. Các hàng được mô hình hóa, tức ước tính, cũng bị loại vì cùng lý do: lưu một ước tính thành phiên nghĩa là lưu các lượt truy cập chưa từng xảy ra.

Thời gian lưu giữ

Mặc định 180 ngày, tính từ ngày mà hàng dữ liệu mô tả - không phải thời điểm nhập. Nếu không, thời hạn sẽ không bao giờ hết vì mỗi lần chạy lại lấy cùng các ngày.

Xóa

Nếu khách yêu cầu xóa dữ liệu, các phiên GA4 đã nhập của họ cũng bị xóa - trong phạm vi có thể quy về khách qua mã định danh ở trên. Nếu bạn xóa dự án, mọi phiên này đều bị xóa, kể cả các hàng chưa từng thuộc một bản ghi của bạn. Lần chạy lưu giữ hằng ngày chủ động không tác động đến chúng: dữ liệu GA4 theo thời hạn riêng và bản ghi của bạn hết hạn sớm hơn.

6. Khi không nhận được dữ liệu

Mỗi lần chạy ghi kết quả vào nhật ký gửi nhận trên trang tích hợp - bao gồm cả thất bại, bằng lời rõ ràng. Thông tin đó thường đã cho biết đang thiếu gì.

Thông báoViệc cần làm
ID thuộc tính phải chỉ gồm chữ sốBạn đã nhập mã đo lường. Số đúng nằm trong GA4 ở Cài đặt thuộc tính.
HTTP 403 từ Data APITài khoản dịch vụ không có vai trò Người xem trên thuộc tính GA4 hoặc Data API chưa bật trong dự án GCP.
Không tìm thấy tập dữ liệu hoặc bảng xuấtChưa liên kết BigQuery, tập dữ liệu có tên khác hoặc chưa qua một ngày.
Truy cập bị từ chối (BigQuery)Tài khoản dịch vụ thiếu BigQuery Data Viewer trên tập dữ liệu hoặc BigQuery Job User trong dự án.
Truy vấn sẽ đọc quá nhiều dữ liệuGiới hạn chi phí đã hủy trước khi có khoản phí nào được tính. Chọn khoảng thời gian ngắn hơn.
không có phiên trong khoảng thời gianKhông phải lỗi. Không có phiên có sự đồng ý trong các ngày được lấy.