HaptechPixel & CAPI

Set up Facebook Pixel and Conversions API on BigCommerce

Install the app, connect your pixel, turn on server-side events and check that Facebook receives them.

About 10 minutes No theme code to edit Works with Stencil themes

Before you start

You’ll need:

  • Store owner or admin access to your BigCommerce store.
  • Access to the Facebook Business account that owns your pixel (Meta Business Suite or Events Manager).
  • A pixel (also called a dataset) already created in Events Manager.
Remove other copies of the same pixel If this pixel is also added by your theme code, Script Manager, Google Tag Manager or another app, Facebook will count events twice. Remove those copies before you continue.

1Install the app

  1. In your BigCommerce control panel, go to Apps › Marketplace.
  2. Search for Haptech Facebook Pixel & CAPI and open the app.
  3. Click Install, review the permissions and confirm.

The app opens inside your control panel on the Home tab. You can come back any time from Apps › My Apps.

2Find your Pixel ID

  1. Open Meta Events Manager.
  2. In Data sources, select your pixel.
  3. Copy the ID shown under the pixel name. It is a number of about 15–16 digits.

3Create a Conversions API access token

The access token lets the app send events from our server to Facebook, so purchases are still counted when a browser blocks the pixel.

  1. In Events Manager, select your pixel and open the Settings tab.
  2. Under Conversions API, click Generate access token.
  3. Copy the token and keep it somewhere safe. Facebook shows it only once.
Keep your token private Anyone with the token can send events to your pixel. Paste it only into the app and never share it in emails or support chats.

4Add your pixel to the app

In the app, open the Pixels tab and click Add pixel. Setup has five short tabs.

Basic Info

Give the pixel a name you’ll recognise (for example “Main store”) and paste your Pixel ID.

Conversions API

Turn on Conversions API and paste the access token from step 3. If you want to check events in Facebook’s Test Events tool, also paste the test event code here (see step 5).

Events

Choose which events to send. We recommend keeping all of them on:

EventSent when a shopper…
PageViewopens any page
ViewContentopens a product page
ViewCollectionopens a category page
Searchsearches your store
AddToCartadds a product to the cart
ViewCartopens the cart
InitiateCheckoutstarts checkout
AddPaymentInfoenters payment details
Purchasecompletes an order

Customer Params

Choose which customer details are sent with server events, such as email and phone. They are hashed before they leave your store and help Facebook match events to people, which improves your Event Match Quality score.

Target Pages

Choose where the pixel runs. Most stores keep the default, all storefront pages. Click Save to finish.

The Pixels tab showing two pixels with Conversions API enabled and the list of tracked events
Your pixels appear in the Pixels tab with their status and the number of events turned on.

5Check that events arrive

  1. In Events Manager, select your pixel and open Test events. Copy the test event code.
  2. In the app, edit your pixel, paste the code in the Conversions API tab and save.
  3. Open your storefront in a new window, view a product and add it to the cart.
  4. Back in Test events, you should see each event twice: once from the Browser and once from the Server, marked as deduplicated.
  5. When you’re done, remove the test event code from the app so live events are reported normally.

You can also open the app’s CAPI Health tab to see how many server events were sent and whether any failed.

The CAPI Health tab showing total events, success rate and failures by pixel
CAPI Health shows delivery for each pixel in the date range you choose.

Reading your reports

Home

A summary of the last 7 days: your pixels, revenue, server-side delivery health, and how many add to carts, checkouts and purchases were tracked.

Analytics

Purchases and revenue from your orders, plus conversion rates between each step of the funnel. Filter by pixel and date.

CAPI Health

Every server-side send, the success rate, and the reason for any failure. Failed sends are retried automatically.

The Analytics tab showing purchases, revenue and funnel conversion rates
The Analytics tab. Reports start filling in as soon as shoppers visit your store.

Troubleshooting

No events show up in Events Manager
  • Check that the Pixel ID in the app matches the pixel you’re looking at in Events Manager.
  • Make sure the pixel’s status is Active in the Pixels tab.
  • Visit the storefront in a private window with ad blockers turned off. Browser events can take a few minutes to appear; server events usually appear within a minute.
  • If your store uses a cookie consent banner, accept tracking cookies while testing. The pixel follows your store’s consent settings.
Events are counted twice

The same pixel is installed somewhere else as well, often in theme files, Script Manager, Google Tag Manager, BigCommerce’s built-in Facebook channel or another app. Remove the other copy. Browser and server events sent by this app are already deduplicated with a shared event ID.

CAPI Health shows failed events
  • Invalid or expired token: generate a new access token (step 3) and paste it into the pixel’s Conversions API tab.
  • Pixel not found: the Pixel ID is wrong, or the token belongs to a different pixel.
  • Temporary errors: these are retried automatically. No action is needed unless the failure rate stays high.
Event Match Quality is low

Turn on more customer details in the pixel’s Customer Params tab, especially email and phone. Scores update in Events Manager within about 48 hours.

I have more than one storefront

The pixel is currently added to your default storefront. Support for additional storefronts and Catalyst is coming in a future update. Contact us if you need it now.

Uninstalling

  1. In your BigCommerce control panel, go to Apps › My Apps.
  2. Find Haptech Facebook Pixel & CAPI and click Uninstall.

All storefront scripts added by the app are removed automatically and your store returns to how it was before installation. Your pixel and its history in Facebook are not affected.

Get help

Email support@haptech.org with your store URL and a short description of the problem. We reply within one business day.

Please don’t include your access token in emails.