Google Analytics 4 Event Builder is a tool that allows users to create offline measurement protocol events and send this data to a Google Analytics 4 property.
So, let us understand what exactly measurement protocol events are and when to use them.
Using the Event Builder tool, you can send data to a Google Analytics 4 property from your own servers that are not part of HTML or other offline POS machines.
In the case of general analytics set up, Google Analytics tracking code is placed on every single page. When a user visits the page, it tracks the user journey with basic GA4 metrics (page view, bounce rate, user type, etc), whereas measurement protocol lets developers create HTTP post data requests and send this information to Google Analytics 4 servers. This way you can also track the user journey outside your website.
Now that we have understood the basics of Google Analytics 4 Event Builder, let’s see when to use this tool.
The GA4 Event Builder tool should be used when you have data that is offline and you want to send this data to Google Analytics.
Let’s take an example; you are a business owner for a retail company that is available both online and offline. You would like to understand the overall performance of the business. To do so, both online and offline sales should be considered.
In this case, you can use the Event Builder to send offline data to a Google Analytics 4 property. Now, that you have both online and offline data in Google Analytics, performance can easily be measured.
Overview of the GA4 Event Builder tool
Click on the following link to access the GA4 Event Builder tool: GA4 Event Builder
This tool consists of 2 main sections:
Hit summary
Event details
#1 Hit summary
This box displays the full event and validation status. Once you login into the tool, you will notice the image as shown below:
To send events to Google Analytics, an HTTP Post request should be made to the below endpoint.
POST /mp/collect HTTP/1.1 HOST: www.google-analytics.com
<payload_data>
In hit summary, you have controls as shown below and these details need to be provided for creating the events.
API secret: This is the required query parameter, which is generated using Google Analytics 4 UI. Follow the below steps to create an API secret key.
Note: you would need to create a Google Analytics 4 property in order to create an API secret key and measurement ID.
Steps to generate api_secret and measurement ID in a Google Analytics 4 property.
Step-1: Log in to your Google Analytics 4 property and then click on the ‘Admin’ link on the bottom left-hand side.
Step-2: Under the ‘Property’ column, click on ‘Data Streams’.
Step-3: Once you click on the data streams option from the property column, you will screen like below. You have an option to create a data stream for IOS, Android, and Web.
How to use Google Analytics 4 Event Builder 40
Step-4: Let’s create a web data stream for this example. Click on ‘Web’ to set up the data stream as shown below
Step-5: Provide a website URL and stream name to set up your web stream.
Step-6: Once the website URL and data stream name is provided, you will notice that the ‘Create stream’ button is highlighted. Click on ‘Create stream’.
Step-7: You will see a screen like the one below once the stream is created. This is where the measurement ID is created.
Step-8: To create an API secret key, scroll down and click on the ‘Measurement protocol API secrets’ in ‘Additional settings’.
Step-9: A new pop up will open when you click on ‘Measurement protocol API secrets’, you will see a ‘Create’ button as shown below:
Step-10: When you click on ‘Create’, you are asked to provide a nickname for the API secret.
How to use Google Analytics 4 Event Builder 41
Step-11: For example, let us give ‘offline data’ as a nickname for the API secret key and click on ‘Create’.
Step-12: A secret value is created which is used as a key to send the events using measurement protocol.
Steps to create Firebase APP ID in Firebase console
This is one of the required parameters which is an identifier for the Firebase app. This value is found in the Firebase console.
Step-1: Login to your Firebase console and click on ‘Project overview’ on the left-hand side.
Step-2: Click on the gear icon and select ‘Project settings’ as shown in the image below.
Step-3: You will now land on the ‘General’ tab in the selected project settings.
Step-4: Scroll down and you will notice the ‘Your apps’ section.
Step-5: As an example, let us select the web app to add to our project.
Step-6: You will see a form as shown below to add Firebase to your web app.
Step-7: Enter a nickname and click on ‘Register app’.
Note that you can also set up Firebase hosting which is free to get started.
Step-8: After registration is complete, an SDK will be created which has Firebase configuration information along with the app ID and measurement ID.
How to use Google Analytics 4 Event Builder 42
We have successfully created a measurement ID and an API secret key.
Let’s have a look at the other controls that are needed for creating an event in Event builder.
#Client ID: It is a required string-type query parameter, which uniquely identifies a user instance on the web.
#User ID: It is an optional query parameter, which is used to identify a user. User ID may include only UTF-8 characters.
# app_instance_id: This is one of the required parameters which uniquely identifies a specific installation of a Firebase app.
#timestamp_micros: It is an optional parameter This value should be in microseconds, not microseconds. This is the timestamp associated with the event.
#Category: Based on the type of event you want to send to your GA4 property,you can select from the drop-down as shown below.
#Name: Based on the category you select, you will see options to select for the name. For example, if you have selected the category as ‘retail’ you would see below options for the name.
#2 Event Details:
Step-1: Based on the category and name you select in the HIT summary section, you will see event parameters get populated automatically where values need to be filled by the user.
For example, if I select the category as Retail/Ecommerce and .ame as view_item, as shown below:
Step-2: You will see event parameters created, as shown below. Provide the values in the fields for item_id, item_name, etc.
Step-3: You have an option to add additional parameters from the buttons available.
Step-4: You can add additional user properties as well by clicking on the button as shown below:
How to create an event and send it to a Google Analytics 4 property
Now that we have understood the tool and its various controls, let’s go ahead and create a test event and validate it.
Step-1: Copy the measurement ID and API secret which we created and update the fields mentioned, as below:
Note: I have selected ‘Retail/Ecommerce’ as the category and the name is ‘view_item’
Step-2: Provide additional details in the ‘Items’ section. In our example, I have used the following details.
Step-3: Based on the values, the event payload is automatically created as shown below:
Step-4: Click on the ‘Validate event’ button which is highlighted after the event payload is created by the tool
Step-5: If the event is valid, you will see the status highlighted in green above the event payload as shown below:
Step-6: After the validation is completed, you will find the option to send the event to Google Analytics, as shown below:
Below is the example event payload, which we have created:
Frequently Asked Questions How to use Google Analytics 4 Event Builder
What is Google Analytics 4 event builder?
Google Analytics 4 Event Builder is a tool that allows users to create offline measurement protocol events and send this data to a Google Analytics 4 property. Using the Event Builder tool, you can send data to a Google Analytics 4 property from your own servers that are not part of HTML or other offline POS machines.
In the case of a general analytics setup, a Google Analytics tracking code is placed on every single page. When a user visits the page, it tracks the user journey with basic GA4 metrics (page view, bounce rate, user type, etc), whereas measurement protocol lets developers create HTTP post data requests and send this information to Google Analytics 4 servers. This way you can also track the user journey outside your website.
When do we use Google Analytics 4 Event Builder?
The GA4 Event Builder tool should be used when you have data that is offline and you want to send this data to Google Analytics.
Let’s take an example; you are a business owner for a retail company that is available both online and offline. You would like to understand the overall performance of the business. To do so, both online and offline sales should be considered.
In this case, you can use the Event Builder to send offline data to a Google Analytics 4 property. Now, that you have both online and offline data in Google Analytics, performance can easily be measured.
What is measurement protocol (Google Analytics4)?
The Google Analytics measurement protocol for GA4 allows developers to send an event to GA4 property using “HTTP” requests. This allows them to track users from any “HTTP-enabled” environment like sending data from offline sales that happened at the store and measure interaction at the client-side and server-side as well.
Register for the FREE TRAINING...
"How to use Digital Analytics to generate floods of new Sales and Customers without spending years figuring everything out on your own."
Here’s what we’re going to cover in this training…
#1 Why digital analytics is the key to online business success.
#2 The number 1 reason why most marketers are not able to scale their advertising and maximize sales.
#3 Why Google and Facebook ads don’t work for most businesses & how to make them work.
#4 Why you won’t get any competitive advantage in the marketplace just by knowing Google Analytics.
#5 The number 1 reason why conversion optimization is not working for your business.
#6 How to advertise on any marketing platform for FREE with an unlimited budget.
#7 How to learn and master digital analytics and conversion optimization 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 BeyondSECOND EDITION OUT NOW!
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.
About the Author
Himanshu Sharma
Founder, OptimizeSmart.com
Over 15 years of experience in digital analytics and marketing
Author of four best-selling books on digital analytics and conversion optimization
Nominated for Digital Analytics Association Awards for Excellence
Runs one of the most popular blogs in the world on digital analytics
Consultant to countless small and big businesses over the decade
Learn and Master Google Analytics 4 (GA4) - 126 pages ebook
We use cookies on our website to give you the most relevant experience by remembering your preferences and repeat visits. By clicking “Accept”, you consent to the use of ALL the cookies.
This website uses cookies to improve your experience while you navigate through the website. Out of these, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may affect your browsing experience.
Necessary cookies are absolutely essential for the website to function properly. These cookies ensure basic functionalities and security features of the website, anonymously.
Cookie
Duration
Description
cookielawinfo-checkbox-analytics
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Analytics".
cookielawinfo-checkbox-functional
11 months
The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional".
cookielawinfo-checkbox-necessary
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary".
cookielawinfo-checkbox-others
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Other.
cookielawinfo-checkbox-performance
11 months
This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance".
viewed_cookie_policy
11 months
The cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.
Functional cookies help to perform certain functionalities like sharing the content of the website on social media platforms, collect feedbacks, and other third-party features.
Performance cookies are used to understand and analyze the key performance indexes of the website which helps in delivering a better user experience for the visitors.
Advertisement cookies are used to provide visitors with relevant ads and marketing campaigns. These cookies track visitors across websites and collect information to provide customized ads.
Analytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics the number of visitors, bounce rate, traffic source, etc.