Google Analytics 4

Google Analytics 4 is an analytics service that enables you to measure traffic and engagement across your websites and apps. GA4 is a new property designed for the future of measurement:
  • Collects both website and app data to better understand the customer journey
  • Uses events instead of session-based data
  • Includes privacy controls such as cookieless measurement, and behavioral and conversion modeling
  • Predictive capabilities offer guidance without complex models
After sending Freshpaint data to Google Analytics 4, you'll be able to analyse the data, identify trends and patterns in how visitors engage with your websites.
Learn more about Google Analytics 4 here.

Getting Started

To set up the GA4 (Google Analytics 4) integration, you need the following:
  1. 1.
    Measurement ID: You can find the measurement ID in the Google Analytics UI under: Admin > Data Streams > choose your stream > Measurement ID.
  2. 2.
    API Secret: An API SECRET is generated in the Google Analytics UI. To create a new secret, navigate to: Admin > Data Streams > choose your stream > Measurement Protocol > Create
Next, go to the Google Analytics 4 configuration page in Freshpaint and click Configure. Then, configure the app credentials by providing your Measurement ID and API Secret into Freshpaint. Google Analytics 4 is now ready to be used as an event destination.

Connection Mode Settings

Server-Side Connection Mode

All events will be sent to GA4 from Freshpaint's servers. Your website will not send data directly to GA4. Instead, your website and all other sources will send data to Freshpaint, which is translated then sent to GA4. As mentioned above, sources such as React Native, Android, and iOS send data server-side.
Freshpaint will send your data server-side to Google’s Measurement Protocol API.

Client-Side Connection Mode

Currently, we do not support client-side connection mode for GA4.


Once the GA4 integration is enabled, you can now set it as an event destination:
Events sent from Freshpaint to GA4 will show up as standard GA4 events. From there you can use your events in any of the GA4 reports and use it to generate insights into your business.


Freshpaint will automatically send all information about page views and screens to Google Analytics 4. You can use this information to see which pages and screens your users interact with.
If manually sending a PageView event to freshpaint, the $current_url property is required.

Invalid Event and Properties Names

Valid GA4 event/property name:
  1. 1.
    Contains only alphanumeric characters & underscores
  2. 2.
    Starts with a letter
Even if you provide an invalid event/property name, Freshpaint handles this for you. We will replace all characters other than the alphanumeric & underscores, with underscores, and if the event/property name doesn't start with a letter, we prefix it with 'FP_' to make it a valid name for GA4.

Make the switch to Google Analytics 4

Google Analytics 4 is fully equipped to support your measurement needs today and into the future. Google will be turning down Universal Analytics, so it is recommended you to make the switch to Google Analytics 4 as soon as possible. To get help in migrating to GA4, you can refer here.
Note : On July 1, 2023, standard Universal Analytics properties will no longer process data. You'll be able to see your Universal Analytics reports for a period of time after July 1, 2023. However, new data will only flow into Google Analytics 4 properties.