Memvalidasi peristiwa

Pilih platform Anda:

Measurement Protocol Google Analytics tidak menampilkan HTTP kode error, meskipun format acara salah atau acara tidak ada parameter. Untuk memastikan peristiwa Anda valid, Anda harus mengujinya terhadap Server Validasi Measurement Protocol sebelum men-deploy-nya ke produksi. Setelah memvalidasi bahwa peristiwa terstruktur dengan baik, Anda harus memverifikasi penerapan untuk memastikan Anda menggunakan kunci yang benar.

Anda dapat langsung memanggil Server Validasi atau menggunakan situs Google Analytics Pembuat Peristiwa. Pembuat Peristiwa Google Analytics memungkinkan Anda membuat peristiwa, dan menggunakan Server Validasi Measurement Protocol untuk memvalidasinya.

Panduan ini menjelaskan cara mengirim peristiwa ke Measurement Protocol untuk Server Validasi Google Analytics 4 dan menafsirkan responsnya.

Mengirim peristiwa untuk validasi

Satu-satunya perbedaan pada permintaan untuk peristiwa yang dikirim ke Measurement Protocol dan Server Validasi Measurement Protocol adalah URL.

Server URL
Measurement Protocol /mp/collect
Server Validasi Measurement Protocol /debug/mp/collect

Semua kolom permintaan lainnya sama. Lihat referensi protokol untuk mengetahui detail selengkapnya tentang cara membuat permintaan yang valid.

Kode berikut menunjukkan peristiwa tidak valid yang dikirim ke Server Validasi Measurement Protocol:

const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      // Event names must start with an alphabetic character.
      name: '_badEventName',
      params: {},
    }]
  })
});

Respons validasi

Berikut adalah respons Server Validasi terhadap peristiwa sebelumnya:

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

Respons

Kunci Jenis Deskripsi
validationMessages Array<ValidationMessage> Array pesan validasi.

ValidationMessage

Kunci Jenis Deskripsi
fieldPath string Jalur ke kolom yang tidak valid.
description string Deskripsi error.
validationCode ValidationCode ValidationCode yang sesuai dengan error.

ValidationCode

Nilai Deskripsi
VALUE_INVALID Nilai yang diberikan untuk fieldPath tidak valid. Lihat batasan.
VALUE_REQUIRED Nilai yang diperlukan untuk fieldPath tidak diberikan.
NAME_INVALID Nama yang diberikan tidak valid. Lihat batasan.
NAME_RESERVED Nama yang diberikan merupakan salah satu nama yang dicadangkan. Lihat nama yang dicadangkan.
VALUE_OUT_OF_BOUNDS Nilai yang diberikan terlalu besar. Lihat batasan.
EXCEEDED_MAX_ENTITIES Ada terlalu banyak parameter dalam permintaan. Lihat batasan.
NAME_DUPLICATED Nama yang sama diberikan lebih dari satu kali dalam permintaan.