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
 

"How to use Digital Analytics to generate floods of new sales and customers"

(Even if you are completely new to Analytics)

 

What You’ll Learn On This FREE Web Class!

#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.

#5 How to learn and master digital analytics in record time.

 
 

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 !!