Setting Up Custom Events in GA4 for your Scorecard

This article assumes you have already added GA4 to your Scorecard using the guide found here.

If you're using Google Analytics via Google Tag Manager you should follow the guide "using GTM with custom events and the data layer" instead.

Custom Events

There are several custom events that might be pushed into GA4 as users move through your Scorecard flow

Event Name	Data Layer Params	Description
scoreapp_lead	first_name last_name email questions scorecard_key scorecard_name	Triggered straight after the lead form has been completed regardless of the position of your lead form. This is likely the most useful event to optimise towards if lead generation is your key priority.
scoreapp_lead_details_updated	first_name last_name email questions scorecard_key scorecard_name	Triggered if the lead form is resubmitted with updated details. This may occur when you include the "update details" functionality on a result page.
scoreapp_questions_started	scorecard_key scorecard_name	Triggered straight after the first main quiz question has been answered regardless of the position of your lead form.
scoreapp_questions_finished	scorecard_key scorecard_name	Triggered straight after the last main quiz question has been answered regardless of the position of your lead form.
scoreapp_question_answered	question question_ref scorecard_key scorecard_name	Triggered after each main quiz question is answered.
scoreapp_lead_form_modal_opened	scorecard_key scorecard_name	Triggered usually when someone clicks a button and opens the lead form modal. Will also be triggered if the lead form is set to automatically open on a result page at the end of the quiz questions

Example flow with lead form before questions

Example flow with lead form after questions

Monitor Your Custom Events

Perform some test completions on your Scorecard, or wait for real completions.
Then in your GA4 property, navigate to the "Reports" section.
Click on "Engagement" in the left sidebar.
Scroll down to the "Events" section, where you'll see your newly created custom conversion events ("quiz_started" and "quiz_finished"). There can be a delay for results to show here. For more instantaneous results, see the Real Time view in GA.

Now you can analyze how users are engaging with your Scorecard and make informed decisions to optimize your content.

Cross domain tracking

To note, if you are driving traffic to a domain that is different from the Scorecard domain. For example if you have created a landing page on your own website, and that landing page links to your Scorecard which is on a *.scoreapp.com domain or any other custom domain it's likely you will want to configure cross domain tracking so that GA4 is able to maintain tracking the user as they pass from one domain to another. See https://support.google.com/analytics/answer/10071811?hl=en

Embedded Scorecards

If you have embedded your Scorecard on your own website, you will need to ensure that GA4 is also installed directly on the page that hosts the embedded Scorecard, using the standard Google tag (gtag.js). ScoreApp will then detect that the Scorecard is embedded and fire the same custom events on the hosting page, as if those events happened directly on your site. This allows you to use these conversion events whilst maintaining the main user session that is active on your hosting domain, the cross-domain setup above is not needed for embedded Scorecards.

A couple of things to note:

The events fire through the Google tag installed on your page, so GA4 must be added to the hosting page directly. If your GA4 is installed through Google Tag Manager instead, follow Google Tag Manager (GTM) custom events and the data layer.
The embedded Scorecard doesn't send pageviews to your GA4 property - use the custom events above to measure Scorecard engagement.

For how to embed your Scorecard, see Embed your Scorecard on your own website.