Skip to Content
StoreOSv0.31.0
Guides

Set up Meta Pixel

Connect Facebook / Meta Pixel to your StoreOS shop so ads can measure visits, carts, and sales.

What this is for

Meta Pixel (Facebook Pixel) helps Facebook and Instagram ads measure what customers do on your shop — page views, product views, add to cart, checkout, and purchases.

On StoreOS you connect the pixel once in Plugins. StoreOS then sends the usual shopping events automatically. Events go from the customer’s browser and from StoreOS’s servers, so measurement still works when browsers or ad blockers block the pixel.

You do not paste tracking code into your theme.


Before you start

You need:

  • A Meta Business account with access to Events Manager
  • Access to your store in the StoreOS console (Plugins)

About 10–15 minutes.


Step 1 — Get your Pixel ID

  1. Open Meta Events Manager.
  2. Choose your business.
  3. Open an existing Pixel (Dataset), or create a new one.
  4. Copy the Pixel ID / Dataset ID (a long number under the Pixel name).

Events Manager Overview with storeos-pixel and Dataset ID

Keep Events Manager open for the next steps.


Step 2 — Get a Conversions API access token

This lets StoreOS send events from our servers. We recommend it for reliable ads measurement.

  1. In Events Manager, open your Pixel.
  2. Go to Settings.
  3. Scroll to Conversions API → Set up direct integration.
  4. Click Generate access token.
  5. Copy the token and keep it private (like a password).

Settings tab with Generate access token under Conversions API

If you skip this step, browser tracking can still work, but many events may never reach Meta when customers use ad blockers.


Step 3 — Connect Pixel in StoreOS

  1. Sign in to the StoreOS console for your store.
  2. Open Plugins.
  3. Open Facebook / Meta Pixel.
  4. Paste:
    • Pixel ID (required)
    • Conversions API access token (recommended)
  5. Save or install the plugin.

Open your live shop and refresh the homepage once so the pixel can load.


Step 4 — Test that events arrive

Do this before spending on ads.

Open Test events (Website)

  1. In Events Manager, open your Pixel → Test events.
  2. Choose channel Website.
  3. Optionally enter your shop URL and click Test Events, then keep the Test events tab open while you browse the shop.

Test events tab with Website selected

If Meta shows a Test event code, paste it into StoreOS → Plugins → Facebook / Meta Pixel → Test event code and save. That helps Server rows appear on the Test events tab. Clear it when you finish testing.

Walk through the shop

With Test events open, visit your shop (turn off ad blockers, or use a private window without extensions):

  1. Homepage → PageView
  2. Open a product → View content
  3. Add to cart → Add to cart
  4. Search for a product → Search
  5. Go to checkout → Initiate checkout
  6. Place a cash-on-delivery order → Purchase on the thank-you page

What success looks like

In Test events you should see those event names, marked processed. With an access token (and test code while testing), you should also see Server as well as Browser.

Test events list showing PageView, View content, Add to cart from Browser


What gets tracked

What the customer doesEvent Meta sees
Opens a page in your shopPageView
Views a productView content
SearchesSearch
Adds something to the cartAdd to cart
Adds to wishlist (if your theme has wishlist)Add to wishlist
Opens checkoutInitiate checkout
Submits the orderAdd payment info
Completes the orderPurchase
Creates an account / becomes a customerComplete registration

Common problems

Nothing shows in Test events
Check the Pixel ID is saved, you are testing the same Pixel in Events Manager, and ad blockers are off. Keep the Test events tab open while you click around the shop.

Only “Browser”, no “Server”
Add or re-paste the Conversions API access token. While testing, also paste Meta’s Test event code into StoreOS if Events Manager shows one.

Shop works but Meta shows nothing
Tracking never blocks checkout. Fix the fields in Plugins, save again, then place a test order.

Finished testing
Remove the test event code in StoreOS so everyday traffic is not marked as test.


Privacy note

  • The Pixel ID appears in your public shop page — that is normal.
  • The access token stays on StoreOS servers. Do not share it in chat, themes, or public posts.

On this page