Số lượt truy cập xác thực – Measurement Protocol

Tài liệu này mô tả cách xác thực lượt truy cập Giao thức đo lường của Google Analytics.

Tổng quan

Google Analytics Measurement Protocol không trả về mã lỗi HTTP, ngay cả khi lượt truy cập Measurement Protocol không đúng định dạng hoặc thiếu tham số bắt buộc. Để đảm bảo rằng các lượt truy cập của bạn được định dạng chính xác và chứa tất cả các thông số bắt buộc, bạn có thể kiểm tra các thông số đó trên máy chủ xác thực trước khi triển khai chúng vào giai đoạn sản xuất.

Hướng dẫn này mô tả quy trình gửi lượt truy cập đến Máy chủ xác thực giao thức đo lường và giải thích cách diễn giải phản hồi.

Gửi lượt truy cập để xác thực

Số lượt truy cập có thể được gửi đến Máy chủ xác thực Measurement Protocol thông qua bất kỳ phương thức nào hiện được Measurement Protocol hỗ trợ. Điểm khác biệt duy nhất là URL. Để gửi các lượt truy cập đến Máy chủ xác thực Measurement Protocol, hãy sử dụng điểm cuối /debug/collect thay vì /collect. Ví dụ sau đây cho thấy một lượt truy cập không hợp lệ được gửi đến Máy chủ xác thực Measurement Protocol:

https://www.google-analytics.com/debug/collect?tid=fake&v=1

Để biết thêm thông tin chi tiết về cách tạo lượt truy cập Measurement Protocol, hãy xem tài liệu tham khảo về giao thức.

Diễn giải câu trả lời

Phản hồi từ Máy chủ xác thực Measurement Protocol sẽ có định dạng JSON. Sau đây là ví dụ minh hoạ phản hồi cho lượt truy cập nêu trên:

{
  "hitParsingResult": [
    {
      "valid": false,
      "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1",
      "parserMessage": [
        {
          "messageType": "ERROR",
          "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        },
        {
          "messageType": "ERROR",
          "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        }
      ]
    }
  ]
}

Gốc phản hồi (hitParsingResult) là một mảng có độ dài tương ứng với số lượt truy cập được gửi trong yêu cầu ban đầu. Mỗi đối tượng trong mảng sẽ chứa các khoá valid, hit và parserMessage. Nếu một lượt truy cập không hợp lệ, parserMessage sẽ chứa một mảng các đối tượng mô tả các vấn đề xác thực. Nếu một lượt truy cập hợp lệ, parserMessage sẽ là một mảng trống.

Bảng sau đây mô tả thuộc tính của từng mục trong mảng hitParsingResult:

Khoá Loại Nội dung mô tả
valid Boolean true cho lượt truy cập hợp lệ, false cho lượt truy cập không hợp lệ.
hit string Một chuỗi chứa đường dẫn của yêu cầu cũng như phương thức và giao thức của yêu cầu đó.
parserMessage Array Danh sách các thông báo của trình phân tích cú pháp. Nếu lượt truy cập hợp lệ, mảng này sẽ trống.
parserMessage.messageType string Giá trị có thể là "INFO", "WARN" và "ERROR".
parserMessage.description string Thông tin bổ sung hoặc các bước để khắc phục vấn đề xác thực.
parserMessage.parameter string|undefined Thông số (nếu có) gây ra vấn đề xác thực.