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