For people who are already familiar with GA4. You can create a separate data stream for each tour or use one for all. You can create up to 50 data streams for 1 GA4 property. If you want your data to be completely separate, you can create a new property and data stream for each tour.

We recommend setting this up once the space is ready to be published.

In Google Analytics 4 :

1 – Cross domain settings

Edit your data stream and go to “Configure tag settings”. Select “Configure your domains”.

Enter all the domains where the tour will be loaded.

Add mpembed.com and any white label domain you have to get data from the tour.

This needs to be done on EACH new datastream.

2 – Custom definitions:

Go to admin and select your property. Go to Custom definitions and add the four following custom dimensions :

Dimension name	Scope	Event parameter
mpe_event_action	Event	event_action
mpe_event_category	Event	event_category
mpe_event_label	Event	event_label
mpe_event_value	Event	value

The dimension name can be changed, but the scope and event parameter must be identical to the values above (in bold). It is case sensitive.

This needs to be done once per property. It will affect all the data streams.

3 – Custom event:

In your data stream, create a custom event :

Custom event name : mpe_event

Matching condition

Parameter : even_name

Operator : equals

Value : mpe_event

The name can be changed, but the matching condition value must be exactly the same as above (in bold). It is case sensitive.

This needs to be done for each data stream.

4 – Internal traffic (optional)

You can block your internal traffic by IP range.

Go to your data stream. Click “Configure Tag Settings” -> “show all” -> “Define Internal Traffic”.

Enter the IP range that need to be filtered out. Example : 192.0.2.0/25

This needs to be done on EACH new datastream.

Data will start to appear in GA4 “realtime” in about two hours.

GA4 and Universal analytics can be used at the same time and both will track data. Universal analytics will be removed from MPEmbed on July 1^st 2023 at the same time Google retires it.

Universal Analytics (UA) vs Google Analytics 4 (GA4)

UA	GA4
Session based	Event based
Parameters : · Category · Action · Label · value	Default parameters: · language · page_location · page_referrer · page_title · screen_resolution Custom parameters (up to 25 custom) · event name · custom param 1 · custom param 2 · etc Name max 40 characters Value max 100 characters
Report under · Realtime · Behavior -> events	Reports under · Realtime · Engagement -> Events · Explorations
End of life July 1^st 2023 Access to data December 2023	Cross browsing for several domains.

Events collected in GA4 by default

Automatic

· session_start

· first_visit

· user_engagement (after 10 seconds or 2 page views or a conversion event)

Enhanced measurements (can be enabled / disabled)

· Page views

· Scrolls

· Outbound clicks

· Site search

· Form interactions

· Video engagement

· File downloads

Recommended events

A set of standard events on web sites. Need some custom code on the website.

See full list here https://support.google.com/analytics/answer/9267735

Custom events

User created events.

We need to create a custom event and three custom dimensions at minimum to catch the events in an MPEmbed tour.

After custom events are created, you need to create custom dimensions to see your data in your reports.

Configure -> custom definitions

Custom dimensions work across all datastreams in a single property. Custom events are assigned to each data stream individually.

Migration steps

Google analytics – Essential migration steps for Google Analytics 4

https://support.google.com/analytics/answer/10759417?hl=en

For users that are familiar with Tag Manager, they can use it to setup their GA4 account.

https://support.google.com/tagmanager/answer/9442095?hl=en

Step 1 (Skip if GA4 property already exists)

Add GA4 property.

To an existing Universal analytics property, read this guide.

https://support.google.com/analytics/answer/9744165#zippy=%2Cin-this-article

Step 2

Add data collection (make sure you have selected the new GA4 property, not the UA one)

https://support.google.com/analytics/answer/10110290?hl=en&utm_id=ad#instructions&zippy=%2Ccollect-website-and-app-data%2Cin-this-article

Step 3

Add a data stream (web) if one is not already there.

Use the address of your web site, not the MPembed link to your space.

You can create up to 50 data streams per property. If you want separate data per space, you can either create a new property or new data streams under the same property and use a different Measurement ID in the Premium interface for each space.

Step 4

Activate data collection by adding the measurement id to your MPEmbed space. Some setup is necessary in GA4.

How to set up GA4 for MPEmbed in Google Analytics

We recommend setting this up once the space is ready to be published.

In Universal Analytics, the data was always structured in the same way. In order to keep things simple, we will recreate a similar data structure. If you want your data to appear in your reports, you need to follow these steps.

GA4 and Universal analytics can be used at the same time and both will track data. Universal analytics will be removed from MPEmbed on July 1^st 2023 at the same time Google retires it.

1 – Cross domain settings

This needs to be done on EACH new datastream.

In order to capture all the data from your tour, wherever it is hosted, follow these steps:

Edit your data stream and go to “Configure tag settings”.

Select “Configure your domains”.

Enter all the domains where the tour will be loaded.

Add mpembed.com and any white label domain you have to get data from the tour.

For more information on cross domain tracking:

https://support.google.com/analytics/answer/10071811?hl=en

2 – Custom dimensions

This needs to be done once per property. Not for each datastream.

Go to your GA4 property, under Admin.

Go to Custom Definitions and create the following custom dimensions. The names and descriptions may be changed to your liking. The scope and event parameter needs to be exactly the same as the list below.

