Enterprise Business Use Cases
Bulletproof Conversion Tracking
Frontend ad-blockers can cause you to lose up to 30% of your conversion data, ruining your marketing attribution models. Server-side tracking via the GA4 API guarantees that every lead is recorded, regardless of the user’s browser privacy settings.
Ultra-Detailed, Step-by-Step Setup Guide
Connecting Flex Forms to GA4 requires generating an API Secret and finding your Measurement ID. Follow these exact instructions to ensure the integration is properly authenticated.1
Step 1: Log into Google Analytics
Open your web browser and navigate to
analytics.google.com. Ensure you are logged into the Google Account that has Administrator access to the specific GA4 Property you want to track.2
Step 2: Access the Admin Panel
Look at the absolute bottom left corner of your screen. Click the gear icon labeled Admin.
3
Step 3: Navigate to Data Streams
In the Admin panel, under the Property settings column, locate and click exactly on the link labeled Data Streams.
4
Step 4: Select Your Web Stream
You will see a list of data streams (usually just one called “Web”). Click on the specific Web Stream you want to track conversions for. A detailed settings panel will slide open.
5
Step 5: Copy the Measurement ID
At the top right of this panel, you will see a string labeled Measurement ID (it always starts with
G-, for example, G-XXXXXXXXXX).Click the small copy icon next to it. In Flex Forms, open Integrations → Google Analytics and paste this into the Measurement ID field.6
Step 6: Navigate to API Secrets
Switch back to the Google Analytics tab. Scroll down the Data Stream settings panel until you find the section labeled Events. Under that, click exactly on Measurement Protocol API secrets.
7
Step 7: Create a New Secret
Click the blue Create button.Google will ask you for a nickname. Type exactly:
Flex Forms Server Integration. Click Create.8
Step 8: Copy the Secret Value
You will now see your new secret listed in the table. Copy the long string of characters in the Secret value column.Switch back to Flex Forms, paste this into the API Secret field, and click Save Settings to finalize the secure server-side connection.
Configuration & Masterclass Usage
Once authenticated, Flex Forms automatically begins tracking. There is no field mapping required. Every time a user submits a form, Flex Forms silently fires a server-sidegenerate_lead event directly into your GA4 property.
The Client ID Architecture
To correctly attribute the conversion to the user’s previous website browsing behavior (e.g., tracking that they clicked a Google Ad three days ago before submitting the form today), GA4 requires aclient_id.
How Flex Forms Handles Client IDs
1. The user visits your website.
2. The standard GA4 JavaScript snippet generates a cookie named '_ga'.
3. The user submits the Flex Form.
4. Flex Forms intelligently intercepts the submission, extracts the exact '_ga' cookie value from their browser, and packages it into the server-side API payload.
5. GA4 receives the payload and perfectly links the conversion to their historical session data.
Troubleshooting & Enterprise FAQs
Where is the data in GA4?
Where is the data in GA4?
The Problem: I submitted a test form, but I don’t see the conversion in my main GA4 reports.The Solution: GA4 takes 24-48 hours to process data into standard reports. To verify the integration is working immediately, go to GA4 > Reports > Realtime. Submit a test form, and you should see the
generate_lead event appear in the Realtime Events table within 60 seconds.API Error: Missing Client ID
API Error: Missing Client ID
The Problem: The server-side event fired, but GA4 didn’t link it to the user’s session.The Solution: This happens if the user has strict anti-tracking extensions installed that block the initial
_ga cookie from being created. In this scenario, Flex Forms will generate a fallback, randomized Client ID to ensure the conversion is still tracked, but it cannot retroactively link to session data that was blocked from existing in the first place.Configuration Reference
The following advanced settings are available in the Flex Forms UI for this integration. Use this reference to understand exactly how each field impacts the API payload.Global Settings
Located in Integrations in the Flex Forms left rail.text
required
Measurement ID
Your core Google Analytics 4 tracking ID. You can find this in GA4 by navigating to Admin → Data streams → Measurement ID. It usually starts with
G-.password
required
Measurement Protocol API secret
Highly Recommended: This secret key allows Flex Forms to bypass ad-blockers and send conversion events directly from the Laravel server to Google Analytics via the Measurement Protocol. Find this in GA4: Data stream → Measurement Protocol API secrets.
select
required
Install gtag.js on public forms
Determines if Flex Forms should automatically inject the
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXX"> tracking code into your form pages.Options:1: Yes (recommended if the form is standalone).0: Off (choose this if you embed the form on a website that already has Google Analytics or GTM installed, to prevent double-firing).
select
default:"0"
Send page_view with gtag config
If
install_gtag is enabled, this setting controls whether a standard page_view event fires immediately when the form loads.Form-Level Settings
Located on the form hub Integrations tab for a specific form.Event Tracking Rules
toggle
default:"true"
Track successful submissions
The master switch for this form. If enabled, Flex Forms will fire a conversion event to GA4 the exact moment the respondent successfully completes the form without validation errors.
text
Event name
The specific name of the event that appears in your GA4 reports. Default is
flex_form_submission.
Tip: Use snake_case (e.g., generate_lead or contact_sales).Delivery Methods
toggle
default:"true"
Send via Measurement Protocol (server)
Enterprise Grade: Sends the event directly from your server to Google’s servers. This guarantees 100% conversion tracking accuracy because it is completely immune to browser privacy blockers (Brave, Safari ITP, uBlock Origin) and network failures. Requires
api_secret under left-rail Integrations → Google Analytics.toggle
default:"true"
Send client gtag event
Fires
gtag('event') in the user’s browser on the thank-you screen. Use this alongside Measurement Protocol as a fallback, or if you rely heavily on client-side GTM triggers.Custom Dimensions
textarea
Custom parameters
Allows you to push specific form answers directly into GA4 as Custom Event Parameters. Built-in metadata (
form_id, form_title, form_slug) and URL UTM parameters (utm_source, utm_campaign, etc.) are attached automatically and do not need to be mapped here.Format: One per line as ga_parameter_name=flex_forms_block_name.
(Note: GA4 limits you to 25 custom parameters per event).