Heartbeat allows you to track conversions from your paid offers using Facebook Pixel (Meta Pixel). This helps you measure the effectiveness of your Facebook ads by tracking page views, leads, and purchases through your Heartbeat checkout flow.

Prerequisites

• A Facebook Business account
• A Facebook Ads account
• An active Heartbeat community with Stripe payments configured

Step 1: Create Your Facebook Ads Account

If you don't already have a Facebook Ads account, create one at business.facebook.com.

Step 2: Create a Meta Pixel

1. In your Facebook Business Manager, go to Events Manager
2. Click Connect Data Sources and select Web
3. Choose Meta Pixel and click Connect
4. Name your pixel (e.g., "Heartbeat Conversions") and enter your website URL
5. Click Continue and select Set up the Pixel now
6. Choose Manually add pixel code (you'll be adding the Pixel ID to Heartbeat, not installing code)
7. Copy your Pixel ID (a 15-digit number)

Step 3: Add Your Meta Pixel ID to Heartbeat

1. Log into your Heartbeat community as an admin
2. Go to Settings > Integrations > Conversion Tracking
3. Paste your Meta Pixel ID into the Facebook Pixel field
4. Click Save

Heartbeat will automatically send the following events to Facebook:

• PageView - When someone visits your sign-up page
• Lead - When someone submits their email
• InitiateCheckout - When someone starts the checkout process
• Purchase - When someone completes a payment

Step 4: Test Your Pixel Installation

Before running ads, verify that your pixel is tracking correctly:

1. In Facebook Events Manager, go to Test Events tab
2. In the "Confirm your website's events are set up correctly" section, paste your Heartbeat sign-up page URL (e.g., https://community.yourname.com/invitation?code=342342)
3. Click Test Events
4. Keep the Test Events page open in one browser tab
5. In another tab, go through your entire checkout flow as if you were a new member:
   • Visit the sign-up page
   • Enter your email
   • Proceed through checkout
   • Complete a test purchase
6. Return to the Test Events tab - you should see events appear in real-time including PageView, Lead, InitiateCheckout, and Purchase

Step 5: Create Your Facebook Ad Campaign

Once your pixel is tested and working:

1. Create a new Facebook ad campaign with a Sales objective
2. When setting up your ad set, choose Purchase as your conversion event
3. Make sure your pixel is selected as the conversion location
4. Complete your campaign setup and launch your ads

Facebook will now track conversions from your ads and optimize delivery to people likely to complete purchases in your Heartbeat community.

Troubleshooting

Events aren't showing up in Test Events:

• Make sure you pasted your complete sign-up page URL including any invitation codes
• Verify your Pixel ID is correctly entered in Heartbeat Settings
• Clear your browser cache and try again
• Check that you kept the Test Events page open while going through checkout

Purchase events are showing but not attributing to ads:

• Verify you selected "Purchase" as your conversion event in your ad campaign
• Allow 24-48 hours for Facebook's attribution system to process events
• Make sure the same browser was used for both seeing the ad and completing the purchase