Skip to main content

Pixel Tracking

TagadaPay handles client-side pixel tracking for your store. When you configure pixels in the dashboard, they’re automatically loaded and fired at the right moments during the checkout flow — no extra code needed.
Pixel tracking is not the same as analytics. Pixels fire client-side events to ad platforms (Meta, TikTok, etc.) for attribution and retargeting. Analytics (dashboards, reports, conversion metrics) is a separate feature in the TagadaPay CRM.

How It Works

  1. You configure pixel IDs in the TagadaPay dashboard (Settings → Integrations)
  2. TagadaPay injects the pixel scripts into checkout sessions automatically
  3. E-commerce events (PageView, AddToCart, Purchase, etc.) fire to all active pixels at the right moments
No SDK code required for standard checkout flows. Pixels are platform-managed.

Supported Pixels

PlatformConfig KeyWhat fires
Meta (Facebook)Meta Pixel IDPageView, ViewContent, AddToCart, InitiateCheckout, Purchase
TikTokTikTok Pixel IDpage, ViewContent, AddToCart, InitiateCheckout, Purchase
Google Tag ManagerGTM Container IDAll events pushed to dataLayer
Google Analytics 4GA4 Measurement IDpage_view, view_item, add_to_cart, begin_checkout, purchase
SnapchatSnap Pixel IDPAGE_VIEW, VIEW_CONTENT, ADD_CART, START_CHECKOUT, PURCHASE
PinterestPinterest Tag IDpagevisit, viewcategory, addtocart, checkout, purchase

Configure Pixels

In the TagadaPay dashboard:
Settings → Integrations → Add pixel
Select the platform, paste your pixel ID, and save. TagadaPay handles the rest — script injection, event mapping, and deduplication.

Event Mapping

TagadaPay fires these standard e-commerce events and maps them to each pixel’s native event format:
EventWhen it firesMeta (fbq)TikTok (ttq)GTM dataLayerGA4 (gtag)
PageViewPage loadPageViewpage()PageViewpage_view
ViewContentProduct viewedViewContentViewContentViewContentview_item
AddToCartItem added to cartAddToCartAddToCartAddToCartadd_to_cart
InitiateCheckoutCheckout startedInitiateCheckoutInitiateCheckoutInitiateCheckoutbegin_checkout
AddPaymentInfoCard info enteredAddPaymentInfoAddPaymentInfoAddPaymentInfoadd_payment_info
PurchasePayment succeededPurchasePurchasePurchasepurchase
All purchase events are deduplicated — they won’t fire twice for the same order, even if the customer refreshes the thank-you page.

Funnel Step Tracking

TagadaPay also tracks funnel step progression for conversion reporting in the CRM dashboard. This happens automatically when using TagadaPay-hosted funnels or the checkout session flow.

Custom Pixel Configuration (Advanced)

If you’re building a fully headless store and need to manage pixels yourself, you can use the store’s pixel config directly:
// Fetch your store's pixel configuration via the API
const storeConfig = await tagada.checkout.loadSession(checkoutToken);
// storeConfig.storeSettings.pixelConfig contains your pixel IDs

// Then use the native pixel SDKs:
// fbq('track', 'Purchase', { value: 49.00, currency: 'USD' });
// ttq.track('Purchase', { value: 49.00, currency: 'USD' });
For headless stores, you manage pixel script injection yourself using the pixel IDs from your store settings. TagadaPay provides the configuration — you control when and how scripts load.