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 sự kiện không xuất hiện trong Google Analytics, bạn nên kiểm tra một số vấn đề phổ biến.
Trước tiên, hãy chọn khách hàng:
Bạn có đang sử dụng đúng api_secret không?
Kiểm tra để đảm bảo bạn đang sử dụng
api_secret
cho đúng luồng. 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ột khoá riêng.api_secret của bạn có còn hợp lệ không?
Để góp phần chống thư rác, bạn có thể thu hồi các
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 luồng của bạn đã thu hồi quyền truy cập vào luồng đó 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 mã mà bạn đang sử dụng trong mã.Khô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ệ. 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.
Giấy tờ tuỳ thân không hợp lệ
Vì Giao thức đo lường hỗ trợ các mã nhận dạng từ SDK Google Analytics cho Firebase và gtag.js, hãy đảm bảo bạn sử dụng đúng mã nhận dạng. Mã nhận dạng 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. Sau đây là những 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 sẽ là:
firebase_app_id
– Thêm mã nhận dạng này vào tham số truy vấn cho yêu cầu. Mã nhận dạng 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 sẽ có cùng mộtfirebase_app_id
. Bạn có thể tìm thấy bảng điều khiển của Firebase trong phần:
Cài đặt dự án > Chung > Ứng dụng của bạn > Mã ứng dụngapp_instance_id
– Thêm mã nhận dạng này vào nội dung yêu cầu POST. Mã nhận dạng này xác định riêng một lượt cài đặt nhất định của Ứ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. 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 những nội dung sau:
firebase_instance_id
– Bạn không được đưa mã nhận dạng này vào yêu cầu. Mã này được dùng để xác định một thực thể nhất định của ứng dụng, nhưng chỉ dành riêng cho Firebase. Phương thức này được dùng cho các tác vụ như thông báo FCM.
gtag.js
Nếu bạn đang sử dụng gtag.js, các mã mà bạn nên sử dụng là:
measurement_id
– Đưa mã nhận dạng 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
. Có trong giao diện người dùng của 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ã nhận dạng này xác định duy nhất một thực thể người dùng nhất định của ứng dụng web. Giá trị này sẽ khác nhau đối với mỗi người dùng trong ứng dụng. Hãy xem các ví dụ này để biết cách truy xuất giá trị này.