Hướng dẫn này trình bày các bước khắc phục sự cố phổ biến để khắc phục các lỗi triển khai thường gặp.
Không có sự kiện nào
Nếu các sự kiện không xuất hiện trong Google Analytics, thì bạn nên lưu ý một số vấn đề thường gặp.
Trước tiên, hãy chọn khách hàng của bạn:
Bạn có sử dụng đúng api_secret không?
Hãy kiểm tra để đảm bảo bạn đang sử dụng
api_secret
cho đúng sự kiện phát trực tiếp. Nếu bạn thiết lập giao thức đo lường cho nhiều luồng, thì mỗi luồng sẽ có mã bí mật riêng.api_secret của bạn còn hợp lệ không?
Để giúp chống lại tin nhắn rác, bạn có thể thu hồi
api_secret
. Hãy đảm bảo rằngapi_secret
bạn đang sử dụng vẫn hợp lệ. Có thể một người dùng khác có quyền truy cập vào sự kiện phát trực tiếp của bạn đã bị thu hồi quyền truy cập vào sự kiện đó do nhầm lẫn.api_secret của bạn có được sao chép chính xác không?
api_secret
có phân biệt chữ hoa chữ thường. Hãy kiểm tra kỹ để đảm bảoapi_secret
trong giao diện người dùng Google Analytics giống chính xác với giao diện bạn đang sử dụng trong mã.Đừng sử dụng
advertising_id
.advertising_id
không được hỗ trợ làm giá trị nhận dạng thiết bị hợp lệ. Hãy sử dụngapp_instance_id
nếu bạn đang sử dụng Firebase vàclient_id
nếu bạn đang sử dụng gtag.js.
ID không hợp lệ
Vì Measurement Procotol hỗ trợ các mã nhận dạng từ SDK Google Analytics cho Firebase và gtag.js, nên hãy nhớ sử dụng đúng mã. Các mã nhận dạng mà bạn nên sử dụng sẽ thay đổi, tuỳ thuộc vào việc bạn đang sử dụng SDK Google Analytics cho Firebase hay gtag.js. Dưới đây là các mã nhận dạng mà bạn nên sử dụng:
SDK Google Analytics cho Firebase
Nếu bạn đang sử dụng SDK Google Analytics cho Firebase, các mã nhận dạng bạn nên sử dụng là:
firebase_app_id
– Đưa mã này vào tham số truy vấn cho yêu cầu. Mã này xác định duy nhất Ứng dụng Firebase của bạn. Tất cả người dùng ứng dụng của bạn sẽ có cùng mộtfirebase_app_id
. Có trong bảng điều khiển của Firebase, trong:
Cài đặt dự án > Chung > Ứng dụng của bạn > Mã ứng dụngapp_instance_id
– Đưa mã này vào nội dung POST cho yêu cầu. Mã nhận dạng này xác định duy nhất một lượt cài đặt nhất định của một Ứng dụng Firebase. Giá trị này sẽ khác nhau đối với mỗi lượt cài đặt ứng dụng của bạn. Sau đây là các phương thức để yêu cầu giá trị này cho từng nền tảng Firebase:
Bạn không nên sử dụng:
firebase_instance_id
– Không được đưa mã này vào yêu cầu của bạn. Mã này dùng để xác định một thực thể nhất định của ứng dụng, nhưng dành riêng cho Firebase. Dữ liệu này được dùng cho các tác vụ như tin nhắn FCM.
gtag.js
Nếu bạn đang sử dụng gtag.js, thì các mã nhận dạng mà bạn nên sử dụng là:
measurement_id
– Đưa mã này vào tham số truy vấn cho yêu cầu. Mã này xác định duy nhất một Luồng dữ liệu. Tất cả người dùng trang web của bạn sẽ có cùng mộtmeasurement_id
. Tìm thấy trong giao diện người dùng Google Analytics trong mục:
Quản trị > Luồng dữ liệu > chọn luồng của bạn > Mã đo lườngclient_id
– Đưa mã này vào nội dung POST cho yêu cầu. Mã này xác định duy nhất một phiên bản người dùng nhất định của một ứng dụng web. Giá trị này sẽ khác nhau đối với mỗi người dùng ứng dụng. Hãy xem các ví dụ này để biết cách truy xuất giá trị này.