Memvalidasi peristiwa

Ringkasan

Measurement Protocol Google Analytics untuk Google Analytics 4 tidak menampilkan kode error HTTP, meskipun peristiwa salah format atau tidak memiliki parameter yang diperlukan. 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 Pembuat Peristiwa GA4. Pembuat Peristiwa GA4 memungkinkan Anda membuat peristiwa secara interaktif, 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:

Respons validasi

Respons Server Validasi terhadap peristiwa sebelumnya ada di bawah:

{
  "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.