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 để sửa các lỗi triển khai thường gặp.

Không có sự kiện nào

Nếu sự kiện của bạn không xuất hiện trong Google Analytics, thì có một số vấn đề thường gặp mà bạn nên tìm hiểu.

Trước tiên, hãy chọn khách hàng của bạn:

  • Bạn có đang sử dụng đúng api_secret không?

    Kiểm tra để đảm bảo rằng 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 dữ liệu, thì mỗi luồng dữ liệu sẽ có một khoá bí mật riêng.

  • api_secret của bạn có còn hợp lệ không?

    Để ngăn chặn 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 còn hiệu lực. Có thể một người dùng khác có quyền truy cập vào luồng phát của bạn đã vô tình thu hồi quyền truy cập vào luồng phát đó.

  • Bạn có sao chép api_secret đúng cách không?

    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 hoàn toàn 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 mã nhận dạng thiết bị hợp lệ. Sử dụng app_instance_id nếu bạn đang dùng Firebase và client_id nếu bạn đang dùng gtag.js.

Mã không hợp lệ

Vì Measurement Protocol hỗ trợ 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à danh sách các 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, thì bạn nên sử dụng các mã nhận dạng sau:

Bạn không nên sử dụng những thông tin sau:

  • firebase_instance_id – Bạn không nên đưa mã nhận dạng này vào yêu cầu của mình. Mã nhận dạng này được dùng để xác định một phiên bản nhất định của ứng dụng, nhưng chỉ dành riêng cho Firebase. Dịch vụ này được dùng cho các tác vụ như tin nhắn FCM.

gtag.js

Nếu đang sử dụng gtag.js, thì 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ã nhận dạng này xác định duy nhất một Luồng dữ liệu. Tất cả người dùng trên 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 POST cho yêu cầu. Mã nhận dạng này xác định duy nhất một phiên bản 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 của bạn. 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ủ

Việc cài đặt Trình quản lý thẻ phía máy chủ bằng một ứng dụng Measurement Protocol cho phép bạn gửi các sự kiện ở định dạng Measurement Protocol đến một vùng chứa. Sau đó, vùng chứa sẽ gửi những 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.

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 trực tiếp sự kiện đến Measurement Protocol thay vì gửi đến vùng chứa của bạn.