How to Set Up Meta Conversions API (CAPI) on Shopify: Step-by-Step
To set up Meta Conversions API (CAPI) on Shopify, integrate directly through the Facebook & Instagram sales channel within your Shopify admin, or use a third-party Conversions API app from the Shopify App Store.
Three platforms, three answers, one budget to defend. Your GA4 export already holds the answer, and the first finding is free and never leaves your browser. Get your first finding free
By Joris van Huët, Founder & CEOUpdated 7 min read
Run the numbers for your store: the free server-side tracking ROI calculator.
How to Set Up Meta Conversions API (CAPI) on Shopify: Step-by-Step
Quick Answer: On Shopify, you switch on the Meta Conversions API (CAPI) inside the Facebook & Instagram sales channel: set customer data sharing to Enhanced or Maximum and Shopify sends server events alongside the Pixel, with no access token or code to manage. A third-party Conversions API app from the Shopify App Store is the alternative when you need your own event mapping or deduplication rules. Either way, check the events in Meta's Events Manager afterwards.
Ad blockers and browser restrictions stop some Pixel events from ever reaching Meta. CAPI sends the same events from your server instead, and as Shopify puts it, data sent from server to server can't be blocked by browser-based ad blockers. For most stores, the Meta CAPI setup on Shopify is a few settings, not a developer project.
Understanding Meta Conversions API (CAPI)
The Meta Pixel tracks in the browser: it sends events from the shopper's browser straight to Meta. Ad blockers, browser restrictions such as Apple's Intelligent Tracking Prevention (ITP) and privacy settings that shorten cookie lifespans all get in its way.
CAPI sends the same customer actions (events) from your server to Meta, so browser restrictions don't touch them. Run both, deduplicated, and Meta gets a fuller count of your conversions, which feeds its audience targeting, its ad delivery and the return on ad spend (ROAS) Ads Manager reports.
Why CAPI is Critical for Shopify Merchants
Without CAPI, Ads Manager is likely under-reporting your conversions: the Pixel misses the purchases that ad blockers and browser restrictions hide, Meta's bidding learns from the smaller count, and your ad spend decisions rest on it.
Say a customer adds an item to the cart, leaves, and comes back directly hours later to buy. The browser-side pixel can miss that conversion if a cookie expired or an ad blocker stepped in. CAPI sends the purchase from Shopify's servers instead, so Meta still receives it and can match it to the ad using the customer information sent with it. That's a sale the Pixel alone would have missed.
Step-by-Step: Setting Up Meta CAPI on Shopify
There are two ways to set up Meta CAPI on Shopify: the Facebook & Instagram sales channel, or a third-party app. Start with the sales channel: it's simpler, and Meta and Shopify support it directly.
Method 1: Native Integration via Facebook & Instagram Sales Channel
No code and no access token.
Step 1: Access Your Shopify Admin and Sales Channels
Log in to your Shopify admin. In the left-hand navigation, click "Sales Channels", then "Facebook & Instagram." If you haven't installed the channel yet, add it from the Shopify App Store.
Step 2: Connect Your Facebook Business Account
The first time you set up the Facebook & Instagram sales channel, it asks you to connect your Facebook Business Account. Follow the on-screen instructions to link your personal Facebook profile (which must have admin access to the Business Manager), select your Business Manager, Ad Account, and Facebook Page.
Step 3: Configure Data Sharing Settings
Once your accounts are connected, open the channel's Settings, then Data sharing settings. This is where CAPI gets switched on; Shopify's guide to Facebook data sharing shows each screen.
Enable Data Sharing: Toggle the "Data sharing" option to "Enabled."
Choose Data Sharing Level: In the "Choose level" section, select "Maximum." Enhanced and Maximum both send server-side (Conversions API) events next to the browser-side Meta Pixel; Maximum is also kept up to date with Meta's latest advertising technology. Standard uses the Pixel alone, so it's the one level without CAPI, and the one that leaves Meta's attribution working from the smallest count.
If you don't have one yet, the channel prompts you to create one.
Confirm Conversions API Setup: After selecting "Maximum" and your Pixel, Shopify will automatically configure the Conversions API connection in the background. You don't need to generate an access token or write server-side code.
Step 4: Verify CAPI Connection in Meta Events Manager
Then check that Meta is receiving the server events.
Go to your Meta Business Manager and navigate to "Events Manager."
Select your Pixel from the left-hand menu.
Go to the "Overview" tab. You should see a graph showing event activity.
Navigate to the "Diagnostics" tab to check for any potential issues.
Use the "Test Events" tab: enter your store's URL in the browser test, browse a few pages, add an item to your cart, and initiate a checkout, then watch the events arrive. Server events appear in Test Events only when the request carries your Test Event Code (Meta for Developers); Shopify's managed integration sends those requests for you, so if you can't add the code there, confirm server events on the "Overview" tab instead, where they are listed alongside browser events.
A successful setup will show events like PageView, ViewContent, AddToCart, InitiateCheckout, and Purchase being received, with Purchase arriving from the server as well as the browser.
Method 2: Third-Party Shopify Apps
If you need more control over event mapping or deduplication, or want to combine other data sources, a third-party app is the alternative. Several apps in the Shopify App Store add their own Conversions API connection.
Step 1: Choose and Install an App
Browse the Shopify App Store for "Meta CAPI" or "Conversions API." Read reviews, check pricing, and ensure the app offers the features you need. Install the chosen app on your Shopify store.
Step 2: Configure the App Settings
Each app will have its own configuration process, but generally, it involves:
Connecting your Facebook Business Manager: Granting the app necessary permissions to access your Business Manager, Ad Account, and Pixel.
Generating an Access Token: The app will typically guide you through generating a Conversions API Access Token from your Meta Events Manager. The token authenticates your server-side requests.
Mapping Events: Configuring which Shopify events (e.g., product_viewed, checkout_started) should be sent to Meta as standard events (e.g., ViewContent, InitiateCheckout).
Setting Up Deduplication: Check that the app deduplicates. Meta merges a browser (Pixel) event and a server (CAPI) event only when their event_id and event_name match; without that, every purchase counts twice.
Step 3: Verify CAPI Connection
Similar to the native integration, use Meta Events Manager's "Test Events" tab to confirm that server events are being received correctly. Then check the event's deduplication rate in Events Manager.
Best Practices for CAPI Data Quality
Whichever method you use, three things decide how useful the server events are:
Implement Deduplication: Every event sent by both the Pixel and CAPI needs the same event_id and event name, or Meta counts it twice. Shopify's integration and good third-party apps handle this for you; check anyway. Put yesterday's Purchase events in Events Manager next to yesterday's Shopify orders: they should land close. For illustration, 190 events against 100 orders means most purchases are arriving twice, and here's how to fix duplicate conversions.
Send Full Customer Information: The more customer data each event carries, the better Meta's matching and your event match quality (EMQ): email (em), phone (ph), first and last name (fn, ln), city (ct), state (st), zip code (zp) and country. Hash it with SHA-256 before it goes to Meta; Shopify's own CAPI integration does the hashing for you.
Use Custom Data Parameters: Send value, currency and content_ids with your events, so Meta can report revenue and match events to the products in your catalog.
More events make Meta's count more complete, not more neutral: Meta still decides which sales its ads get credit for, and it will happily over-credit itself. Keep putting Ads Manager's purchases next to your Shopify orders, and before you move budget on the new numbers, pause Meta in one region for two weeks and compare revenue with the rest, the simplest form of incrementality testing.
Frequently asked questions
What is the connection between How to Set Up Meta Conversions API (CAPI) on Shopify: Step-by-Step and marketing attribution?
CAPI decides how many of your sales Meta can see and match to its ads; attribution decides which channel gets the credit for them. Server events make Meta's count more complete, but Meta still credits itself, and a fuller count doesn't tell you which channel caused a sale. To find out what Meta caused, pause it in one region for two weeks and compare that region's revenue with the rest.How much does accurate marketing attribution cost for Shopify stores?
Checking your own numbers costs nothing but time: Events Manager, GA4's attribution reports and a Shopify orders export are free, and a two-week regional holdout costs only the sales the paused ads were really driving. Attribution tools range from free plans to quotes through sales, so price one against the budget decision it will inform.
Go deeper: Causal attribution, explained.
Sixty-second versions of these ideas: Causality Engine on YouTube Shorts.
Have an audience of ecommerce operators? Earn 20% recurring commission by recommending the €99 read.
Keep reading
Terms in this article
- Ad SpendAd Spend is the total amount invested in advertising campaigns. It is measured against Return on Ad Spend (ROAS) to evaluate campaign effectiveness.
- AttributionAttribution identifies user actions that contribute to a desired outcome and assigns value to each. It reveals which marketing touchpoints drive conversions.
- ConversionConversion is a specific, desired action a user takes in response to a marketing message, such as a purchase or a sign-up.
- IncrementalityIncrementality is the part of an outcome, such as orders or revenue, that a marketing activity caused: the extra results compared with what would have happened without it. It is a causal effect, not the number of conversions credited to a channel.
- Incrementality TestingIncrementality Testing measures the additional impact of a marketing campaign. It compares exposed and control groups to determine causal effect.
- MatchingMatching estimates a treatment effect from observational data by comparing treated units with untreated units that look alike on chosen variables. It can adjust only for variables that were measured, and it assumes they close every back door.
- RevenueRevenue is the total income generated by the sale of goods or services related to a company's primary operations.
- ShopifyShopify is an ecommerce platform for creating online stores and selling products. Attribution modeling shows which marketing channels drive traffic and conversions within Shopify.