Use Google Analytics on external landing pages

This article deals with landing pages made independently from Creatio. The guide for connecting landing pages made in the Landing Page Designer is available in a separate article: Use Google Analytics on landing pages designed in Creatio.

Preliminary setup

Before setting up Google Analytics (GA) integration with Creatio:

1. Ensure you have an active GA 4 property.
2. Acquire administrator access to your GA account.
3. Verify your website domain is properly configured in GA.
4. Make sure you have permission to modify your website's HTML.

General procedure to integrate GA with Creatio

1. Create a web page and connect it to Creatio. Read more >>>
2. Create a GA account and connect your web page to GA. Read more >>>
3. Connect your GA account to Creatio. Read more >>>
4. Connect the contact registration form. Read more >>>

1. Create a web page and connect it to Creatio

Select an existing website or web page to track visitor behavior or create a new page. This could be either of the following:

• A dedicated landing page promoting specific products or services (ideal for small to medium businesses).
• An entire website that has multiple pages (common for enterprise customers).

You can have both a custom-developed website, or have a website built with no-code content management systems like WordPress or landing page builders like Landingi.

2. Create a GA account and connect your web page to GA

1. Follow the steps in the official Google documentation to create an account and add data streams to your GA property: [GA4] Set up Analytics for a website and/or app. You only need to add data streams to your GA property.

2. Add the tracking code to your website. You can embed the script below directly into the landing page or via Google Tag Manager if you already use its snippet on the page.

   Landingi.com and other landing pages integrated via webhooks

   For a landing page created using the builder that can be integrated via webhooks, for example, Landingi.com, open your landing page dashboard to add a new script. If you already have a GA script, which begins with <!-- Google tag (gtag.js) --> and ends with </script>, replace it with the script for a Landingi page provided below. Make sure to select the Head position and add the script to all pages you want to track.

   <script>
   window.TAG_ID='{Measurement ID}';
   </script>	
   
   <script async src="https://www.googletagmanager.com/gtag/js?id={Measurement ID}"></script>
   
   <script src="https://webtracking-v01.creatio.com/JS/create-object.js"></script>
   
   <script src="https://webtracking-v01.creatio.com/JS/crt-gtag-with-tracking-form-data.js"></script> 

   Replace the {Measurement ID} in the script with your actual Measurement ID. Learn more: [GA4] Measurement ID (official Google documentation).

   Injection through Google Tag Manager (simple approach)

   1. Go to your Workspace and open the Tags section.
   2. Add a tag with the following parameters:

   Type	Triggering	HTML
   Custom HTML	Select "All Pages" trigger that has "Page View" type	<script> window.TAG_ID='{Measurement ID}'; </script> <script async src="https://www.googletagmanager.com/gtag/js?id={Measurement ID}"></script> <script src="https://webtracking-v01.creatio.com/JS/create-object.js"></script> <script src="https://webtracking-v01.creatio.com/JS/crt-gtag-with-tracking-form-data.js"></script> Replace the {Measurement ID} in the script with your actual Measurement ID. Learn more: GA4 Measurement ID (official Google documentation).

   3. Publish the tag. Learn more: Get started with Tag Manager (official Google documentation).
   Injection of Creatio tracking script through Google Tag Manager (advanced approach)

   If your web page already uses Google Tag Manager (GTM) with a configured Google Tag, you can send Creatio tracking parameters to GA without embedding the Creatio tracking scripts. To do this, replicate the script logic using GTM variables and pass the tracking parameters through your existing Google Tag. This way, GTM manages the entire configuration, and you do not need to add a custom HTML tag to your container.

   Before you start, make sure that the following is true:

   • Your GTM container has a Google Tag that fires on the pages you want to track.
   • You created the crt_session_id and crt_user_id custom dimensions in GA.

   Important

   This method sends the tracking parameters on every page view. Implement visitor consent handling that complies with your cookie policy separately.

   To set up the injection:

   1. Open your GTM workspace and go to the Variables section.

   2. Go to Built-In Variables block → Configure → select "Analytics Client ID" and "Analytics Session ID."

   3. Create a variable that extracts the Creatio contact ID from the page URL.

      1. Go to the User-Defined Variables block → New. This opens a window.

      2. Fill out the variable parameters.

         Parameter	Value
         Name	Creatio Contact ID
         Variable Type	URL
         Component Type	Query
         Query Key	contactID

   4. Create a variable that composes the Creatio session string.

      1. Go to the User-Defined Variables block → New. This opens a window.

      2. Fill out the variable parameters.

         Parameter	Value
         Name	Creatio Session String
         Variable Type	Custom JavaScript

      3. Insert the variable code into the Custom JavaScript field:

      function() {
          var clientId = {{Analytics Client ID}};
          var sessionId = {{Analytics Session ID}};
          var tagId = {{Google Analytics Tag ID}};
      if (clientId && sessionId) {
          return clientId + ':' + tagId + ':' + sessionId;
          }
          return "";
      }

      The variable returns the session string as {client_id}:{measurement_id}:{session_id}. The client ID identifies the visitor's device, the session ID marks the session start, and Creatio uses the measurement ID to match the data to the correct data stream. The measurement ID is contained in a constant.

   5. Go to the Tags section → select your Google Tag. This opens a window.

   6. Click Tag configuration.

   7. Add the tracking parameters.

      1. Click Configuration settings → Add parameter. Repeat this step for each new parameter.

      2. Fill out the parameter values:

         Parameter	Value
         crt_session_id	{{Creatio Session String}}
         crt_user_id	{{Creatio Contact ID}}

   8. Go to the Triggering block → make sure the tag uses the "All Pages" trigger of the "Page View" type.

   9. Publish the tag. Learn more: Get started with Tag Manager (official Google documentation).

   As a result, your Google Tag will send the crt_session_id and crt_user_id parameters to GA with each page view without loading the Creatio tracking scripts. You can verify the parameters in the GA DebugView and in GA reports that use the crt_session_id and crt_user_id custom dimensions. After you connect your GA account to Creatio and Creatio runs the "Google analytics data synchronization" business process, Creatio will import the web session and web action data of the tracked contacts.

