Creating and validating measurement protocol requests through postman

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 send payload data both via GET and POST methods and how to send multiple hits in a single protocol requests.

Creating measurement protocol request

The GA measurement protocol hit builder allows you to send payload data only via POST method. It won’t let you send payload data via GET method.

It does not allow you to send multiple hits in a single protocol requests. And above all, it does not provide you the actual code for creating the protocol request.

You can overcome these limitations, by using the Postman chrome extension.

Through Postman extension, you can:

  • Send payload data both via GET and POST method.
  • Send multiple hits in a single protocol requests.
  • Create the actual code, for creating the measurement protocol request.

In order to understand the usage of this tool, let us try to achieve, following 3 objectives:

  1. Send single event hit in protocol request using the GET method
  2. Send single event hit in protocol request using the POST method
  3. Send multiple event hits in the protocol request using the POST method.

 

#1 Sending single event hit in protocol request using the GET method

Follow the steps below:

Step-1: Install the postman chrome extension and then launch it.

Step-2: Append the transport https://www.google-analytics.com/collect? with your payload data. For example:

If your payload data is:

v=1&t=event&tid=UA-1500844-18&cid=98880ed4-c224-4b3c-b2e2-35a491373751&ec=videos-10&ea=play&el=spider%2520man1&ev=100

Then after appending it with the transport: https://www.google-analytics.com/collect? , it will look like the one below:

https://www.google-analytics.com/collect?v=1&t=event&tid=UA-1500844-18&cid=98880ed4-c224-4b3c-b2e2-35a491373751&ec=videos-10&ea=play&el=spider%2520man1&ev=100

Step-3: Select GET method from the drop down menu and then copy-paste your transport and payload data into the text box (next to the drop down menu) as shown below:

postman get

Step-4: Click on the send button (show above).

Step-5: Navigate to Real Time > Events report in Google Analytics to see the event data:

real time report

Step-6: Click on the ‘Generate Code’ link in postman tool:

generate code

Step-7: Select the programming language, you want to use for creating the measurement protocol request:

select language

Through postman you can generate code in several languages including: Go, JavaScript, PHP, Python, Ruby etc.

For example, following is the code for generating measurement protocol request in JQuery:

generate code snippet

var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://www.google-analytics.com/collect?v=1&t=event&tid=UA-1500844-18&cid=98880ed4-c224-4b3c-b2e2-35a491373751&ec=videos-10&ea=play&el=spider%252520man1&ev=100",
  "method": "GET",
  "headers": {
    "cache-control": "no-cache",
    "postman-token": "cc64366c-34a2-3a5d-656c-a0243cee3881"
  }
}

$.ajax(settings).done(function (response) {
  console.log(response);
});

 

Step-8: Copy this code and send it your web developer for implementation.

That’s how you can send single event hit in measurement protocol request using the GET method

 

#2 Sending single event hit in measurement protocol request using the POST method

To send an event hit via POST method, just select POST from the drop down menu of postman tool:

post method

var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://www.google-analytics.com/collect?v=1&t=event&tid=UA-1500844-18&cid=98880ed4-c224-4b3c-b2e2-35a491373751&ec=videos-10&ea=play&el=spider%252520man1&ev=100",
  "method": "POST",
  "headers": {
    "cache-control": "no-cache",
    "postman-token": "d935a8a7-41dd-15f4-ddb0-17c910c96819"
  }
}

$.ajax(settings).done(function (response) {
  console.log(response);
});

The rest of the process, of sending the event hit data is same as in the case of GET method.

 

#3 Sending multiple event hits in the measurement protocol request using the POST method.

Follow the steps below:

Step-1: Select POST from the drop down menu of postman tool:

post method

Note: Do not use GET method for sending multiple hits in a single protocol request. It won’t work.

 

Step-2: Enter the transport https://www.google-analytics.com/batch? in the text box, next to the drop down menu, as shown below:

mutiple hits1

Step-3: Click on the ‘Body’ link (shown above) and then the ‘raw’ button (shown below), and then enter your payload for each hit, each payload on its own line:

mutiple hits2

Step-4: Click on the send button (show above).

Step-5: Navigate to Real Time > Events report in Google Analytics to see the event data. You will see three event hits at the same time in real time reports:

three events

Step-6: Click on the ‘Generate Code’ link in postman tool, select the programming language, you want to use for creating a measurement protocol request, copy this code and send it your web developer for implementation.

For example, following is the code for generating multiple hits, in a single measurement protocol request using JQuery:

var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://www.google-analytics.com/batch",
  "method": "POST",
  "headers": {
    "cache-control": "no-cache",
    "postman-token": "0a0530d3-b7de-f031-0911-d28c10c28534"
  },
  "data": "v=1&t=event&tid=UA-1500844-18&cid=98880ed4-c224-4b3c-b2e2-35a491373751&ec=videos-1&ea=play&el=spider%2520man1&ev=100\r\nv=1&t=event&tid=UA-1500844-18&cid=98880ed4-c224-4b3c-b2e2-35a491373751&ec=videos-2&ea=play&el=spider%2520man2&ev=100\r\nv=1&t=event&tid=UA-1500844-18&cid=98880ed4-c224-4b3c-b2e2-35a491373751&ec=videos-3&ea=play&el=spider%2520man3&ev=100\r\n"
}

$.ajax(settings).done(function (response) {
  console.log(response);
});

That’s how you can send multiple hits in a single measurement protocol request using the POST method.

 

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. Understanding measurement protocol validation server

Do you want to Learn and Master Web Analytics in 8 Weeks?

I get dozens of emails every week from people asking for career advice in web analytics.

The questions range from ‘where do I start?’, ‘which books should I read?’, ‘how do I prepare for GAIQ?’ to how do I become a good analyst?

So I thought why not dedicate a whole video on answering these burning questions.

Here is what we are going to cover, in the next few minutes, in this video lesson:

#1 Who am I? What’s my story and why you should listen to me?

#2 The number 1 reason, why most marketers and business owners are not able to scale their advertising and maximize sales for themselves and/or for their clients.

#3 How in just couple of years, I went from a complete novice in web analytics to the author of three best selling books on web analytics? And how you can achieve the same transformation in your career and that too in much shorter time frame.

#4 What is the difference between web analytics and Google Analytics?

Join the Course

Take your analytics knowledge to the next level. Check out my best selling books on Amazon

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

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.

Himanshu Sharma

Certified web analyst and founder of OptimizeSmart.com

My name is Himanshu Sharma and I help businesses find and fix their Google Analytics and conversion issues. If you have any questions or comments please contact me.

  • Over twelve years' experience in SEO, PPC and web analytics
  • Google Analytics certified
  • Google AdWords certified
  • Nominated for Digital Analytics Association Award for Excellence
  • Bachelors degree in Internet Science
  • Founder of OptimizeSmart.com and EventEducation.com

I am also the author of four books:

error: Alert: Content is protected !!