SmartTRACK: GA4 Tracking - Initial set-up and how to test it is working

SmartTRACK: GA4 Tracking - Initial set-up and how to test it is working

Installation

First step is to ensure you have installed SmartTRACK on your page correctly:
  1. Install the Google Tag Manager code on your website:
    1. There are numerous guides on how to do this but we suggest:  https://www.getfishtank.com/blog/track-events-google-analytics-4-and-google-tag-manager which is quite comprehensive. 
  2. Install SmartTRACK's code on your donation page:
    1. Use your license information and the wizard page here to create the snippet: https://smartthing.org/olx-deploy. This is an HTML snippet and should be placed on your pages in the same way as you add the Online Express or NXT donation form to your site (it uses the same tech). The code should go immediately after the donation form if possible OR at the end of the page.

Google Tag Manager configuration

Suggested below is a default config but your GA team may have additional factors they may wish to add:
  1. Create a variable called 'event' (lower case) of type 'Custom Event'
  2. Create 'Data Layer Variables' for other custom properties:
    1. transactionTotal i.e. called GA4 - DLV - transactionTotal
    2. transactionProducts
    3. transactionId
    4. transactionAffiliation
    5. currency

  3. Add a trigger of type 'Custom Event' that triggers on:
    1. 'Event name': .* (Use regex matching ticked)
    2. Select 'Some Custom Events' and filter on:
      1. Either 'event' (lowercase) equals one of 'Donation', 'Event', 'Membership', 'Recurring donation', 'Pledge to give', 'SmartSTORE'
      2. Or matches RegEx (ignore case) 'Donation|Event|Membership|SmartSTORE|Pledge to give|Recurring donation' to capture all conversions.

  4. Finally add a 'Tag' of type 'Google Analytics: GA4 Event' where all the below {{..}} values are variables.
    Note: Currency should be set to the three letter currency code for your GA account i.e. USD, GBP, AUD, CAD etc.

Verify

You can now verify everything is set up by visiting your donation page in Chrome (or Edge), press F12 to open the developer tools and go to the Console tab. You may need to scroll up and down a bit but you should see something like:

this may vary slightly but will have similar output and show the trackers detected and the success line.

OPTIONAL Config: Custom GA4 events and conversions

To use separate event types in GA4 rather than the generic 'purchase' you must mark the event types so they are considered conversions.
  1. Change the above Tag configuration by replacing the 'Event name' by the merge field '{{event}}' 
  2. Adjust the events that are considered conversions in GA4 as per:
    https://support.google.com/analytics/answer/9267568?sjid=8488443514398058599-EU 
SmartTRACK, if configured in this way, fires various events which allow you to more closely analyse your purchases i.e. Events vary depending on the Online express activity being completed but can include:
  1. Donation
  2. Recurring donation
  3. Pledge to give
  4. Event
  5. Membership
  6. SmartSTORE
These event types MUST be marked as conversion event types in GA4 to have the proper tracking triggered.

Simple testing

To test that tracking is working you should place a pledge (or real donation) using your donation form and again review the console. You should see information such as the below, you can expand the data by clicking on the arrows to see more detail:



If you go to Google Analytics and the Reports > Real-time tab you will see a 'purchase' event in the 'Event count by event name' box, if you click on that event you can see the sort of information tracked:

Advanced testing

You can test further by installing the Google Chrome extension for GA4. Once this extension is installed you need to visit your donation page and turn on the extension, the icon should then display as below:
. A more in-depth overview of how to do this is here: https://www.optizent.com/blog/ga4-debug-view-enable-and-use-ga4-debugger/

If you now visit Google Analytics > Admin and under your tracking property go to 'DebugView' you will see a timeline appear with any events. Putting through a donation will now result in very detailed debug information being shown i.e.


    • Related Articles

    • SmartTRACK - Set up instructions

      SmartTRACK is our auto-configuring tracker add-on for Blackbaud OLX (Online Express) and NXT donation forms. It calls your tracking system (Google Analytics, Bing, Facebook Pixel) with information about the completed transaction so you can then ...

    • What does SmartTRACK OLX provide in terms of tracking details?

      A brief summary of what is tracked when an Online Express Transaction completes is below. If you require any further help please chat to us or email our support team. The services triggered depend on the code snippets you already have on your page. ...

    • SmartTRACK OLX Results, problems and checking it is working

      Is it working? View the log This step is advised although optional or if you have issues with your tracking not working we suggest you do this. Open your web page in Chrome Web Browser (you can also do this in Chrome or IE but our instructions here ...

    • SmartPORTAL - Set up instructions

      SmartPORTAL overview SmartPORTAL is a flexible, modular application that allows you to build forms based on your functional requirements. The core SmartPORTAL elements are: Profile update form Login / Register form Add Actions SmartPORTAL allows your ...

    • SmartMAILCHIMP: Set up, SmartTHING can do it for you!!

      Which approach should I take? SmartMAILCHIMP can be set up yourself within the SmartSYNC product OR you can have SmartTHING can set it up for you.  If SmartTHING set the product up for you we will configure it in exactly the right way, up and running ...