How to Set Up Facebook Conversion API (CAPI) on Shopify: Complete 2026 Guide

How to set up Facebook Conversion API (CAPI) on Shopify is essential for accurate conversion tracking in 2026. According to Meta’s documentation, iOS 14+ privacy changes block up to 30% of browser pixel data. CAPI (Conversion API) sends data directly from your Shopify server to Meta, bypassing browser restrictions and ad blockers.

Without CAPI, your Meta Ads are missing up to 30% of conversions. You’re under-reporting revenue, overpaying for leads, and making optimization decisions with incomplete data.

In this guide, I’ll show you exactly how to set up Facebook Conversion API (CAPI) on Shopify — in under 15 minutes — so you can track every conversion accurately.


External Resources (Bookmark These)


Internal Rafirit Station Resources


📊 Stop Losing 30% of Your Conversion Data

Book a 60-minute Meta Ads consultation with Rafirit Station — we’ll set up CAPI, browser pixel, and event tracking for accurate conversion measurement.

📅 Book Your Free Tracking Audit →

CAPI Setup | Pixel Installation | Event Tracking | Deduplication | Testing


What is Facebook Conversion API (CAPI)? (Simple Explanation)

Facebook Conversion API (CAPI) is a server-to-server connection between your Shopify store and Meta. Instead of relying on browser cookies (which are often blocked), CAPI sends conversion data directly from your server.

Browser Pixel (old way):

  • Customer visits site → browser loads pixel → pixel sends data to Meta
  • Problem: Ad blockers block pixels. iOS 14+ blocks cookies. Data loss: 20-30%

Conversion API (new way):

  • Customer visits site → server sends data directly to Meta
  • Ad blockers can’t block server requests. iOS privacy settings don’t affect server data. Data loss: 0-5%

Best practice: Run both browser pixel AND CAPI together for maximum data accuracy. CAPI captures what browser pixel misses. Use deduplication to prevent double-counting.

Rafirit Station sets up both browser pixel and CAPI for all Meta Ads clients.


Why You Need CAPI for Your Shopify Store

According to Meta’s documentation, businesses lose 20-30% of conversion data without CAPI.

The problem:

  • iOS 14+ privacy update blocks 30% of browser pixel data
  • Ad blockers (AdBlock, uBlock Origin) block pixel requests
  • Browser errors (network issues, slow loading) drop data
  • Cross-device conversions (iPhone browser → desktop purchase) not tracked

Without CAPI, you cannot:

  • Accurately measure ROAS (under-reporting by 20-30%)
  • Optimize campaigns for purchase events (missing data = wrong optimization)
  • Build effective lookalike audiences (polluted with incomplete data)
  • Retarget accurately (missing visitors)

Impact example:

  • Actual sales: 100 orders/day
  • Browser pixel reports: 70 orders/day (30% loss)
  • Meta thinks ROAS is 2.8x (actual 4x)
  • Meta under-optimizes because it thinks ads are less profitable than they are

With CAPI, you recover that 30% data loss.


Method 1: Via Facebook & Instagram App (Easiest — 10 Minutes)

Shopify’s official Facebook & Instagram app includes CAPI setup. This is the easiest method for most store owners.

Step-by-step setup:

Step 1: Install Facebook & Instagram App

  1. From your Shopify admin, go to Apps → Shopify App Store
  2. Search for “Facebook & Instagram”
  3. Click “Add app” → “Install app”

Step 2: Connect your Meta Business Account

  1. Log in to your Facebook account
  2. Click “Connect” to link your Meta Business account (create one if you don’t have it)
  3. Select your Facebook Page and Ad account
  4. Click “Continue”

Step 3: Enable Data Sharing (This enables CAPI)

  1. Go to “Settings” → “Data sharing settings”
  2. Select “Maximum” sharing level (includes CAPI + browser pixel)
  3. Choose event types to share: PageView, ViewContent, AddToCart, InitiateCheckout, Purchase
  4. Click “Save”

Step 4: Verify CAPI is Active

  1. Go to Meta Events Manager
  2. Select your pixel
  3. Click “Settings” → “Conversion API”
  4. You should see “Active” status with Shopify listed as a partner

Step 5: Test Events

  1. In Events Manager → “Test Events” tab
  2. Add your Shopify store URL
  3. Complete a test purchase (use test mode if available)
  4. You should see both “browser” and “server” events firing
  5. Check for “Deduplication” status (should say “Matched” or “OK”)

