İsabetleri Doğrulama - Measurement Protocol

Bu belgede, Google Analytics Ölçüm Protokolü isabetlerinin nasıl doğrulanacağı açıklanmaktadır.

Genel bakış

Google Analytics Measurement Protocol, bir Measurement Protocol isabeti hatalı biçimlendirilmiş veya gerekli parametreler eksik olsa bile HTTP hata kodları döndürmez. İsabetlerinizin doğru biçimlendirildiğinden ve tüm gerekli parametreleri içerdiğinden emin olmak için bunları üretime dağıtmadan önce doğrulama sunucusuyla test edebilirsiniz.

Bu kılavuzda, Ölçüm Protokolü Doğrulama Sunucusu'na isabet gönderme süreci ve yanıtın nasıl yorumlanacağı açıklanmaktadır.

İsabetleri doğrulama için gönderme

İsabetler, şu anda Measurement Protocol tarafından desteklenen herhangi bir yöntem aracılığıyla Measurement Protocol Doğrulama Sunucusu'na gönderilebilir. Tek fark URL'dir. İsabetleri Measurement Protocol Doğrulama Sunucusu'na göndermek için /collect yerine /debug/collect uç noktasını kullanın. Aşağıdaki örnekte, Measurement Protocol Doğrulama Sunucusu'na gönderilen geçersiz bir isabet gösterilmektedir:

https://www.google-analytics.com/debug/collect?tid=fake&v=1

Measurement Protocol isabeti oluşturma hakkında daha fazla ayrıntı için protokol referansını inceleyin.

Yanıtı Yorumlama

Measurement Protocol Doğrulama Sunucusu'ndan gelen yanıtlar JSON biçiminde olacaktır. Aşağıdaki örnekte, yukarıda gösterilen isabetin yanıtı gösterilmektedir:

{
  "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"
        }
      ]
    }
  ]
}

Yanıt kökü (hitParsingResult), uzunluğu orijinal istekte gönderilen isabetlerin sayısına karşılık gelecek olan bir dizidir. Dizideki her nesne valid, hit ve parserMessage anahtarlarını içerir. Bir isabet geçersizse parserMessage, doğrulama sorunlarını açıklayan bir nesne dizisi içerir. İsabet geçerliyse parserMessage boş bir dizi olur.

Aşağıdaki tabloda hitParsingResult dizisindeki her bir öğenin özellikleri açıklanmaktadır:

Anahtar	Tür	Açıklama
`valid`	`Boolean`	Geçerli isabetler için `true`, geçersiz isabetler için `false`.
`hit`	`string`	İsteğin yöntemi ve protokolünün yanı sıra yolunu da içeren bir dize.
`parserMessage`	`Array`	Ayrıştırıcı iletilerinin listesi. İsabet geçerliyse bu dizi boş olur.
`parserMessage.messageType`	`string`	Olası değerler: "INFO", "WARN" ve "ERROR".
`parserMessage.description`	`string`	Doğrulama sorununu düzeltmeyle ilgili ek ayrıntılar veya adımlar.
`parserMessage.parameter`	`string\|undefined`	Doğrulama sorununa neden olan parametre (varsa).