Understanding measurement protocol validation server

 

This article is related to measurement protocol in Google Analytics.

If you are brand new to measurement protocol, then read this article first: Understanding Google Analytics measurement protocol.

In this article, I will show you, how to validate protocol hits by sending them to the measurement protocol validation server.

You can access the validation server via:

To access the validation server directly use the /debug/collect endpoint

Through this end point you can send hit data to the measurement protocol validation server instead of the GA server.

For example:

User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/30.0.1599.69 Safari/537.36

POST https://www.google-analytics.com/debug/collect?v=1&t=pageview&tid=UA-1029844-34&cid=c461d1ba-d341-499f-bc9e-673b67f2aa18&dh=mydemo.com&dp=%2Fhome&dt=testing%20page%20tracking

 

Understanding responses from Validation Server

When you send a hit to the measurement protocol validation server, the server will send you a response but that response will be in JSON format.

JSON, or JavaScript Object Notation is a language independent and light weight data exchange format, which is used to store and exchange data.

Following is an example of a response from measurement protocol validation server:

{

  “hitParsingResult“: [ {

    “valid”: true,

    “parserMessage“: [ ],

    “hit“: “/debug/collect?v=1\u0026t=pageview\u0026tid=UA-1009844-34\u0026cid=c461d1ba-d341-499f-bc9e-673b67f2aa18\u0026dh=mydemo.com\u0026dp=%2Fhome\u0026dt=testing%20page%20tracking”

  } ],

  “parserMessage”: [ {

    “messageType”: “INFO”,

    “description”: “Found 1 hit in the request.”

  } ]

}

Here hitParsingResult is an array and ‘valid‘, ‘parserMessage‘ and ‘hit‘ are the objects of this array.

Here the value of ‘valid‘ key is ‘true’. What that means, the hit is valid.

If the value of ‘valid’ key was ‘false’ then it would have meant, the hit is invalid.

When a hit is invalid, you can then get more details about the error through following parserMessage keys:

  1. messageType
  2. description
  3. messageCode
  4. parameter

For example, following is a response from measurement protocol validation server for an invalid hit:

{

  “hitParsingResult”: [ {

    “valid”: false,

    “parserMessage”: [ {

      “messageType”: “ERROR“,

      “description“: “The value provided for parameter ‘tid’ is invalid. Please see http://goo.gl/a8d4RP#tid for details.”,

      “messageCode“: “VALUE_INVALID”,

      “parameter”: “tid”

    } ],

    “hit”: “/debug/collect?v=1\u0026t=pageview\u0026t=event\u0026tid=1000844-34\u0026cid=c461d1ba-d341-499f-bc9e-673b67f2aa18\u0026dp=%2Fhome\u0026dt=testing%20page%20tracking”

  } ],

  “parserMessage”: [ {

    “messageType”: “INFO”,

    “description”: “Found 1 hit in the request.”

  } ]

}

Here the value of the ‘valid’ key is false and the value of the ‘messageType’ is ‘ERROR’. From these two values, we can conclude that the hit is invalid.

In order to get more details about the nature of the error, look at the values of various ‘parserMessage’ keys: ‘description’, ‘messageCode’ and ‘parameter’.

From the ‘description’ key, we can conclude that, the value provided for parameter ‘tid’ in the payload data is invalid and because of this reason, the hit is invalid. If we provide correct value to the ‘tid’ parameter, then hit will become valid.

This is the kind of insight you can get, by reading the responses from validation server.

Note: If you are sending hits to validation server then they won’t show up in your Google Analytics reports.

The easiest way to view the response sent by measurement protocol validation server, is by copy-pasting the transport and payload data into the address bar of your browser window:

measurement-protocol-validation-server

Here, I have copy-pasted the following transport and payload data into the address bar of my browser window:

https://www.google-analytics.com/debug/collect?v=1&t=pageview&tid=UA-1000844-34&cid=c461d1ba-d341-499f-bc9e-673b67f2aa18&dh=mydemo.com&dp=%2Fhome&dt=testing%20page%20tracking

 

Other articles on measurement protocol

  1. Sending pageview data via measurement protocol in Google Analytics
  2. Sending campaign data via measurement protocol in Google Analytics
  3. Sending event data via measurement protocol in Google Analytics
  4. Sending ecommerce data via measurement protocol in Google Analytics
  5. Sending social interactions via measurement protocol in Google Analytics
  6. Creating and validating measurement protocol requests through postman
 

How to use Digital Analytics to generate floods of new sales and customers for your business

(Even if you are completely new to Digital Analytics)

Here’s What We’re Going To Cover…

#1 - The number 1 reason why most marketers and business owners are not able to scale their advertising and maximise sales. 

#2 - Why you won’t get any competitive advantage in the marketplace just by knowing Google Analytics. 

#3 - The number 1 reason why conversion optimization is not working for your business. 

#4 - How to advertise on any marketing platform for FREE with an unlimited budget.

 

Register for free training

 

My best selling books on Digital Analytics and Conversion Optimization

Maths and Stats for Web Analytics and Conversion Optimization
This expert guide will teach you how to leverage the knowledge of maths and statistics in order to accurately interpret data and take actions, which can quickly improve the bottom-line of your online business.

Master the Essentials of Email Marketing Analytics
This book focuses solely on the ‘analytics’ that power your email marketing optimization program and will help you dramatically reduce your cost per acquisition and increase marketing ROI by tracking the performance of the various KPIs and metrics used for email marketing.

Attribution Modelling in Google Analytics and Beyond
Attribution modelling is the process of determining the most effective marketing channels for investment. This book has been written to help you implement attribution modelling. It will teach you how to leverage the knowledge of attribution modelling in order to allocate marketing budget and understand buying behaviour.

Attribution Modelling in Google Ads and Facebook
This book has been written to help you implement attribution modelling in Google Ads (Google AdWords) and Facebook. It will teach you, how to leverage the knowledge of attribution modelling in order to understand the customer purchasing journey and determine the most effective marketing channels for investment.

Himanshu Sharma

Digital Marketing Consultant and Founder of Optimizesmart.com

Himanshu helps business owners and marketing professionals in generating more sales and ROI by fixing their website tracking issues, helping them understand their true customers purchase journey and helping them determine the most effective marketing channels for investment.

He has over 12 years experience in digital analytics and digital marketing.

He was nominated for the Digital Analytics Association's Awards for Excellence.

The Digital Analytics Association is a world renowned not-for-profit association which helps organisations overcome the challenges of data acquisition and application.

He is the author of four best-selling books on analytics and conversion optimization:

error: Alert: Content is protected !!