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