Meta Pixel Event Tracking

Implement comprehensive Meta Pixel event tracking for OSCommerce ecommerce stores

Overview

Meta Pixel standard events enable Facebook and Instagram to:

Optimize ad delivery - Show ads to users most likely to convert
Track conversions - Measure ROI of ad campaigns
Build audiences - Create retargeting and lookalike audiences
Generate reports - Analyze customer journey and behavior

Standard Events

Meta Pixel supports these standard events for ecommerce:

ViewContent - Product page view
AddToCart - Item added to cart
AddToWishlist - Item added to wishlist
InitiateCheckout - Checkout started
AddPaymentInfo - Payment information entered
Purchase - Transaction completed
Search - Site search performed
Lead - Contact form submission
CompleteRegistration - Account created

ViewContent Event

Track product page views.

File: catalog/product_info.php

<?php
// After product information is loaded
if (tep_not_null($product_info)) {
  // Get category
  $category_query = tep_db_query("
    SELECT cd.categories_name
    FROM " . TABLE_CATEGORIES_DESCRIPTION . " cd
    INNER JOIN " . TABLE_PRODUCTS_TO_CATEGORIES . " p2c ON cd.categories_id = p2c.categories_id
    WHERE p2c.products_id = '" . (int)$product_info['products_id'] . "'
    AND cd.language_id = '" . (int)$languages_id . "'
    LIMIT 1
  ");
  $category = tep_db_fetch_array($category_query);

  // Calculate price
  $special_price = tep_get_products_special_price($product_info['products_id']);
  $final_price = $special_price ? $special_price : $product_info['products_price'];
?>
<script>
fbq('track', 'ViewContent', {
  content_ids: ['<?php echo $product_info['products_id']; ?>'],
  content_type: 'product',
  content_name: '<?php echo addslashes($product_info['products_name']); ?>',
  content_category: '<?php echo $category ? addslashes($category['categories_name']) : ''; ?>',
  value: <?php echo $final_price; ?>,
  currency: '<?php echo $_SESSION['currency']; ?>'
});
</script>
<?php
}
?>

AddToCart Event

Track when items are added to cart.

Method 1: Form Submission

File: catalog/product_info.php

<form name="cart_quantity" action="shopping_cart.php" method="post" trackAddToCart()">
  <input type="hidden" name="products_id" value="<?php echo $product_info['products_id']; ?>">
  <input type="text" name="cart_quantity" value="1" id="cart_qty">
  <button type="submit">Add to Cart</button>
</form>

<script>
function trackAddToCart() {
  var quantity = parseInt(document.getElementById('cart_qty').value) || 1;
  var productPrice = <?php echo $final_price; ?>;

  fbq('track', 'AddToCart', {
    content_ids: ['<?php echo $product_info['products_id']; ?>'],
    content_name: '<?php echo addslashes($product_info['products_name']); ?>',
    content_type: 'product',
    value: productPrice * quantity,
    currency: '<?php echo $_SESSION['currency']; ?>'
  });

  return true; // Allow form submission
}
</script>

Method 2: AJAX Add to Cart

File: catalog/product_info.php or custom JS

<script>
function addToCartAjax(productId, productName, productPrice) {
  var quantity = parseInt($('#cart_qty').val()) || 1;

  $.ajax({
    url: 'shopping_cart.php',
    method: 'POST',
    data: {
      action: 'add_product',
      products_id: productId,
      cart_quantity: quantity
    },
    success: function(response) {
      // Track successful add
      fbq('track', 'AddToCart', {
        content_ids: [productId],
        content_name: productName,
        content_type: 'product',
        value: productPrice * quantity,
        currency: '<?php echo $_SESSION['currency']; ?>'
      });

      // Update cart display
      updateCart(response);
    }
  });
}
</script>

Method 3: Quick Add from Listing

File: Product listing pages

<button echo $product['products_id']; ?>', '<?php echo addslashes($product['products_name']); ?>', <?php echo $product['products_price']; ?>)">
  Quick Add
</button>

<script>
function quickAdd(id, name, price) {
  fbq('track', 'AddToCart', {
    content_ids: [id],
    content_name: name,
    content_type: 'product',
    value: price,
    currency: '<?php echo $_SESSION['currency']; ?>'
  });

  // Redirect to cart
  window.location.href = 'shopping_cart.php?action=add_product&products_id=' + id;
}
</script>

AddToWishlist Event

Track wishlist additions (if your store has wishlist functionality).

File: catalog/wishlist.php or custom wishlist code

<?php
// After item added to wishlist
if (isset($_GET['action']) && $_GET['action'] == 'add_wishlist') {
  $products_id = (int)$_GET['products_id'];

  $product_query = tep_db_query("
    SELECT pd.products_name, p.products_price
    FROM " . TABLE_PRODUCTS . " p
    INNER JOIN " . TABLE_PRODUCTS_DESCRIPTION . " pd ON p.products_id = pd.products_id
    WHERE p.products_id = '" . $products_id . "'
    AND pd.language_id = '" . (int)$languages_id . "'
  ");
  $product = tep_db_fetch_array($product_query);
?>
<script>
fbq('track', 'AddToWishlist', {
  content_ids: ['<?php echo $products_id; ?>'],
  content_name: '<?php echo addslashes($product['products_name']); ?>',
  content_type: 'product',
  value: <?php echo $product['products_price']; ?>,
  currency: '<?php echo $_SESSION['currency']; ?>'
});
</script>
<?php
}
?>

InitiateCheckout Event

Track when checkout process begins.

File: catalog/checkout_shipping.php (first checkout page)

<?php
// On checkout page load
if (isset($_SESSION['cart']) && $_SESSION['cart']->count_contents() > 0) {
  $products = $_SESSION['cart']->get_products();

  // Get cart total
  $cart_total = 0;
  $content_ids = array();

  foreach ($products as $product) {
    $cart_total += $product['final_price'] * $product['quantity'];
    $content_ids[] = $product['id'];
  }
?>
<script>
fbq('track', 'InitiateCheckout', {
  content_ids: <?php echo json_encode($content_ids); ?>,
  content_type: 'product',
  value: <?php echo $cart_total; ?>,
  currency: '<?php echo $_SESSION['currency']; ?>',
  num_items: <?php echo $_SESSION['cart']->count_contents(); ?>
});
</script>
<?php
}
?>

AddPaymentInfo Event

Track when payment method is selected.

File: catalog/checkout_payment.php

<?php
// Get cart total for tracking
$cart_total = 0;
$content_ids = array();

if (isset($_SESSION['cart'])) {
  $products = $_SESSION['cart']->get_products();
  foreach ($products as $product) {
    $cart_total += $product['final_price'] * $product['quantity'];
    $content_ids[] = $product['id'];
  }
}
?>

<script>
// Track when payment form is submitted
document.querySelector('form[name="checkout_payment"]').addEventListener('submit', function() {
  var paymentMethod = document.querySelector('input[name="payment"]:checked');

  if (paymentMethod) {
    fbq('track', 'AddPaymentInfo', {
      content_ids: <?php echo json_encode($content_ids); ?>,
      content_type: 'product',
      value: <?php echo $cart_total; ?>,
      currency: '<?php echo $_SESSION['currency']; ?>'
    });
  }
});
</script>

Purchase Event

The most critical event for conversion tracking.

File: catalog/checkout_process.php

Store purchase data in session after order is created:

<?php
// After order insertion ($insert_id contains order_id)
if ($insert_id) {
  // Get order details
  $order_query = tep_db_query("SELECT * FROM " . TABLE_ORDERS . " WHERE orders_id = '" . (int)$insert_id . "'");
  $order = tep_db_fetch_array($order_query);

  // Get order products
  $products_query = tep_db_query("SELECT * FROM " . TABLE_ORDERS_PRODUCTS . " WHERE orders_id = '" . (int)$insert_id . "'");

  $content_ids = array();
  $content_names = array();

  while ($product = tep_db_fetch_array($products_query)) {
    $content_ids[] = $product['products_id'];
    $content_names[] = $product['products_name'];
  }

  // Store for success page
  $_SESSION['fb_purchase'] = array(
    'transaction_id' => $insert_id,
    'value' => $order['order_total'],
    'currency' => $order['currency'],
    'content_ids' => $content_ids,
    'content_names' => $content_names,
    'num_items' => count($content_ids)
  );
}
?>

File: catalog/checkout_success.php

Track on success page:

<?php
// Retrieve purchase data
if (isset($_SESSION['fb_purchase'])) {
  $purchase = $_SESSION['fb_purchase'];
?>
<script>
fbq('track', 'Purchase', {
  content_ids: <?php echo json_encode($purchase['content_ids']); ?>,
  content_type: 'product',
  value: <?php echo $purchase['value']; ?>,
  currency: '<?php echo $purchase['currency']; ?>',
  num_items: <?php echo $purchase['num_items']; ?>
});
</script>
<?php
  // Clear to prevent duplicate tracking
  unset($_SESSION['fb_purchase']);
}
?>

Prevent Duplicate Purchases

Add duplicate protection:

<?php
// Check if already tracked
if (isset($_SESSION['fb_tracked_orders'])) {
  $tracked = $_SESSION['fb_tracked_orders'];
} else {
  $tracked = array();
}

if (isset($_SESSION['fb_purchase']) && !in_array($_SESSION['fb_purchase']['transaction_id'], $tracked)) {
  $purchase = $_SESSION['fb_purchase'];
?>
<script>
fbq('track', 'Purchase', {
  content_ids: <?php echo json_encode($purchase['content_ids']); ?>,
  content_type: 'product',
  value: <?php echo $purchase['value']; ?>,
  currency: '<?php echo $purchase['currency']; ?>',
  num_items: <?php echo $purchase['num_items']; ?>
});
</script>
<?php
  // Mark as tracked
  $tracked[] = $purchase['transaction_id'];
  $_SESSION['fb_tracked_orders'] = $tracked;
  unset($_SESSION['fb_purchase']);
}
?>

Search Event

Track site searches.

File: catalog/advanced_search_result.php

<?php
if (isset($_GET['keywords'])) {
  $search_term = tep_output_string($_GET['keywords']);
?>
<script>
fbq('track', 'Search', {
  search_string: '<?php echo addslashes($search_term); ?>'
});
</script>
<?php
}
?>

Lead Event

Track contact form submissions.

File: catalog/contact_us.php

<?php
// After form successfully submitted
if ($email_sent) {
?>
<script>
fbq('track', 'Lead', {
  content_name: 'Contact Form',
  content_category: 'Customer Support'
});
</script>
<?php
}
?>

CompleteRegistration Event

Track new account creation.

File: catalog/create_account_success.php

<script>
fbq('track', 'CompleteRegistration', {
  content_name: 'Account Registration',
  status: 'success'
});
</script>

Custom Events

Create custom events for unique interactions.

File: catalog/newsletter.php

<?php
if ($subscription_successful) {
?>
<script>
fbq('trackCustom', 'NewsletterSignup', {
  source: 'footer',
  timestamp: '<?php echo time(); ?>'
});
</script>
<?php
}
?>

Product Review

File: catalog/product_reviews_write.php

<?php
if ($review_submitted) {
?>
<script>
fbq('trackCustom', 'ProductReview', {
  product_id: '<?php echo $products_id; ?>',
  rating: <?php echo (int)$_POST['rating']; ?>
});
</script>
<?php
}
?>

Coupon Applied

File: catalog/shopping_cart.php

<?php
if (isset($_SESSION['cc_id'])) {
  $coupon_code = $_SESSION['cc_id'];
?>
<script>
fbq('trackCustom', 'CouponApplied', {
  coupon: '<?php echo addslashes($coupon_code); ?>'
});
</script>
<?php
}
?>

Dynamic Ads

For dynamic product ads, use proper content_ids format.

Product Catalog Format

fbq('track', 'ViewContent', {
  content_ids: ['SKU123'],        // Use SKU if in catalog
  content_type: 'product',
  content_name: 'Product Name',
  value: 29.99,
  currency: 'USD'
});

Multiple Products

fbq('track', 'AddToCart', {
  content_ids: ['SKU123', 'SKU456', 'SKU789'],
  content_type: 'product',
  value: 149.95,
  currency: 'USD'
});

Event Parameters Reference

Required Parameters

fbq('track', 'Purchase', {
  value: 49.99,           // Number - total transaction value
  currency: 'USD'         // String - 3-letter ISO code
});

Recommended Parameters

fbq('track', 'ViewContent', {
  content_ids: ['123'],          // Array - product IDs
  content_type: 'product',       // String - product or product_group
  content_name: 'Product Name',  // String
  content_category: 'Category',  // String
  value: 29.99,                  // Number
  currency: 'USD'                // String
});

Optional Parameters

fbq('track', 'Purchase', {
  // ... required/recommended params
  num_items: 3,                  // Number - quantity of items
  predicted_ltv: 149.99,         // Number - predicted lifetime value
  status: 'completed'            // String - order status
});

Testing Events

Method 1: Meta Pixel Helper

Install Meta Pixel Helper
Visit pages and trigger events
Extension shows events fired with parameters

Method 2: Test Events Tool

Events Manager > Test Events > Test browser events

Events appear instantly with full parameter details.

Method 3: Browser Console

// Monitor fbq calls
window.fbq = new Proxy(window.fbq, {
  apply: function(target, thisArg, args) {
    console.log('fbq:', args);
    return target.apply(thisArg, args);
  }
});

Method 4: Events Manager

Events Manager > Data Sources > Your Pixel > Events

Shows events received (20-minute delay).

Common Issues

Events Not Firing

Problem: Pixel Helper shows no events

Solutions:

Check fbq is defined: typeof fbq === 'function'
Verify event syntax is correct
Check for JavaScript errors
Ensure Pixel base code loads first

Wrong Event Values

Problem: Value parameter incorrect

Solutions:

// BAD - String value
value: '$49.99'

// GOOD - Number value
value: 49.99

// BAD - Formatted number
value: 1,299.99

// GOOD - Unformatted number
value: 1299.99

Duplicate Events

Problem: Same event fires twice

Solutions:

Check for multiple tracking codes
Implement deduplication logic
Use event_id for server/client deduplication

Missing Parameters

Problem: content_ids empty or undefined

Solutions:

// Always validate data exists
<?php
$product_id = isset($product_info['products_id']) ? $product_info['products_id'] : '';
?>
<script>
<?php if ($product_id): ?>
fbq('track', 'ViewContent', {
  content_ids: ['<?php echo $product_id; ?>'],
  // ...
});
<?php endif; ?>
</script>

Best Practices

1. Use Standard Events

Prefer standard events over custom for better optimization.

2. Include Value & Currency

Always include value and currency for conversion events.

3. Use Proper content_ids

Match product IDs to those in your Facebook Product Catalog.

4. Test Before Launch

Use Test Events tool to verify all events before running ads.

5. Implement Deduplication

Use event_id to prevent counting same conversion twice:

// Client-side
fbq('track', 'Purchase', {
  value: 49.99,
  currency: 'USD'
}, {
  eventID: 'order_12345'
});

// Server-side (Conversions API)
// Send same event_id to deduplicate

Event Optimization

Value Optimization

Meta can optimize for purchases with specific values:

fbq('track', 'Purchase', {
  value: 149.99,        // Optimize for high-value purchases
  currency: 'USD'
});

Catalog Optimization

Match content_ids to product catalog for dynamic ads:

fbq('track', 'ViewContent', {
  content_ids: ['SKU_12345'],  // Must match catalog item_id
  content_type: 'product'
});

Next Steps

Additional Resources

Nach oben

Meta Pixel Event Tracking

Overview

Standard Events

ViewContent Event

AddToCart Event

Method 1: Form Submission

Method 2: AJAX Add to Cart

Method 3: Quick Add from Listing

AddToWishlist Event

InitiateCheckout Event

AddPaymentInfo Event

Purchase Event

Prevent Duplicate Purchases

Search Event

Lead Event

CompleteRegistration Event

Custom Events

Newsletter Signup

Product Review

Coupon Applied

Dynamic Ads

Product Catalog Format

Multiple Products

Event Parameters Reference

Required Parameters

Recommended Parameters

Optional Parameters

Testing Events

Method 1: Meta Pixel Helper

Method 2: Test Events Tool

Method 3: Browser Console

Method 4: Events Manager

Common Issues

Events Not Firing

Wrong Event Values

Duplicate Events

Missing Parameters

Best Practices

1. Use Standard Events

2. Include Value & Currency

3. Use Proper content_ids

4. Test Before Launch

5. Implement Deduplication

Event Optimization

Value Optimization

Catalog Optimization

Next Steps

Additional Resources