Rafirit Station can verify your CAPI setup and fix common errors.


🔧 Don’t Have Time to Set Up CAPI?

Let Rafirit Station configure CAPI for your Shopify store — correctly installed, tested, and deduplicated.

📅 Book Your Free CAPI Setup Consultation →


Method 2: Via Pixel & CAPI Apps (For Advanced Users)

If you need more control or the official app doesn’t work, use third-party apps.

Option A: PixelYourSite (Pro version includes CAPI)

  1. Install PixelYourSite from Shopify App Store
  2. Connect to Facebook (authorize your ad account)
  3. Enable “Conversion API” in plugin settings
  4. Configure events (Purchase, AddToCart, InitiateCheckout)
  5. Save and test

Option B: Omnisend (Email + CAPI)

  1. Install Omnisend from Shopify App Store
  2. Connect Facebook account
  3. Enable “Facebook Conversions API” under Integrations
  4. Event tracking is automatic for Purchase, AddToCart, InitiateCheckout

Option C: Custom code (developer required)


// Add to Shopify theme.liquid or checkout.liquid
fetch('https://graph.facebook.com/v18.0/YOUR_PIXEL_ID/events', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    data: [{
      event_name: 'Purchase',
      event_time: Math.floor(Date.now() / 1000),
      action_source: 'website',
      event_source_url: window.location.href,
      user_data: {
        em: ['hashed_email'],
        ph: ['hashed_phone']
      },
      custom_data: {
        currency: 'BDT',
        value: {{ total_price | json }}
      }
    }],
    access_token: 'YOUR_ACCESS_TOKEN'
  })
});

Warning: Custom code requires developer expertise. One mistake can break your checkout or send incorrect data. Use the official Facebook & Instagram app instead.


How to Verify CAPI is Working Correctly

Method 1: Meta Events Manager (Most Reliable)

  1. Go to Events Manager
  2. Select your pixel
  3. Click “Test Events” tab
  4. Perform actions on your Shopify store (view product, add to cart, purchase)
  5. Look for events with both “Browser” and “Server” sources
  6. Check “Deduplication” column — should show “Matched” or “OK”

Method 2: Facebook Pixel Helper (Chrome Extension)

  1. Install Facebook Pixel Helper
  2. Visit your Shopify store
  3. Click the Pixel Helper icon
  4. You should see pixel events firing AND “CAPI events detected” message

Signs CAPI is NOT working:

  • Only “Browser” events in Test Events (no “Server” events) → CAPI not sending data
  • Deduplication shows “Not matched” → events counted twice (browser + CAPI) → need deduplication fix
  • Pixel Helper shows errors or no CAPI events detected → check app settings

See how Rafirit Station recovered 28% more conversion data for clients using CAPI.


How Deduplication Works (Preventing Double-Counting)

When you run both browser pixel AND CAPI, the same event could be sent twice (once from browser, once from server). Meta’s deduplication merges them so each conversion is counted once.

How deduplication works:

  • Browser pixel generates an event ID (random string)
  • CAPI generates the same event ID (using the same logic)
  • Meta sees two events with same ID → counts only one

If deduplication fails:

  • You’ll see double the conversions in Events Manager
  • ROAS will be under-reported (actual revenue halved)
  • Optimization based on wrong data

How to check deduplication status:

  1. Events Manager → Test Events
  2. Perform a purchase
  3. Look at “Deduplication” column
  4. Status should say “Matched” or “OK”

If deduplication says “Not matched”:

  • Your CAPI events aren’t generating consistent event IDs
  • Solution: Use Shopify’s official Facebook & Instagram app (handles deduplication automatically)
  • Or manually implement event_id parameter in both pixel and CAPI calls

Troubleshooting Common CAPI Issues

Issue 1: CAPI Active but No Events Showing

Fix: Check “Maximum” data sharing level in Facebook & Instagram app settings. “Standard” or “Enhanced” may not send all events. Change to “Maximum” and save.

Issue 2: Duplicate Events (Same Event Counted Twice)

Fix: This is deduplication failure. Disable browser pixel events for purchase? No — keep both. Instead, check if your CAPI events are sending event_id. Shopify’s official app handles this automatically. If using custom code, implement event_id parameter.

Issue 3: CAPI Events Delayed (Not Showing in Real-Time)

