Xác thực sự kiện

Chọn nền tảng bạn sử dụng:

Measurement Protocol của Google Analytics không trả về HTTP mã lỗi, ngay cả khi một sự kiện không đúng định dạng hoặc bị thiếu tham số. Để đảm bảo các sự kiện đều hợp lệ, bạn nên kiểm tra chúng so với Máy chủ xác thực Measurement Protocol trước khi triển khai cho phiên bản chính thức. Sau khi xác thực rằng các sự kiện được cấu trúc đúng cách, bạn nên xác minh cách triển khai của bạn để đảm bảo bạn đang sử dụng đúng khoá.

Bạn có thể gọi trực tiếp đến Máy chủ xác thực hoặc sử dụng công cụ Google Analytics Trình tạo sự kiện. Trình tạo sự kiện của Google Analytics cho phép bạn tương tác tạo sự kiện và sử dụng Máy chủ xác thực Measurement Protocol để xác thực chúng.

Hướng dẫn này mô tả cách gửi sự kiện đến Measurement Protocol cho Google Máy chủ xác thực Analytics 4 và diễn giải phản hồi.

Gửi sự kiện để xác thực

Điểm khác biệt duy nhất về yêu cầu đối với những sự kiện được gửi đến Measurement Protocol và Máy chủ xác thực Measurement Protocol là URL.

Máy chủ URL
Measurement Protocol /mp/collect
Máy chủ xác thực Measurement Protocol /debug/mp/collect

Tất cả các trường yêu cầu khác đều giống nhau. Hãy xem tài liệu tham khảo về giao thức để biết toàn bộ về cách xây dựng một yêu cầu hợp lệ.

Mã sau đây cho thấy một sự kiện không hợp lệ đang được gửi đến Measurement Protocol Máy chủ xác thực:

Phản hồi xác thực

Dưới đây là phản hồi của Máy chủ xác thực cho sự kiện trước đó:

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

Phản hồi

Khoá Loại Mô tả
validationMessages Mảng<ValidationMessage> Một mảng các thông báo xác thực.

ValidationMessage

Khoá Loại Mô tả
fieldPath string Đường dẫn đến trường không hợp lệ.
description string Nội dung mô tả về lỗi.
validationCode ValidationCode Một ValidationCode tương ứng với lỗi.

ValidationCode

Giá trị Mô tả
VALUE_INVALID Giá trị được cung cấp cho fieldPath không hợp lệ. Xem các giới hạn.
VALUE_REQUIRED Bạn chưa cung cấp giá trị bắt buộc cho fieldPath.
NAME_INVALID Tên đã cung cấp không hợp lệ. Xem các giới hạn.
NAME_RESERVED Tên được cung cấp là một trong những tên dành riêng. Xem mục đặt trước tên.
VALUE_OUT_OF_BOUNDS Giá trị đã cung cấp quá lớn. Xem các giới hạn.
EXCEEDED_MAX_ENTITIES Có quá nhiều thông số trong yêu cầu. Xem các giới hạn.
NAME_DUPLICATED Bạn đã cung cấp cùng một tên nhiều lần trong yêu cầu.