Khắc phục sự cố

Hướng dẫn này trình bày các bước khắc phục sự cố thường gặp để 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:

Firebase gtag.js

• 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?

  Để giúp chống thư rác, bạn có thể thu hồi api_secret. Đảm bảo rằng api_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.

• Bạn đã sao chép api_secret đúng cách chưa?

  api_secret có phân biệt chữ hoa chữ thường. Kiểm tra kỹ để đảm bảo rằng api_secret trong giao diện người dùng Google Analytics chính xác giống với api_secret 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ụng app_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 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. 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 đang sử dụng SDK Google Analytics cho Firebase, bạn nên sử dụng các mã nhận dạng sau:

• 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ột firebase_app_id. Tìm thấy trong bảng điều khiển Firebase trong phần:
  Cài đặt dự án > Chung > Ứng dụng của bạn > Mã ứng dụng

• app_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:

  • Android – getAppInstanceId()
  • Kotlin – getAppInstanceId()
  • Swift – appInstanceID()
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity - GetAnalyticsInstanceIdAsync()

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 đang sử dụng gtag.js, bạn nên sử dụng các mã nhận dạng sau:

• measurement_id – Thêm 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ột measurement_id. Có trong giao diện người dùng Google Analytics ở mục:
  Quản trị > Luồng dữ liệu > chọn luồng của bạn > Mã đo lường
• client_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 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 ứng dụng. Hãy xem các ví dụ này để biết cách truy xuất giá trị này.

Thiếu sự kiện gắn thẻ phía máy chủ

Quy trình cài đặt Trình quản lý thẻ phía máy chủ bằng ứng dụng Measurement Protocol cho phép bạn gửi sự kiện ở định dạng Measurement Protocol đến một vùng chứa. Sau đó, vùng chứa sẽ gửi các sự kiện đó đến Google Analytics bằng cơ chế tương tự như tất cả các sự kiện SGTM khác.

Lưu ý: Tính năng này không gửi các sự kiện đó đến điểm cuối Measurement Protocol, do đó, không hỗ trợ tất cả các tính năng của điểm cuối Measurement Protocol, chẳng hạn như lấy thông tin địa lý và thiết bị từ các sự kiện gắn thẻ.

Nếu bạn muốn sử dụng tất cả các tính năng của Measurement Protocol, hãy gửi sự kiện trực tiếp đến Measurement Protocol thay vì vùng chứa.