formbasedocs
Go to appApp

Available on the Free plan

This works on every plan, including Free. Compare plans →

Integrations

Google Analytics (GA4)

Send form_view, form_engaged, and form_submit events to your own GA4 property through Measurement Protocol.


What you need

  • A GA4 property with a Web data stream
  • Measurement ID, formatted like G-XXXXXXXXXX

  • Measurement Protocol API secret for that stream

Connect GA4

  1. 1

    Open your GA4 web stream

    In Google Analytics, go to Admin → Data streams → select your Web stream.

  2. 2

    Copy Measurement ID

    Copy the G-XXXXXXXXXX identifier shown in stream details.

  3. 3

    Create API secret

    Open Measurement Protocol API secrets, create a secret, and copy its value.

  4. 4

    Connect in formbase

    Open Workspace → Integrations → Analytics, press Connect on Google Analytics, enter both values, and press Connect.

  5. 5

    Send a test event

    Open any form → Settings → Integrations → Analytics streaming, then click Send test event.

Events and parameters

EventMeaning
form_viewForm opened
form_engagedFirst question interaction
form_submitCompleted submission

Every event carries form_id, form_name, and source (link or request). Depending on what is known about the visit, an event can also include:

  • country, device, and browser

  • traffic_source, traffic_source_name, traffic_medium, and traffic_campaign

  • referrer_host
  • duration_seconds on submit, when available

formbase maps its pseudonymous visitor ID to GA4 client_id. When no ID is available, it sends unknown. Events never contain answers or respondent email.

Use events in GA4

  • Check Reports → Realtime after sending a test or opening a live form.

  • Use Reports → Engagement → Events after GA4 finishes processing events.

  • Create an Exploration filtered to the three formbase event names.
  • Register parameters such as form_id, device, or traffic_source as custom dimensions.

  • Mark form_submit as a key event if submission completion is a conversion for your business.

Troubleshooting

ProblemCheck
Test rejectedMeasurement ID and API secret belong to the same Web stream.
Nothing in RealtimeSend another test, confirm destination remains connected, and check GA filters/internal-traffic rules.
Parameter missing from reportsRegister it as a custom dimension and wait for GA4 processing.
One form should not forwardDisable Forward analytics events under that form’s Integrations settings.

Next steps