The Meta (Facebook) Pixel helps you track marketing events when users visit your page, go through the checkout process, or make purchases.

This integration allows you to track five key events via a marketing pixel.

If you don't already have a pixel, you will need to first create it by navigating to Events Manager on your Meta for Business account.

After you have created the pixel, a pop-up window will appear for you to choose how to install your pixel.

Under the Manually add pixel code to website option, click on Install code manually.

In the first step, you will be asked to copy the base code.

Since you won't need the whole code to connect to Uscreen, click the Copy Code button, and then paste that code into your notes or any text editor, just so you can see the whole code.

Once you paste your code, find your pixel code usually on the 11th line:

fbq('init', 'PIXEL CODE NUMBER');

After copying your pixel code, go to your Uscreen account.

There are five events that you need to add to the Review Events section on Meta.

The event names and definitions are below:

Example payload of what will be pushed to the Facebook Pixel:

Also, note that the checkout workflow is dynamic, and as a result, you will only see certain events in Meta Pixel Helper (Google Chrome extension) during certain portions of the checkout process.

While the Meta Pixel integration is useful for tracking checkout events, there are some limitations to be aware of when using it with Uscreen.

The Purchase event fires on the checkout confirmation page at the time a user completes the checkout process. When a user signs up for a free trial, the Purchase event fires with a value of $0.00 since no payment is collected at that time.

When the trial ends, and the user converts to a paid subscription, the first charge happens server-side (automatically processed by the payment provider). Because the user is not on the checkout page at that point, no new Purchase event is fired, and Meta never receives the actual paid conversion data.

Similar to post-trial conversions, recurring subscription renewals (e.g., monthly or annual charges) are processed server-side by your payment provider without any browser interaction.

Since the Meta Pixel is a client-side (browser-based) tracking tool, it cannot capture these events.

Uscreen's native Meta Pixel integration is browser-based only and does not support Meta's Conversions API (CAPI). This means tracking accuracy may be reduced by:

The Meta Pixel integration only works on your web storefront.

Purchases made through iOS, Android, or TV apps are not tracked by the pixel, as these transactions are handled through the respective app stores.

The checkout confirmation page, where the Purchase event fires, only appears for approximately 5 seconds before redirecting.

If the pixel takes longer to load (due to network latency or browser conditions), the Purchase event may not fire successfully.

🔗 Learn more about the Checkout Purchase Flow

Make sure you've verified your domain.

🔗 Learn more about Verifying your Domain

If you're using a Uscreen domain, you'll need to place a <meta> tag in the Head Code Snippet.

🔗 Learn more about the Head Code Snippet

To test it, add the Meta Pixel Helper extension to your Google Chrome browser. Go to the Chrome web store, search for Meta Pixel Helper, click on the plugin offered by Meta, and select Add to Chrome.

You can find the extension by clicking on the puzzle piece icon located on the right of the navigation bar of the Chrome browser.

Click on the pin icon to make it easier to find.

Go to your site's storefront and click on the Facebook Pixel Helper extension.

Return to the Events Manager page, and on the left sidebar, select Data Sources. Make sure your pixel is selected to have access to all of your pixel's details.