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,
PurchaseandSubscribe.
Parameters
Events include a variety of parameters you can use to enrich your analytics data. You can learn more about the events and parameters that Fundraise Up sends to Meta Pixel by exploring our parameters 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 →