Fix: CAPI events have a 5-10 minute delay (server processing). Browser pixel events appear instantly. Wait 10 minutes before checking.

Issue 4: CAPI Not Sending Purchase Value

Fix: Check currency parameter. Must be “BDT” for Bangladesh currency. Check value parameter (numeric, not string).

Issue 5: High Event Match Quality Score (Below 6/10)

Fix: CAPI tracks events using customer data (email, phone, address). The more customer data you send, the higher the match quality. Ensure you’re passing hashed email and phone number. Shopify’s official app does this automatically.


Real Example: How a Dhaka Shopify Store Recovered 28% of Conversion Data with CAPI

Client: Dhaka-based fashion ecommerce store (Shopify).

Before CAPI:

  • Browser pixel only
  • iOS users: 62% of total traffic
  • Reported purchases: 124/day
  • Actual purchases (from store data): 172/day
  • Data loss: 28%
  • ROAS reported: 2.7x (actual 3.8x)

Action taken:

  • Enabled CAPI via Facebook & Instagram Shopify app (15 minutes)
  • Set data sharing to “Maximum”
  • Tested events in Events Manager
  • Verified deduplication status (“Matched”)

Results after 30 days:

  • Reported purchases: 124/day → 168/day (+35%)
  • Data loss: 28% → 2% (recovered 26%)
  • ROAS reported: 2.7x → 3.7x (actual now reported accurately)
  • Meta Ads CPA: -23% (optimization improved with accurate data)
  • Revenue from Meta Ads: +32% (same budget, better optimization)

Key takeaway: CAPI is not optional for Shopify stores in 2026. Without it, you’re losing 20-30% of conversion data and making optimization decisions in the dark. See more tracking success stories.


CAPI Setup Checklist

Enable event types: Purchase, AddToCart, InitiateCheckout, PageView, ViewContent</td;

☐</td;Test events in Events Manager → Test Events</td;

☐</td;Verify both “Browser” and “Server” events appear</td;

☐</td;Check deduplication status (“Matched” or “OK”)</td;

☐</td;Test purchase event with actual order (not test mode)</td;

☐</td;Check Event Match Quality score (aim for 7+/10)</td;

☐</td;

Task Status
Install Facebook & Instagram app from Shopify App Store</td; ☐</td; Connect Meta Business account and Ad account</td; ☐</td; Set Data Sharing level to “Maximum”</td; ☐</td;

Frequently Asked Questions

Do I still need Facebook Pixel if I have CAPI?

Yes — run both. Pixel handles onsite events (PageView, ViewContent, AddToCart) instantly. CAPI captures what pixel misses (iOS 14+, ad blockers, browser errors). Use both with deduplication for maximum accuracy.

Is CAPI free?

Yes — Meta doesn’t charge for CAPI. The Facebook & Instagram Shopify app is also free. No additional costs.

Does CAPI work for all Shopify plans?

Yes — CAPI works on Shopify Basic, Shopify, Advanced, and Plus plans. No plan restrictions.

How long does CAPI take to set up?

10-20 minutes via the Facebook & Instagram app. 1-2 hours for custom implementation (developer required).

Can Rafirit Station set up CAPI for my Shopify store?

Yes — Rafirit Station’s analytics team can install and test CAPI for your Shopify store, including deduplication verification and event match quality optimization.


The Bottom Line

Facebook Conversion API (CAPI) is no longer optional for Shopify stores — it’s essential. iOS 14+ privacy updates and ad blockers cause 20-30% data loss for browser-only pixel tracking. CAPI recovers that data, leading to better optimization, lower CPAs, and higher ROAS.

Your next step (today):

  1. Log into your Shopify admin
  2. Go to Apps → Facebook & Instagram (install if not already)
  3. Set Data Sharing to “Maximum”
  4. Test events in Meta Events Manager → Test Events
  5. Verify both “Browser” and “Server” events appear
  6. Check deduplication status (“Matched”)
  7. Celebrate — you’re now tracking 95%+ of conversions

👉 Professional Meta Ads Management →
👉 Analytics & Tracking Services →
👉 Facebook Ads Services →
👉 See Tracking Results →
👉 📅 Book Your Free CAPI Setup Consultation on Calendly →


Want a free CAPI Setup Checklist + Troubleshooting Guide? Drop “CAPI” in the comments — I’ll send you a 30-point setup checklist and a troubleshooting flowchart for common CAPI issues.