Shopify to Meta Conversions API.
Send every Shopify order to Meta so ads optimize on real sales. Each paid order reaches your Meta Pixel with the ad click attached.
What gets sent.
| DATALYR event | When it fires | Sent to Meta as | What it carries |
|---|---|---|---|
| purchase | Shopify marks an order paid | Purchase | Order total (includes tax and shipping, excludes discounts), currency, order ID, the ad click, and hashed email and phone when known |
| checkout_started | A checkout is created. Optional rule | InitiateCheckout | The checkout, with a value of 0 |
| order_refunded | A refund is created in Shopify | Not sent | The rule editor blocks a refund trigger aimed at a purchase event, so a refund never counts as a new conversion |
How it's matched.
DATALYR checks these in order and stops at the first one that finds the ad click.
- The visitor ID the App Embed writes onto the order as a cart attribute
- The order email, when the cart attribute found no ad click
- Click IDs and UTM parameters read from the order's landing page URL
Meta gets the click ID (fbc, built from the _fbc cookie or fbclid) and browser ID (fbp), plus email, phone and name hashed with SHA-256 when known. DATALYR sends the same event ID the browser pixel uses, so Meta merges the pair into one conversion.
How it works.
- 01
Connect Shopify.
Open Sources, select connect on Shopify, enter your myshopify.com domain and approve the five permissions. Then turn on the App Embed in your theme editor and save, so each order carries the visit that drove it.
- 02
Connect Meta.
Open Sources, select connect on Meta Ads and sign in with Facebook Login for Business. Set the primary ad account. In Conversions, select manage rules, then new rule: trigger event purchase, target platform Meta, your pixel, platform event Purchase. Set value to dynamic and pick the currency.
- 03
Check one conversion.
Place one order from a Meta ad click. Find purchase in Events, then open the newest row in Conversions and read the reply from Meta.
Check it worked.
- In Events, the purchase carries the order value and a visitor_id that does not start with shopify_. That prefix means no visit matched the order.
- Set a Test Events code on the rule, then select send test event. The event shows in Events Manager under Test events with the name, value and currency you mapped. Without a code, a test is a real conversion.
- Open the newest row in Conversions. Its status reads sent, and the response body carries Meta's own acceptance field.
View docsInstall on ShopifyShopify revenueMeta AdsConversion delivery
Questions, answered.
Contact usCAPI is Meta's Conversions API, a way to send purchases to Meta from a server instead of the shopper's browser. DATALYR sends each paid Shopify order to your Meta Pixel this way, with the ad click and hashed customer details attached.
No. DATALYR sends the same event ID the browser pixel uses, and Meta merges the pair into one conversion. That works when the pixel and DATALYR fire on the same page load. Shopify orders arrive by webhook, so if Shopify's own Meta sales channel also sends a browser purchase, Meta reports about twice your real purchases. Send purchases from one of the two, not both.
Every paid order that matches your rule. DATALYR skips a purchase worth 0, and Meta rejects events older than 7 days. Refunds never go to Meta as purchases.
Meta matches on the ad click and on hashed email or phone. If only the fbp cookie reaches Meta, quality drops. Keep the App Embed on, collect email at checkout, and read user_identifiers_count on a delivery row to see how many match keys each order carried.

See what really drives revenue.
Real-time attribution, analytics and conversions for every channel, campaign and ad, ready for your team and your agents.