This article will walk you through the steps to set up your Virtuous Raise and Google Analytics 4 (GA4) integration.
Table of Contents
Integration Overview
The integration sends the following events to GA4 from Virtuous Raise:
-
Purchases (Donations): sends upon successfully processing a donation; includes:
- transaction_id (Gift ID)
- value (Donation Amount)
- currency (Currency Code)
- items: array containing one item representing the donation
- item_name {OrganizationName}/{CampaignName}
- item_category: (Organization URL Slug)
- price (Donation Amount)
- quantity
- campaign_name (Name of associated Campaign)
- payment_type (Credit Card, PayPal)
- gift_type (One Time or Recurring)
-
Page Views: sends when a user views a webpage; includes:
- page_title
- page_location
-
Form Starts: sent to GA4 when a user begins interaction with a form; includes:
- form_name
- form_destination
Integration Configuration
To configure the integration, you will need to collect two pieces of information from your GA4 account:
- Your Account ID (aka Measurement ID) AND
- Your API Secret
In Google Analytics 4
Go to the Admin tab in the left navigation menu. From there, click on Data Streams under the Data collection and modification box.
From Data Streams, click on your data stream. This will expand a view where you can easily copy your Measurement ID.
Scroll down further on that same view as above and select a menu item for Measurement Protocol API secrets.
There, you will either create new or use on of your existing API secrets. Copy that value, as well.
In Virtuous Raise
Now that you have the two pieces of information you need, switch to Virtuous Raise.
Click Settings from the left-hand navigation bar. From System Settings, click Integrations from the menu. From the Integrations page, click on Google Analytics.
You’ll see a screen to enter your Measurement ID and your API secret. Once you’ve done that, switch the Active toggle on and then hit Save Changes. And that’s it!
All you need to do now is wait for your data to flow into Google Analytics.
How Do I View my Events?
Once your data starts trickling in, you will have access to a number of reports in GA4. One particularly useful one is your Events report. This can be found by clicking the Reports tab in the left-hand navigation bar and then clicking Examine User Behavior, and then Events. Scroll down to see a table of Events data.
Events that will be tracked include page views, donation form starts, clicks, purchases, and more.