Send conversion events from Fundraise Up to Meta Pixel

Events

Fundraise Up sends the following events to Meta Pixel:

• Checkout opened. Fired whenever the Checkout modal is opened. Triggers the Meta event, InitiateCheckout.
• Donation. Fires at the point of conversion for one-time and recurring donations. Triggers the Meta event, Donate.
• One-time donation. Fires for one-time donation conversions. Triggers the Meta event, Purchase.
• Recurring donation. Fires for recurring donation conversions. Triggers the Meta event, Purchase and Subscribe.

Parameters

Events include a variety of parameters you can use to enrich your analytics data. You can learn more about the events and parameters by exploring our JavaScript API guide.

Example payload: InitiateCheckout

Example payload: Donate

Example payload: Purchase

Example payload: Subscribe

Implementation guide

Before implementing this script, make sure the Meta Pixel base code is installed and fbq is available on the page. Add the script after the Meta Pixel base code or deploy it through your tag manager. If your standard Meta Pixel configuration already sends these events, disable the overlapping tags or configure deduplication before enabling this implementation.

Add the following script to each applicable page on your organization's website to track events in Meta Pixel:

1<script>
2FundraiseUp.on('checkoutOpen', function(details) {
3	// Firing the 'InitiateCheckout' event to Meta Pixel
4  fbq('track', 'InitiateCheckout', {
5    content_ids: [details.campaign.id],
6    content_name: details.campaign.name,
7    content_type: 'product'
8  });
9});
10
11FundraiseUp.on('donationComplete', function(details) {
12  // Firing the 'Donate' event to Meta Pixel 
13  fbq('track', 'Donate', {
14    affiliation: 'Fundraise Up',
15    content_ids: [details.campaign.id],
16    content_name: details.campaign.name,
17    content_type: 'product',
18    value: details.donation.amount,
19    currency: details.donation.currency
20  });
21
22  // Firing the 'Purchase' event to Meta Pixel  
23  fbq('track', 'Purchase', {
24    affiliation: 'Fundraise Up',
25    content_ids: [details.campaign.id],
26    content_name: details.campaign.name,
27    content_type: 'product',
28    value: details.donation.amount,
29    currency: details.donation.currency
30  });
31
32  // Firing the 'Subscribe' event to Meta Pixel if donation.recurring == true
33  if (details.donation.recurring) {
34    fbq('track', 'Subscribe', {
35      affiliation: 'Fundraise Up',
36      content_ids: [details.campaign.id],
37      content_name: details.campaign.name,
38      content_type: 'product',
39      value: details.donation.amount,
40      currency: details.donation.currency,
41      predicted_ltv: 0
42    });
43  }
44});
45</script>

Testing

If you deployed the script through a tag manager, use its preview mode to confirm that the script runs and the expected tags fire. Then open Test Events in Meta Events Manager.

After you finish installing the code, enable Fundraise Up’s test mode and make a test donation through the Checkout modal on your organization’s website. Confirm that the expected events appear in Test Events. It may take a short while for them to appear.

Use case examples

Leveraging Fundraise Up’s integration with Meta Pixel helps you build effective ad-targeting audiences. Here are a few examples of how you can act on the data in the Meta Business Suite.

Re-engage visitors who abandoned the Checkout modal

Create a custom audience based on the InitiateCheckout Meta event. Filter out all other event types.

Upsell one-time supporters to monthly plans

Create a custom audience based on the Purchase Meta event. Filter out Subscribe events.

Target all supporters with a new campaign

Create a custom audience based on the Donate Meta event.