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

Learn about the Google Analytics Usage Trends Tool

The Google Analytics usage trend is a new tool which is used to visualise trends in your Google Analytics data and to perform trend analysis.


Do you want to Learn Web Analytics in 4 Weeks?

  • Learn and Master Web Analytics, Conversion Optimization & Google Analytics from Industry Expert in 4 weeks.
  • Lifetime access to the course + Lifelong FREE course updates.
  • New study material added every few months (lifelong learning).
  • Up to date training material.
  • Most exhaustive course on Google Analytics on the internet.
  • Hundreds of Assessments to test your learning.
  • Your 24/7, 365 days a year reference source.
  • Learn at your own pace and from any place.
  • Risk Free with 30 days 100% Money Back Guarantee.

Take your Analytics knowledge to the next level. Checkout my Best Selling Books on Amazon

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 eleven 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 three books:

error: Alert: Content is protected !!