Meta Pixel tracking on Grassrootz

Overview

Meta (Facebook) Pixel tracking is supported on Grassrootz and can be implemented at an organisational or campaign level. We support a number of custom events so that you can get the information you need to track your fundraisers, donors and VIPs across our platform.

Organisation

If you have a Meta Pixel that you would like to implement across all of your campaigns on Grassrootz, please follow the instructions below.

1. Login to your Grassrootz admin account: https://admin.grassrootz.com/
2. At the top of the page, click your organisation's name
3. Click 'Advanced' on the left hand side of the screen
4. Under the heading 'Facebook Pixel' click 'Add' then enter your Pixel number
5. Click the blue 'Save all' button on the bottom right of the screen

Your Meta Pixel will now be applied across all future campaigns that are created under your organisation's account.

Campaign

If you would like to add a unique Meta Pixel per Grassrootz campaign, please follow the instructions below.

1. Login to your Grassrootz admin account: https://admin.grassrootz.com/
2. Click 'Campaigns' at the top of the page
3. Find the campaign you would like to add the Pixel to and click the three dots next to it, then click 'Edit'
4. Click 'Advanced' on the left hand side of the screen
5. Under the heading 'Facebook Pixel', enter your Pixel number
6. Scroll down and click the blue 'Save all' button on the bottom right of the screen

Your Meta Pixel will now be applied to your campaign.

Supported events

Our integration supports both standard and custom events. Meta treats them differently when being used in ads, with an approval process in place required by Meta before any custom event can be used, you can read more about this approval process by clicking here.

Standard events

Grassrootz will utilise the following standard events:

• CompleteRegistration: this will be raised when a fundraiser signs up through our public campaign pages.
• Donate: when a user makes a donation through a fundraising page.
• Purchase: when a user completes a purchase through a public page.

Custom platform events

A number of platform events are generated to help you understand how people are using the platform. For all events the following applies:

• Event category will be set as your Grassrootz campaign name.
• Event label will be the URL where the action took place.
• Event action will be set as per the table below.

Donation form events

These events happen on the donation link for each fundraising page.

Event Action	Notes
DonationFormStart	Raised when the form is loaded
DonationAmountSelected	Raised after the first step is completed.
DonationDetailsEntered	Raised after the second step is completed.
Donation	Raised when the donation is successfully processed.
DonationPaymentFailed	Raised if the donation fails due to payment.
DonationThankYouShare	Raised when the fundraising page is shared at the donation thank you page.

Fundraising page tour events

Event Action	Notes
TourAccepted	Raised if the user chooses to take the fundraising page tour.
TourProfileImageChanged	Raised if the avatar image for the fundraising page is changed during the tour.
TourStoryUpdated	Raised if the story for the fundraising page is changed during the tour.
TourDeclined	Raised if the tour is closed.
TourSharedPage	Raised if the page is shared via the final page on the tour.

Additionally, since the tour features a donation form, all the "Donation form events" are raised with a "Tour" prefix (e.g. "TourDonationFormStart").

Fundraising page activities

Event Action	Notes
BlogPosted	Raised when the user posts an update on their page.
FitnessAppConnected	Raised when any fitness app is connected to a fundraising page.
StravaConnected	Raised when a Strava account is connected to a fundraising page.
FitbitConnected	Raised when a Fitbit account is connected to a fundraising page.
DonationReplied	Raised when a donation receives a reply from the fundraiser.
PageFundraisingTargetChanged	Raised when a fundraiser changes the target amount in their page.
PageFitnessTargetChanged	Raised when a fundraiser changes the fitness target in their page.
PageUpdatesTabClicked	Raised when someone clicks on the "Updates" tab in a fundraising page.
PageLeaderboardsTabClicked	Raised when someone clicks on the "Leaderboard" tab in a fundraising page.
PageDonationTabClicked	Raised when someone clicks on the "Donations" tab in a fundraising page.

Setting up a fundraising page

Event Action	Notes
JoinFormStart	Raised when the form is loaded.
JoinAccountCompleted	Raised when the account step is completed.
JoinNewsletterOptOut	Raised if the fundraiser opts out of further comms during the login process.
Join	Raised when a fundraising page is set up.

During the ticketing/sale process

Event Action	Notes
SaleFormStart	Raised when the first step is loaded.
SaleEntryTicketSelected	Raised when a entry/ticket selection is completed.
SaleEntryDetailsEntered	Raised when the personal details step is fully completed.
SaleFundraisingDetailsSelected	Raised when the fundraising details are completed.
SaleDonationOptOut	Raised if the user opted out of making a donation alongside the purchase.
SaleCouponApplied	Raised if a coupon is redeemed during the purchase.
SalePaymentFailed	Raised if the payment failed during a sale.
Sale	Raised when the sale is successfully processed.

Additionally, since a fundraising page and/or donation may be also processed during a sale, the respective "Join" and "Donation" events will also be raised alongside the "Sale" event.

Sharing events using the page widget

Event Action	Notes
PageWidgetShare	Raised when any of the sharing buttons are clicked on the main page widget.
PageWidgetQrRequested	Raised when the QR share button is clicked.
PageWidgetQrDownloaded	Raised when the QR code is downloaded via the "Download" button on the QR code window.