Dimension name	Scope	Event parameter
mpe_event_action	Event	event_action
mpe_event_category	Event	event_category
mpe_event_label	Event	event_label
mpe_event_value	Event	value

mpe_event_action contains the action the user has done or started such as clicked or loaded or guided tour.

mpe_event_category contains the section of MPEmbed that the user is in such as tour, mattertag directory or minimap.

mpe_event_label contains the category, the action and the label together to facilitate the viewing in reports. The label itself is the name/id of the tag or URL of the link that was clicked.

mpe_event_value usually contains only 1. In some specific cases related to media, it contains a number of seconds where the action has happened while playing the media. It is mostly unused for now.

A detailed list of events is at the end of this document.

For more information on custom dimensions :

https://support.google.com/analytics/answer/10075209?hl=en

3 – Custom event

This needs to be done on EACH new datastream.

Still in the GA4 admin section, go to Events

Click the “Create event” button on the right.

The name can be changed to your liking, the condition value must be exactly the same.

Custom event name : mpe_event

Matching condition

Parameter : even_name

Operator : equals

Value : mpe_event

Advanced users of GA4 can create various events with specific conditions and assign conversions to them.

For more information on custom events :

https://support.google.com/analytics/answer/12229021?hl=en

4 – Internal Traffic (optional)

To block your internal traffic from the data stream.

This step is not mandatory, but if you only want data from your customers, you can filter out a range of IP addresses to remove your interactions in the premium from the data.

Go to your data stream. Click “Configure Tag Settings” -> “show all” -> “Define Internal Traffic”.

Enter the IP range that need to be filtered out. Example : 192.0.2.0/25

This needs to be done on EACH new datastream.

For more information on internal traffic :

https://support.google.com/analytics/answer/10104470

5 – Reports

It takes a couple of hours before data starts coming in the Realtime section.

Data can be viewed under the Reports -> Realtime section

You can only see the data from the last 30 minutes in that report.

The events will appear in the bottom right section called Event count.

You can click mpe_event and drill down to view details.

The data will be recorded and you can view it the next day under the Reports section. Data will appear under Engagement -> Events

Filter the data with the dates in the top right. Click the arrow to select the date range.

Click the mpe_event to view all the unique event count in details with the categories, actions and labels.

If you want to filter the data you see on screen, you can click the “Add comparison” button on top.

If, for example you want to see just which tour was loaded and how many times, you select the mpe_event_label and you search the dimension values for the word “Loaded”.

Select all your tours and click ok. Then click apply.

You will then be able to see your full data on the left and your comparison on the right.

Note : It is possible to create comparisons between data streams if you filter by “Stream name”.

6 – Explorations

In the explore reports, there is a lot of events that display the “not set” label. All our events have a label (mpe_event_label), but the standard events from google do not have the mpe_event_label, resulting in all these “not set” events. They can be filtered out.

Here’s an example of exploration report.

Start with free form.

Pick a date range in the top left.

Click the plus sign near Dimensions and add at least the mpe_event_label.

Drag the mpe_event_label from the Dimensions to the Rows section.

Drag “Event count” and “Active users” from the Metrics under Values.

Finally, filter out the “not set” values.

Set the visualization or switch between them to see your data in various interesting ways.

How to set up in MPEmbed

Get your measurement id from Google Analytics.

Go to your GA4 property in Google Analytics and click Admin in the bottom of the left column.

Go to your Data stream in the Property column.

Select your data stream.

Grab the “Measurement id” in the first section by clicking on the copy button at the end.

Go to the MPEmbed premium interface and paste the code in the Analytics section.

Save and open the space (outside of the premium interface) and data collection begins.

Tracked events

Category	Action	Label
Tour	Loaded	Model Name (SpaceID)
Minimap	Click	Pano Number (To)
Mattertag Directory	Click	Tag Label (TagID)
Highlight	Click	Highlight Name
Fullscreen	Click	Enter
Fullscreen	Click	Exit
Minimap	Click	Minimize
Minimap	Click	Maximize
Minimap	Click	Hide
About Panel	Click	Less
About Panel	Click	More
About Panel	Click	Hide
About Panel	Click	Show
Mode	Changed	To
Floor	Changed	Floor ID (Floor Name)
Floor	Changed	Floor ID
Tags	Clicked	Tag Label (Tag ID)
Guided Tour	Started
Guided Tour	Stopped
Guided Tour	Ended
Guided Tour	Stepped	HighlightName (Index)
Confetti	Emote	Pano Number ( Label )
Move	Enter	Pano Number ( Label )
Mirror Mode	Enter	X & Y Axis
Mirror Mode	Enter	X Axis
Mirror Mode	Exit
Mirror Mode	Enter	Y Axis
Measurement Mode	Click	Entered
Measurement Mode	Click	Exited
Measurement Mode	Click	Exited
Tags	Edit	Tag Label (TagID)
Tags	Click	Tag Label (TagID)
Tags	Link Click	URL
Tags	Deep link in same space clicked	SS & SR Parameters
Tags	Different Space Link Clicked	URL
Tags	External Link Clicked	URL
Panel Tabs	Click	Panel Name
Copyright	Click	Link
Background Music	Click	Enabled / Disabled
Mattertags Toggle	Click	Enabled / Disabled
Snapshot	Click	Pano Label (Pano ID), snapshot size
VR mode	Click
Highlight Reel Media	Played	Media type (Source)