3. Add custom dimensions in GA. Custom dimensions in GA4 are additional attributes you can create to track specific data points. In this case, you need the following custom parameters to link website visitors to Creatio contacts:

   • Session ID: Tracks individual website visits.
   • User ID: Identifies specific visitors.

   To do this:

   1. Go to Admin → Custom definitions → Create custom dimensions.

   2. Create custom dimensions that have the following parameters:

      Dimension name	Scope	Event parameter
      crt_session_id	event	crt_session_id
      crt_user_id	event	crt_user_id

      Custom dimension values in the following format: {crt_user_id}:{crt_session_id}.

      Learn more on how to add an event-scoped custom dimension in the official Google documentation: GA4 Create event-scoped custom dimensions.

As a result, your web page will be connected to GA.

3. Connect your GA account to Creatio

1. Go to the Web analytics section.

2. Click Settings → Connect.

3. Sign in using your Google account and grant Creatio access to GA data. Select all required permissions when prompted (Fig. 1).

   Fig. 1 Connecting GA account

   

As a result, your GA account will be connected to Creatio. You will be able to view your connected GA accounts and their connection status in the Settings panel of the Web analytics section.

Connect the contact registration form

TrackingUserId field must be explicitly stated in field mapping for WordPress or other custom landing pages. For Landingi.com it is not needed. For example, the webhook for WordPress or other custom landing pages must look as follows:

