Facebook Pixel (Meta Pixel)

Facebook Pixel (Meta Pixel) allows you to track visitor actions on your website and use that data for Facebook ad targeting, conversion tracking, and audience building.

Setup

1. Go to Meta Events Manager and create a Pixel if you don't have one. Copy your Pixel ID (a numeric string, e.g. 123456789012345).

2. In your admin panel, go to Admin -> Settings -> Ecommerce -> Tracking.

3. Enable Facebook Pixel (Meta Pixel).

4. Paste your Pixel ID in the Facebook Pixel ID field.

5. Optionally enable Facebook Pixel debug mode to log events in the browser console for troubleshooting.

6. Click Save.

TIP

After saving, the pixel base script (fbq('init', ...) and PageView event) is automatically injected into every page of your website, including checkout pages.

Tracked Events

The following Meta Pixel events are tracked automatically:

Server-Side Events

These events are pushed from the server when pages load:

Event	Trigger	Data
PageView	Every page load	Automatic
ViewContent	Product detail page	content_ids, content_name, content_type, content_category, contents, currency, value
ViewCategory	Category page	content_category, content_ids, content_type
InitiateCheckout	Checkout page	content_ids, content_name, contents, currency, num_items, value
Purchase	Order success page	content_ids, content_name, content_type, contents, currency, value, order_id

Client-Side Events

These events fire via JavaScript when users interact with the site:

Event	Trigger	Data
AddToCart	Add product to cart	content_ids, content_name, content_type, contents, currency, value
AddToWishlist	Add product to wishlist	content_ids, content_name, content_type, currency, value
AddToCompare	Add product to compare (custom event)	content_ids, content_name, content_type, currency, value
RemoveFromCart	Remove product from cart (custom event)	content_ids, content_name, content_type, contents, currency, value
ViewContent	Click on a product link	content_ids, content_name, content_type, currency, value
Search	Submit a search or filter form	search_string, content_type
CompleteRegistration	Customer registration or newsletter signup	content_name, status, currency, value
Lead	Contact form submission	content_name, content_category
AddPaymentInfo	Select payment method at checkout	currency, value, payment_type

INFO

Events marked as "custom event" use fbq('trackCustom', ...) instead of fbq('track', ...). Custom events can be used in Facebook Ads for custom audience building but are not standard conversion events.

Verifying Your Pixel

Method 1: Browser Console (Debug Mode)

1. Enable Facebook Pixel debug mode in admin settings.
2. Open your website in Chrome and press F12 to open Developer Tools.
3. Go to the Console tab.
4. Look for blue messages like Facebook Pixel Debug Mode Active and green messages for each event fired.

Method 2: Meta Pixel Helper Extension

1. Install the Meta Pixel Helper Chrome extension.
2. Visit your website.
3. Click the extension icon - it shows all pixel events firing on the page.

Method 3: Facebook Events Manager

1. Go to Meta Events Manager.
2. Select your Pixel.
3. Go to the Test Events tab.
4. Enter your website URL and click Open Website.
5. Browse your site - events will appear in real-time in the Test Events panel.

WARNING

It may take up to 24 hours for event data to appear in the Events Manager overview. Use Test Events for immediate verification.

Currency Handling

The pixel automatically uses your store's active currency. For zero-decimal currencies (JPY, VND, KRW, etc.), values are rounded to whole numbers. For all other currencies, values are rounded to 2 decimal places.

Troubleshooting

Issue	Solution
No events in Events Manager	Verify the Pixel ID is correct and the toggle is enabled. Clear your site cache.
Events not firing	Check browser console for JavaScript errors. Ensure no ad blocker is active.
Duplicate events	This is normal - some events fire from both server and client side for redundancy. Facebook deduplicates them automatically.
Wrong currency or values	Check your store's active currency in Admin -> Ecommerce -> Currencies.
Pixel Helper shows warning	Warnings about "non-standard parameters" are safe to ignore for custom events.