Dokumen ini menjelaskan cara memvalidasi hit Measurement Protocol Google Analytics.
Ringkasan
Measurement Protocol Google Analytics tidak menampilkan kode error HTTP, meskipun jika hit Measurement Protocol salah format atau tidak memiliki parameter yang diperlukan. Untuk memastikan hit Anda diformat dengan benar dan berisi semua parameter yang diperlukan, Anda dapat mengujinya terhadap server validasi sebelum men-deploy-nya ke produksi.
Panduan ini menjelaskan proses pengiriman hit ke Server Validasi Measurement Protocol dan menjelaskan cara menafsirkan respons.
Mengirim hit untuk validasi
Hit dapat dikirim ke Server Validasi Measurement Protocol melalui
metode apa pun yang saat ini didukung oleh Measurement Protocol. Satu-satunya
perbedaan adalah URL. Untuk mengirim hit ke Server Validasi Measurement Protocol, gunakan endpoint /debug/collect
, bukan
/collect
. Contoh berikut menunjukkan hit tidak valid yang dikirim ke
Server Validasi Measurement Protocol:
https://www.google-analytics.com/debug/collect?tid=fake&v=1
Untuk detail selengkapnya tentang cara membuat hit Measurement Protocol, lihat referensi protokol.
Menafsirkan Respons
Respons dari Server Validasi Measurement Protocol akan berformat JSON. Contoh berikut menunjukkan respons untuk hit yang ditampilkan di atas:
{ "hitParsingResult": [ { "valid": false, "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1", "parserMessage": [ { "messageType": "ERROR", "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.", "parameter": "tid" }, { "messageType": "ERROR", "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.", "parameter": "tid" } ] } ] }
Root respons, hitParsingResult
, adalah array yang panjangnya akan sesuai dengan jumlah hit yang dikirim dalam permintaan asli.
Setiap objek dalam array akan berisi kunci valid
, hit
, dan parserMessage
. Jika hit tidak valid, parserMessage
akan berisi array objek yang menjelaskan masalah validasi. Jika hit valid, parserMessage
akan berupa array kosong.
Tabel berikut menjelaskan properti setiap item dalam array hitParsingResult
:
Kunci | Jenis | Deskripsi |
---|---|---|
valid |
Boolean |
true untuk hit valid, false untuk hit tidak valid. |
hit |
string |
String yang berisi jalur permintaan serta metode dan protokolnya. |
parserMessage |
Array |
Daftar pesan parser. Jika hit valid, array ini akan kosong. |
parserMessage.messageType |
string |
Nilai yang mungkin adalah "INFO", "WARN", dan "ERROR". |
parserMessage.description |
string |
Detail atau langkah-langkah tambahan untuk memperbaiki masalah validasi. |
parserMessage.parameter |
string|undefined |
Parameter (jika ada) yang menyebabkan masalah validasi. |