Guides

Adding BankingBridge Event Tracking to Google Tag Manager

Suggest Edits

Prerequisites

  • Google Analytics account with at least one GA4 property set up. If you are running Universal Analytics, please read Integrating with Google Analytics and Tag Manager.
  • Google Tag Manager account with a container snippet installed on the website where the BankingBridge tool will be embedded.

🚧

Important

Pages where Google Tag Manager (gtm.js) is installed should not have Google Analytics (gtag.js) tracking code installed. Failure to remove all gtag.js calls from the page when GTM is installed will cause the BB Tool not to load the necessary data layer to collect events with Google Tag Manager.

Add a new tag

  1. Obtain your Google Analytics property ID (“G-” ID). For instructions, click here.
  2. Log in to your Google Tag Manager account.
  3. Open the Default Workspace (or create a new workspace if you prefer).
  4. On the Overview screen, click Add a new tag. Screen capture of the Overview page
  5. Name the tag "GA4 - Event - BankingBridge Event". Naming the new tag

Configure the tag

  1. Click into the Tag Configuration box.
  2. Select Google Analytics: GA4 Event as the tag type. Select tag configuration
  3. In the Configuration Tag dropdown, you will see a list of GA4 configurations available in your container. If you have already set up a configuration tag for the appropriate GA4 property, select it here and skip to the next step. Otherwise:
    1. Select None: Manually Set ID. Manually Set ID
    2. Enter your Google Analytics 4 Property ID that you obtained in step 1. Enter your property ID
  4. Next to the Event Name field, click Image of 'Add new variable' button to add a new variable.
  5. In the Choose a Variable screen, click Plus sign button to add a new variable.
  6. Name the new variable "dlv - event_action" and click the Variable Configuration box.
  7. Select Data Layer Variable as the Variable Type.
  8. In the Data Layer Variable Name box, type "event_action".
  9. Click Save in the top-right to save the variable. You will be returned to the Tag Configuration screen, and you should see the new variable {{dlv - event_action}} show up in the Event Name box.
  10. Expand the Event Parameters section, add a parameter called "category", and set the value to "BB Lead Workflow". Add an event parameter to the tag configuration

Add triggers

  1. Click the Triggering panel below the Tag Configuration box.
  2. Click the Plus sign button to add a new trigger.
  3. Name the new trigger "Banking Bridge Event" and click the Trigger Configuration box.
  4. Select Custom Event as the trigger type. Selecting 'Custom Event' trigger type
  5. Type "BBEvent" in the Event Name box.
  6. Click Save in the top-right to save the trigger.

Save the new tag

  1. Review the Tag Configuration and Triggering panels to verify that everything is correct.
  2. Click Save to save the new tag.

Test the tag configuration

📘

Note

These steps are optional.

  1. Click Preview. A new browser tab will open Google Tag Assistant.
  2. Type the URL of a page containing the BankingBridge embed and click Connect. A new browser window will open with your site in GTM preview mode.
  3. Go through all of the steps in the Lead process.
  4. When finished, return to the browser tab running Google Tag Assistant. Look for messages in the left pane called BBEvent.

🚧

Important

If you do not see the BBEvent messages, it is likely that you have hardcoded gtag.js calls on your page, and you will need to remove them before proceeding with these instructions.

  1. Click one of the BBEvent messages and ensure that the GA4 - Event - BankingBridge Event tag is listed under Tags Fired. Event tags fired.
  2. Click the GA4 - Event - BankingBridge Event tag to view its details.
  3. In the top-right, select Display Variables as Values. Review the details of tags fired
  4. Ensure that values are loaded in the Event Name and Event Parameters fields and that your Measurement ID is correct.

📘

Note

The value of Event Name will vary depending on which stage of the workflow the user has reached.

  1. Once you have verified that everything functions correctly, close the window with your web page and the Google Tag Assistant tab in your browser.

Publish your changes

  1. When you are ready to publish your changes, click Submit in the top-right of the Google Tag Manager Overview Screen.
  2. In the Submit Changes screen, type "Banking Bridge Google Analytics Events" in the Version name box.
  3. Click Publish.

When you have returned to the Google Tag Manager overview screen, your changes are live on the site, and events should start recording on the Google Analytics Page.

Updated 7 months ago