Gửi các sự kiện Measurement Protocol đến Google Analytics

Hướng dẫn này giải thích cách bạn có thể gửi sự kiện web và luồng ứng dụng Giao thức đo lường của Google Analytics đến máy chủ Google Analytics để bạn có thể xem các sự kiện Measurement Protocol trong báo cáo Google Analytics.

Chọn nền tảng bạn muốn xem trong hướng dẫn này:

Định dạng yêu cầu

Measurement Protocol cho Google Analytics 4 chỉ hỗ trợ các yêu cầu HTTP POST.

Để gửi sự kiện, hãy sử dụng định dạng sau:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Bạn phải cung cấp các thông tin sau trong URL yêu cầu:

  • api_secret: API SECRET được tạo trong giao diện người dùng Google Analytics.

    Để tạo khoá bí mật mới, hãy chuyển đến mục Quản trị > Luồng dữ liệu > chọn luồng của bạn > Measurement Protocol > Tạo.

  • measurement_id: Bạn có thể tìm thấy mã đo lường được liên kết với một luồng trong giao diện người dùng Google Analytics trong mục Quản trị > Luồng dữ liệu > chọn luồng > Mã đo lường.

    measurement_id không phải là Mã luồng của bạn.

Xem tham số truy vấn để biết đầy đủ thông tin.

Bạn phải cung cấp các thông tin sau trong nội dung yêu cầu:

  • client_id: Giá trị nhận dạng duy nhất của ứng dụng. Tính năng này khác với app_instance_id của Firebase. Sử dụng gtag.js('get').

  • user_id: Không bắt buộc. Giá trị nhận dạng duy nhất của một người dùng. Chỉ có thể chứa utf-8 ký tự. Hãy xem bài viết User-ID để phân tích trên nhiều nền tảng để biết thêm thông tin về giá trị nhận dạng này.

  • consent: Không bắt buộc. Tìm hiểu cách thiết lập chế độ cài đặt lấy sự đồng ý.

  • events: Một mảng các mục sự kiện. Bạn có thể bao gồm nhiều sự kiện trong một yêu cầu.

    Để hoạt động của người dùng hiển thị trong các báo cáo như Theo thời gian thực, bạn phải cung cấp engagement_time_msec và session_id dưới dạng một phần của params cho event. Thông số engagement_time_msec phải phản ánh thời gian tương tác của sự kiện tính bằng mili giây.

    Ví dụ:

  {
   "client_id": "123456.7654321",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

Mặc dù session_start là tên sự kiện dành riêng, nhưng việc tạo session_id mới sẽ tạo một phiên mới mà không cần gửi session_start. Tìm hiểu cách tính số phiên.

Thử ngay

Dưới đây là ví dụ mà bạn có thể sử dụng để gửi một sự kiện tutorial_begin đến máy chủ Google Analytics của mình:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

Các điểm hạn chế

Các giới hạn sau áp dụng cho việc gửi sự kiện Measurement Protocol đến Google Analytics:

  • Yêu cầu có thể có tối đa 25 sự kiện.
  • Sự kiện có thể có tối đa 25 thông số.
  • Sự kiện có thể có tối đa 25 thuộc tính người dùng.
  • Tên thuộc tính người dùng chỉ được có tối đa 24 ký tự.
  • Giá trị thuộc tính người dùng chỉ được có tối đa 36 ký tự.
  • Tên sự kiện chỉ được có tối đa 40 ký tự, chỉ được chứa ký tự chữ và số, dấu gạch dưới, đồng thời phải bắt đầu bằng một ký tự chữ cái.
  • Tên thông số bao gồm thông số mục chỉ được có tối đa 40 ký tự, chỉ được chứa ký tự chữ và số, dấu gạch dưới, đồng thời phải bắt đầu bằng một ký tự chữ cái.
  • Giá trị thông số bao gồm cả giá trị thông số mục phải có 100 ký tự trở xuống.
  • Thông số mặt hàng có thể có tối đa 10 thông số tùy chỉnh.
  • Nội dung bài đăng phải nhỏ hơn 130kB.
  • Mô hình phân bổ ở cấp sự kiện từ sự kiện Measurement Protocol được hỗ trợ tối đa 63 ngày sau sự kiện gắn thẻ trực tuyến gần đây nhất để xuất lượt chuyển đổi sang Google Ads và các mục tích hợp đa phương tiện khác, ngay cả khi khoảng thời gian chuyển đổi của sự kiện chuyển đổi lớn hơn 63 ngày. Ngược lại, hệ thống phân bổ cấp sự kiện để gắn thẻ các sự kiện trực tuyến được hỗ trợ cho toàn bộ khoảng thời gian chuyển đổi.
  • Nhằm mục đích tái tiếp thị, bạn có thể tham gia các sự kiện Measurement Protocol bằng cách sử dụng cookie hoặc mã thiết bị được liên kết trong số ngày sau đây sau sự kiện trực tuyến gần đây nhất:
    • Luồng dữ liệu web: 30 ngày
    • Luồng ứng dụng: 42 ngày
  • Những sự kiện trên App Measurement Protocol được gửi đến Google Analytics 4 sẽ không điền sẵn đối tượng Tìm kiếm trong Google Ads cho người dùng ứng dụng.