Send conversion events from Fundraise Up to Meta Pixel

Meta Pixel is an analytics tool that allows you to measure the effectiveness of your advertising by tracking people's actions in the Checkout modal on your website.

You can pass events and parameters from Fundraise Up to Meta Pixel using Fundraise Up’s JavaScript API to effectively track conversions and other marketing metrics.

Events

Fundraise Up sends the following events to Meta Pixel:

  • Checkout opened. Fired whenever the Checkout modal is opened. Triggers the Meta event, Initiate Checkout.
  • 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: Initiate Checkout

content_ids ["FUNCPJTZZQR"] The Checkout ID and Checkout modal URL for the Campaign in Fundraise Up
content_name General Donations The name of the Campaign in Fundraise Up
content_type product The default content type for the Purchase event

Example payload: Donate

affiliation Fundraise Up The platform identifier
content_ids ["FUNCPJTZZQR"] The Checkout ID and Checkout modal URL for the Campaign in Fundraise Up
content_name General Donations The name of the Campaign in Fundraise Up
content_type product The default content type for the Purchase event
currency USD The currency used at checkout
value 107 The donation amount including transaction fees

Example payload: Purchase

affiliation Fundraise Up The platform identifier
content_ids ["FUNCPJTZZQR"] The Checkout ID and Checkout modal URL for the Campaign in Fundraise Up
content_name General Donations The name of the Campaign in Fundraise Up
content_type product The default content type for the Purchase event
currency USD The currency used at checkout
value 107 The donation amount including transaction fees

Example payload: Subscribe

affiliation Fundraise Up The platform identifier
content_ids ["FUNCPJTZZQR"] The Checkout ID and Checkout modal URL for the Campaign in Fundraise Up
content_name General Donations The name of the Campaign in Fundraise Up
content_type product The default content type for the Purchase event
currency USD The currency used at checkout
value 107 The donation amount including transaction fees
predicted_ltv 0 The predicted lifetime value of the donor. This value is always sent as 0.

Implementation guide

Add the following script between the <head> and </head> tags of each 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

The best way to check your configuration is to look at the Overview in the Event Manager in Meta Business Suite.

After you finish code installment, use Fundraise Up’s test mode to make a donation using the Checkout modal on your organization’s website. When the donation is complete, look at the Overview in the Events Manager in Meta Business Suite. Please note that it may take a short while for events to appear in Meta Pixel’s Events Manager.

Use case examples

Leveraging Fundraise Up’s integration with Meta Pixel helps you build effective audiences for ad targeting. 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 Initiate Checkout Meta event. Filter-out all other event types.

Upsell one-time donors to monthly plans

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

Target all donors with a new campaign

Create a custom audience based on the Donate Meta event.

Test data

You can send data for donations made in test mode to Meta Pixel. This functionality is useful for testing or debugging settings in Meta Pixel. To enable sending donations made in test mode to Meta Pixel, select the Test track data option from the Analytics tools page in the Dashboard.

Meta Conversions API

In addition to sending conversion events to the Meta Pixel (which occurs in the browser), Fundraise Up can also send conversion events using the Meta Conversions API to enable server-to-server tracking. Learn more →

Still need help?

Need help with something not covered in Support Center? Connect with a support engineer for more assistance.
Email us