Setting up Google Analytics
You can track traffic and activity on your map through your own analytics setup. Interactive Maps support both Google Analytics and Google Tag Manager (GTM), giving you two ways to collect and manage your data:
Google Analytics Measurement ID (recommended) – Most clients use GA4 so they can take advantage of Concept3D’s preset custom events and analytics tracking.
Google Tag Manager Container ID – For advanced users who want full control over their analytics setup. Using only GTM means you will no longer receive Concept3D’s built-in events; all tracking will be managed by you in GTM.
Note: Using both GTM and GA4 may result in duplicate data.
Option 1: Add Your Google Analytics Measurement ID (Recommended)
Log into the CMS.
Click the blue Options tab.
Find the field for Google Analytics.
Enter your GA4 Measurement ID (format:
G-XXXXXXXX).Save and publish your changes.
- It may take up to 24 hours for Google Analytics to begin propagating in your account.
Note: Universal Analytics is no longer supported. If you have not already done so, update to GA4 before adding your ID. It may take up to 24 hours for analytics data to appear in your account.
Example of CMS Options tab where you enter your Google Analytics Measurement ID
Option 2: Add Your Google Tag Manager Container ID
If you prefer to manage all of your analytics independently, you can add your GTM Container ID in the CMS:
Log into the CMS.
Click the blue Options tab.
Find the field for Google Tag Manager Container ID (next to the Google Analytics field).
Enter your Container ID (format:
GTM-XXXXXXX).Save and publish your changes.
Important: If you use GTM without also adding a GA4 ID, you are responsible for setting up and managing all event tracking in GTM. Concept3D’s out-of-the-box custom events will no longer apply.
Example of CMS Options tab where you enter your Google Analytics Measurement ID
Helpful Hint!
Here is a great blog post for additional information on users, pageviews, and sessions when reviewing your Google Analytics.
Where to find your Google Analytics ID
Google Analytics 4 Events
What information is included with custom events?
When your map sends a custom event to Google Analytics 4 (GA4), it includes a few helpful details to give you more context about user activity:
-
Event category
Identifies which map the event came from. This will typically appear as Map {mapId}. -
Event label
Provides additional details about the action, such as search terms or button interactions. This may not be included in every event. -
Event URL
Shows the page where the event occurred. In some cases, such as category links, this may reflect a more specific URL. -
Is logged in
Indicates whether the user was logged in at the time of the event.
Automatic GA4 events
In addition to Concept3D’s custom events, Google Analytics 4 (GA4) automatically tracks standard events on your map pages.
These events are not specific to Concept3D, but they help you understand general user behavior:
| Event | What it means |
|---|---|
| page_view | The map page has loaded |
| session_start | A new session has started |
| first_visit | The user’s first visit to your site (based on GA4 rules) |
| click | A user clicks a link, including outbound links (if enabled) |
| file_download | A file download is detected |
| scroll | The user scrolls within a scrollable area (like a sidebar) |
| user_engagement | The page is actively in use (not in a background tab) |
Note: Exact behavior may vary depending on your GA4 setup, tags, and Enhanced Measurement settings.
UTM parameters on map URLs
UTM codes let you attribute traffic to campaigns. Standard parameters include source, medium, campaign, term, and content.
For interactive maps that use URL hashes, place UTM (and other campaign) query parameters before the hash in the URL so they are parsed reliably.
Example:https://map.example.com/?utm_source=newsletter&utm_medium=email#/m/12345
Concept3D Custom Events by Feature Area
Concept3D also tracks custom events tied to specific map features and user interactions. You can find these event names in GA4 (for example, in Explore → Events).
Map and map controls
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Map Engagement | Map Engagement | First pan or zoom interaction after the map loads (once per visit). |
| Home | Clicked | User resets to the initial view (home control). |
| Floor Selector | Level or +1 / −1 | Floor or level changes. |
| Rotate Map | Clicked | Map rotation control (if multiple rotations is enabled on OSM maps). |
| Toggle Pitch | Control label | 2D / 3D pitch toggle (if functionality exists on the map) |
| Switch Map Type | View name | Map type control (e.g. map vs satellite, depending on configuration). |
| Switch Base Layer | Layer value | Base layer change. |
| Streetview | clicked | Street View opened (Google-based maps). |
| Get This View | clicked | “Get this view” / share-current-view style control. (Global Share) |
| Inactive Map | Status string | Map load when status is inactive or deleted (diagnostic). |
Categories and sidebar
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Category View | Category name | Category opened from sidebar or direct URL. |
| Category On | Category name | Category enabled in the location sidebar. |
| Category Zoom | Zoom level (number) | Category enabled and map zooms toward the category view. |
| Category Expanded | Category name | Category expanded in the sidebar. |
| Sidebar Tab | Tab name | Switching sidebar tabs (e.g. Locations, Tours, Transit — labels depend on your map). |
| Sidebar Menu | Label | Sidebar / hamburger menu interaction. |
Search
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Search | Search query | User runs a search. |
| Open Directions | Main. May also fire with a Transit-specific label when transit is enabled. | Opens directions from search bar. |
Locations, balloons, and markers
| Event name | Typical label / notes | Extra parameters (when sent) | When it fires |
|---|---|---|---|
| Marker Open | Location name |
marker_id; location_name
|
Location opens in sidebar or balloon |
| Marker Zoom | Zoom value | marker_id |
Opening a location and the map zooms to it. |
| Tour Stop View | Tour and stop name | tour context may include tour_name, tour_stop_name, |
Viewing a stop within an active tour. |
| Maximize Location | Balloon title or Mobile/Desktop |
marker_id (toggle flows) |
Restore or toggle balloon size. |
| Minimize Location | Mobile / Desktop | marker_id |
User collapses balloon from expanded state or URL/hash-driven. |
| Open Directions | Location name, Mobile Bar, Transit Balloon, etc. |
marker_id (balloon/transit) |
Opens directions from balloon, mobile bar, transit, etc. |
| Close Directions | Often omitted | — | Closes directions (several UI entry points). |
| Select Location Share | Location name |
event_url, map_id, event_category, event_location, marker_id when available |
User opens share from a location balloon. |
| Location Details | Information | — | Information section on a balloon. |
| Pop Up Close | Context string | — | Generic popup closed. |
| Tour Exit | Tour and stop | — | Exits a tour from the balloon flow. |
Tours
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Tour Play | Label | User opens or plays a map tour. |
| Tour Next / Tour Prev | Stop name | Navigation between tour stops. |
| External Tour Open | Tour name | Opens a linked / external tour from category navigation. |
| Form Open / Form Submit / Form Close | Tour or form name | Tour lead capture forms. |
Directions and Wayfinding
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Get Directions | Often omitted | User requests directions (core flow). |
| Set Directions Start Point | Place name | Start point set. |
| Set Directions End Point | Place name | End point set. |
| Set Directions Type | Mode string | Transportation / routing mode. |
| Drop Direction Pins | — | Desktop: drop pins for routing. |
| Get Directions via Drop Pins | — | Mobile drop-pin flow. |
| Begin Directions Route | — | Mobile: route navigation started. |
| In Person Directions | — | Mobile: “my location” style follow-along when starting route. |
| Navigate Direction Steps | Begin / Next / Prev / step name | Stepping through the route. |
| Directions Ended | — | Mobile: user reaches the last step. |
| View Directions Steps | Route Summary / Options | Mobile route summary or options. |
| Open Directions Options | — | Mobile directions options. |
| Exit Directions | — | Mobile: exit directions. |
| Edit Directions | — | Mobile: edit route. |
| Open Directions Help / Close Directions Help | — | Mobile help panel. |
| Print Directions | — | Print directions. |
| View Directions Full Route | — | Full route view. |
| Recalculate Route | — | Reroute. |
| Share Directions | — | Share directions (share control). |
| Toggle Wheelchair Wayfinding | Status string | Accessible / wheelchair routing toggle. |
Share, links, and QR
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Share |
name: type or QR-related label |
Share actions including QR where configured. |
| Copy Share Url | name: link |
User copies a share link. |
| Copy Embed Code | name: embed |
User copies embed code. |
| Share link opened | Omitted | URL/hash indicates a share link was opened. |
| QR opened | Omitted | URL/hash indicates QR flow. |
| Shared Place Opened | Type: … |
Shared place deep link opened. |
Header, links, and print (core map)
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Map View Button | Link or option name | Header or mobile map links. |
| Logo Click | Logo URL | Header logo link. |
| Print Map | Opened | Print experience opened from the map. |
| Accept Cookies | clicked | User accepts the cookie policy. |
Gallery and media
| Event name | Typical label / notes | Extra parameters | When it fires |
|---|---|---|---|
| Media Gallery Interaction | Tab name, Prev Media, Next Media |
location_name, marker_id when available |
Gallery tabs or prev/next. |
| MediaType Loaded | Location name | marker_id |
Example names: Image Loaded, Video Loaded, Panorama Loaded — depends on media type. |
Account and profile
| Event name | Typical label / notes | Extra parameters | When it fires |
|---|---|---|---|
| Login Click | Sign In | — | Sign-in started. |
| Login Success |
button or auto
|
login_trigger |
Successful login (button vs SSO/auto). |
| Auth Detected | Session Resumed | — | Already authenticated from a prior session. |
| Open Profile | Profile | — | Profile opened. |
| Logout | Sign Out | — | User signs out. |
Mobile bar and navigation
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Mobile Tab | Tab title (Sign In, Profile, My Places, More, Map Links, etc.) | Mobile bar and related navigation. |
My Places (saved places)
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Add a Place Selected | My Places / Map Controls | Starts add-place flow. |
| Select Place Type | Save parking spot / Save custom location | Chooses what to save. |
| Parking Spot Saved / Custom Location Saved | Varies | After a successful save. |
| My Places Viewed | N items shown |
My Places list displayed. |
| Custom Place Opened | Parking / Location | Open a saved place. |
| Custom Place Directions / Share | Place type | From a saved place. |
| Custom Place Deleted / Replaced | Type | Delete or replace saved data. |
| Shared Place Saved | Place type | Save a shared place into My Places. |
Print Map extension
When the Print Map extension is enabled:
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Print Map | Generate Print Map 3.0 | Generating a print map. |
| Print Map Attribute | Page Size, File Type, Orientation, etc. | Each selected print option. |
| Print Map | GET URL of Print Map Request - … | Technical logging for print URL request. |
View Full Page Details (Space Planner) Feature
When MapSpacer is enabled:
| Event name | Typical label / notes | When it fires |
|---|---|---|
| Open Room Details | {name} Full Page |
Full room / event space details view opens. |
| Select Breakout Space | Space … |
Breakout space selected (can align with opening room details). |
| Select Full Room | Space … |
Full room selection from MapSpacer balloon. |
| Find an Event Space | Opened, search messages, result counts | Event space search UI and results. |
| Request for Proposal | RFP Started / Next / Submitted | RFP workflow. |
| Gallery | MapSpacer - Media / Exploring content / Back to map | MapSpacer gallery interactions. |
| Common Model Download / SketchUp Model Download / SketchUp Extension Download | Model or file context | Downloads from MapSpacer content. |