Memvalidasi Hit - Measurement Protocol

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.

Builder Hit Measurement Protocol, alat yang memungkinkan Anda membuat dan memvalidasi hit Measurement Protocol secara interaktif, menggunakan server validasi ini.

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.

Penting: hit yang dikirim ke Server Validasi Measurement Protocol tidak akan muncul dalam laporan. Kolom tersebut hanya digunakan untuk proses debug.

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.