Xác minh việc triển khai

Sau khi xem xét các sự kiện xác thực, bạn sẽ muốn xác minh cách triển khai của mình. Máy chủ xác thực sẽ xác thực rằng các sự kiện của bạn có cấu trúc chính xác, nhưng để xác minh rằng các sự kiện đó đang được gửi chính xác đến tài sản của bạn, bạn cần làm như sau:

Nếu bạn không thấy các sự kiện của mình sau khi thực hiện các bước này, hãy xem khắc phục sự cố đối với các lỗi triển khai thường gặp.

Gửi sự kiện từ một ứng dụng khách

Chọn ứng dụng khách của bạn:

Để một sự kiện hợp lệ, sự kiện đó phải có app_instance_id đã được dùng để gửi sự kiện từ SDK Google Analytics cho Firebase. Hãy thu thập mã nhận dạng này ở phía máy khách và đưa mã nhận dạng đó vào lệnh gọi của bạn đến Measurement Protocol. Trong phần gửi sự kiện đến tài sản của bạn, chúng tôi sử dụng "app_instance_id" làm app_instance_id. Bạn cần thay thế mã nhận dạng này bằng một app_instance_id thực đến từ SDK. Hãy xem phần bạn có đang sử dụng app_instance_id chính xác không để biết cách đảm bảo bạn đang sử dụng một giá trị hợp lệ.

Gửi sự kiện đến tài sản của bạn

Sau khi gửi sự kiện từ một ứng dụng khách và thu thập app_instance_id hợp lệ, bạn sẽ sẵn sàng gửi sự kiện bằng Measurement Protocol. Khi xác minh cách triển khai, bạn nên gửi chính xác sự kiện mà bạn đang cố gắng đo lường bằng Measurement Protocol.

Ví dụ: đoạn mã sau đây sẽ gửi một sự kiện hoàn tiền:

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "app_instance_id": "APP_INSTANCE_ID",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "value": "9.99",
        "transaction_id": "ABC-123"
      }
    }]
  })
});

Kiểm tra khung hiển thị Theo thời gian thực

Sau khi gửi sự kiện bằng Measurement Protocol, hãy kiểm tra khung hiển thị Theo thời gian thực cho tài sản của bạn. Các sự kiện thường xuất hiện trong vòng vài giây.

Chuyển đến khung hiển thị Theo thời gian thực bằng cách mở Google Analytics, sau đó chuyển đến Báo cáo > Theo thời gian thực trong bảng điều hướng bên trái. Bạn nên tập trung vào các biểu đồ ở dưới cùng, chẳng hạn như "Số lượng sự kiện theo Tên sự kiện" và "Sự kiện chính theo Tên sự kiện".

Chế độ xem theo thời gian thực cho thấy một sự kiện

Kiểm tra DebugView

Nếu khung hiển thị Theo thời gian thực không cung cấp đủ thông tin chi tiết để bạn xác minh cách triển khai, hãy bật chế độ gỡ lỗi trong một số sự kiện thử nghiệm bằng cách đưa các tham số sau vào tập hợp params để bạn có thể theo dõi và xem xét các sự kiện trong DebugView:

  1. "debug_mode": true hoặc "debug_mode": 1
  2. "engagement_time_msec" được đặt thành một số dương

Ví dụ: đoạn mã sau đây sẽ gửi một sự kiện hoàn tiền khi bật chế độ gỡ lỗi:

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "app_instance_id": "APP_INSTANCE_ID",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "value": "9.99",
        "transaction_id": "ABC-123",
        "engagement_time_msec": 1200,
        "debug_mode": true
      }
    }]
  })
});

Sau khi gửi các sự kiện khi bật chế độ gỡ lỗi, hãy làm theo hướng dẫn theo dõi sự kiện bằng DebugView để xác minh cách triển khai của bạn.