Cylindo now offers an easy way to integrate with Google Analytics 4 through Google Tag Manager (GTM). Please keep in mind that GA4 is no longer compatible with Universal Analytics properties so in case you're still using legacy libraries such as analytics.js you will need to migrate your implementation.
Remember to add all variables that you create as custom dimensions or you will NOT be able to use that data in reports.
Google Tag Manager
1. Enable GA4 in your Cylindo Settings
2. Set up Google Tag Manager
Please refer to the attached PDF.
Note: Your Measurement ID can be found in your GA4, under Admin > Data Streams > Select your Data stream and you will be able to copy the Measurement ID.
3 . Confirm the integration is running smoothly through the correct Google data layer
Install the Google Analytics Debugger extension.
This extension adds a flag on each Google Analytics event to force its visibility in the DebugView from a Google Analytics 4 property.
Open the website where a HD 360 Viewer instance is displayed and GTAG/GTM is also enabled and start playing around with the viewer. Events should start displaying in the DebugView from Google Analytics 4.
If no events are showing, we recommend specifying the correct datalayer to send through. The `<cylindo-viewer>` will automatically attempt to send analytics data to GTM or GA4, if available on the PDP. If you have correctly set up GTM or GA4 on your website, the viewer will be able to send the data. You do not have to enable GA4 in your Cylindo settings.
Please note:
By default, the viewer will prioritize using Google Tag Manager (gtm.js) to send data;
We recommend that you add `analytics-mode` attribute on the `<cylindo-viewer>` component if you have both gtm and gtag on your website. Pass `analytics-mode="gtm"` or `analytics-mode="gtag"` to the `<cylindo-viewer>`.
If you want to disable the analytics altogether, pass `analytics-mode="none"` to the `<cylindo-viewer>`.
| Attribute | Default value | Options |
| `analytics-mode` | `auto` | `auto` | `gtag` | `gtm` | `none` |
Do not hesitate to contact our Support Team by emailing support@cylindo.com if you experience any issues.
4. Add Custom Dimensions in Google Analytics
This will allow you to report on all properties that are being tracked through GTM. Navigate to your Admin > Custom Definitions > Create custom dimensions. You may want to wait 24 hours after setting up GTM as you will see properties to select under the 'Event Parameter' dropdown. Below is an example of some of these properties set up.