{"FirstName":"John","LastName":"Best","Email":"j.best@gmail.com","EntityName":"FormSubmit","FormId":"77841d51-c02b-3129-2d59-337648309c0d","TrackingUserId":"1914433587.1745421992:G-NXE0CPDVPK","PageUrl":"https://ec89fee4.instantlandings.com/marketing-demo,https://ec89fee4.instantlandings.com/marketing-demo","ReferrerUrl":"https://mysite.creatio.com/","LandingPageId":"9c710432-f716-481b-9403-8a0af24e2d34"}

Learn more about connecting a form on a Landingi page that creates ontacts or submitted forms: Import data from Landingi web page. Learn more about connecting a form on a page created using a different service: Import data from other web pages.

As a result, you will start receiving web analytics data for the last 90 days of contacts in Creatio after they submit a form on a landing page or click the link in a bulk email. The web analytics data is updated once a day. GA data for contact actions is usually received for the previous day or the day before as GA takes up to 48 hours to properly gather and structure all the web analytics data. Learn more in the official Google documentation: [GA4] Data freshness.

Track contact activity via bulk email

note

This functionality is available for Creatio version 8.3.1 and later.

In addition to tracking contacts after they submit a form, Creatio also supports tracking contacts who click a link in a bulk email. This enhancement introduces a second trigger point for receiving web analytics data from GA besides form submissions. When a contact clicks a link in a bulk email that leads to a Creatio-integrated page, Creatio can receive the corresponding GA web session and action data, even if the form is not submitted.

The landing page must meet the following requirements:

• The page must be created using Creatio’s native landing mechanism or integrated via a webhook.
• The GA tracking script must be installed on the page.
• The GA account must be connected in the Web Analytics section

GA data is synchronized with Creatio daily using the "Google analytics data synchronization" business process. You can also trigger the process manually in the Business Process Designer.

Imported data reference

Creatio imports web session and web action data from GA. A web session is a website visit during which a contact takes particular steps. A web action is a particular step the contact takes as part of a web session.

Learn more about web session data in the table below.

Data type	Details
Session	The custom dimension values in the following format: {crt_user_id}:{crt_session_id}.
Session start date	The combined values of the date, hour, and minute when the first web action took place.
Referrer URL	The full referring URL that includes the hostname and path. This referring URL is the previous URL of the user and can be this website domain or other domains.
utm_source	The referrer. Populated by the utm_source URL parameter.
utm_medium	The marketing medium the referral uses. For example, cpc. Populated by the utm_medium URL parameter.
utm_campaign	The name of the manual campaign. Populated by the utm_campaign URL parameter. Learn more in the official Google documentation: GA4 URL builders: Collect campaign data with custom URLs.
Language	The language setting of the user's browser or device. Follows the ISO 639 standard. For example, en-us.
Country code	The ID of the country from which the user activity originated, derived from their IP address. Follows the ISO 3166-1 alpha-2 standard.
City	The ID of the city from which the user activity originated, derived from their IP address.
Source	Creatio selects the lookup value from the Lead sources lookup based on UTM parameters and source identification rules.
Channel	Creatio selects the lookup value from the Lead channel lookup.

Learn more about web action data in the table below.

Data type	Details
Action start date	The combined values of date, hour, and minute when the action was triggered in GA.
Type	The name of the GA4 event. Common events include page_view, click, form_submit for general interactions, and view_item, add_to_cart, purchase for ecommerce tracking. Learn more in the official Google documentation: GA4 Automatically collected events. Creatio adds new lookup values if the imported data contains values missing from the lookup.
Web page	Creatio selects the lookup value from the lookup of the Web page object. The imported data is matched to the Page URL column. Creatio adds new lookup values if the imported data contains values missing from the lookup.
Page URL	The hostname, page path, and query string for web pages visited. For example, the fullPageUrl portion of https:​//www​.example.com/store/contact-us?query_string=true is www​.example.com/store/contact-us?query_string=true.

---

See also

Track contact data

Google Analytics overview

Use Google Analytics on landing pages designed in Creatio

Work with Google Analytics in Creatio

Matomo tracking solution

Official Google Analytics documentation