Sending Widget Events to Google Analytics

Learn how to integrate your Reteno forms with Google Analytics.

You can send the event data related to the interaction of users with your Reteno widgets to your Google Analytics (GA) account.

Reteno supports the Universal Analytics and Google Analytics 4 scripts for tracking events on your website. You have to install the script, using one of the following methods:

📘

Important

It is recommended to install the Google Analytics 4 script, since the Google Universal Analytics property will stop processing data starting on July 1, 2023 (July 1, 2024, for Analytics 360 properties).

After that, you have to enable exporting the widget event data to Google Analytics.

Setting Up GA4 Script for a Website

To set up the Google Analytics GA4 script for a website:

  1. In your GA account, select the Admin icon to open the GA settings.
GA settings
  1. Click CreateProperty.
Create property
  1. In the Property setup, enter the property name, select the country, the time zone and the currency, then click Next.
Property setup
  1. Describe your business — indicate the industry category and company size.
Business information

Choose your business objectives and click Create.

Choose your business objectives
  1. Select the Web platform in the property menu.
Data streams
  1. Enter the website URL and the stream name in the corresponding boxes, then click Create stream.
Create stream
  1. Go to the Web stream details and click the copy icon beside the Measurement ID.
Measurement ID.
  1. Go to your site and insert the following code after the tag, where substitute MEASUREMENT_ID with the one copied in the previous step.
<!-- Google Analytics -->
   <!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id={MEASUREMENT_ID}"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', '{MEASUREMENT_ID}');
</script>

Setting Up GA4 with GTM

Before proceeding to setting up GA4 with GTM, you have to:

  1. Create a GTM account and a container following these instructions.
  2. Follow the GTM standard web page installation instructions.

To set up Google Analytics 4 (GA4) with Google Tag Manager (GTM):

  1. Follow steps 1 to 6 described in Setting up GA4 script for a website section.
  2. In Tag Manager, select Tags in the left-hand side menu and click New to create a new tag.
Tag Manager
  1. Set the following tag configuration and triggering, then click Save:
  • Select Google Analytics: GA4 Event as Tag Type.
  • Use the measurement ID copied in step 7 of this instruction.
  • Select All pages for Firing Triggers.
Tag configuration
  1. In the left-hand side menu, select Triggers and then New to create a new trigger.
Create a new trigger
  1. In the slideout window, enter the trigger name and click the Trigger Configuration pane.
Trigger configuration
  1. Set the following configuration in the trigger configuration window:
  • Select Custom Event as the trigger type.
  • Enter reteno as the event name.
  • Select All Custom Events for the trigger to fire on.
All custom events
  1. Go to Variables in the left-hand side menu, and select New in the User-Defined Variables pane.
Variables
  1. In the slide-out window, enter configuration name and click the Variable Configuration pane.
Variable Configuration
  1. In the slide-out window, set the following parameters, then click Save:
  • Variable Type
  • Data Layer Variable Name
  • Data Layer Version
Variable configuration

You have to create the 3 variables with the following parameters:

Variable TypeData Layer Variable NameData Layer Version
Data Layer VariableeventActionVersion 2
Data Layer VariableeventCategoryVersion 2
Data Layer VariableeventLabelVersion 2
  1. Go to Tags in the left-hand side menu, and create a new tag with the following configuration, then click Save:
  • Select Google Analytics: GA4 Configuration as Tag Type.
  • Select the tag you created at step 3 in Configuration Tag.
  • Enter reteno as the event name.
  • In Event Parameters, use the parameters and their values created in steps 8 and 9.
  • In Firing Triggers, select Reteno event.
Tag configuration
  1. Click Submit on the top panel.
Save settings

Enabling Widget Event Data Exporting to GA

To enable the widget event data transfer:

  1. In your Reteno account, click Site — Widgets, and select the widget type in the left-hand side menu.
Widgets
  1. Select the widget, which events you want to export.
  2. In the Widget Details menu, select Integrations and enable the Export data to Google Analytics slide button.
Widget details

All the event data collected for that widget will be passed automatically to your GA account.

Viewing the Real-time Analytics

To view the real-time analytics in your GA account:

  1. Select Reports → Realtime in the left-hand side menu.
  2. Select reteno in the Event name column.
Real-time Analytics

The list of event parameters displays. Click them to see the events.

Event action

The highlighted parameters are explained in the following table.

ParameterDescription
eventActionIt contains the events as described in Event categories and actions.
eventCategoryWidget type.
eventLableWidget ID.

Event Categories and Actions

GA displays Reteno events in a table as shown below.

Event categories

The Event Category column contains the description of a widget/form type as described in the following table.

Widget/form typeDescription
BUILT_INInline widget/form
DETACHEDPop-ups
FLOATING_BOXFloating box, informer
LAUNCHERLauncher
CONTENT_LOCKERContent locker

The Event Action column in GA contains the action type made on a widget. The event actions are explained in the table below.

Event ActionDescription
LauncherShow_[ID]The launcher button displays on a website.
LauncherClick_[ID]The launcher button clicked.
FormShow_[ID]The form is displayed on a website.
FormClose_[ID]A site visitor closed the form.
FormButtonClick_[ID]A site visitor clicked the form button.
FormClick_[ID]A site visitor clicked anywhere within the form.
FormStartFilling_[ID]A site visitor started filling up the form.
FormFinish_[ID]A site visitor completed the subscription form (clicked “Subscribe”, no form validation errors)
FormSuccessSubscribe_[ID]Form filling up status (subscription success)
FormAlreadySubscribe_[ID]Form filling up status (already subscribed)
FormErrorSubscribe_[ID]Form filling up status (subscription error)

The [ID] part of the events for a specific widget sending its data to GA has the following structure: f(form){id}v(variant){id}, where “f(form){id}” is the form ID and “v(variant){id}” is the form variant ID (see Note).

For example, FormShow_f781v781 in your GA table means that the form with the ID of 781, and the variant ID of 781 was displayed on a site.

The form ID is displayed in Reteno, on the Widgets page in the ID column.

Widgets page