Skip to main content

WooCommerce Integration

Privacy-first, cookieless analytics for WordPress + WooCommerce stores with complete e-commerce funnel tracking.

Requirements​

  • WordPress 5.8+
  • WooCommerce 6.0+
  • PHP 7.4+

Installation​

Step 1: Get the Plugin​

Download the Sealmetrics WooCommerce plugin from your Sealmetrics dashboard, under Settings → Integrations.

Step 2: Upload to WordPress​

  1. Go to WordPress Admin > Plugins > Add New > Upload Plugin
  2. Upload the ZIP file and click Install Now
  3. Activate the plugin

Step 3: Configure​

  1. Go to Settings > Sealmetrics
  2. Enter your Account ID — this is your Site ID, shown in Settings → Sites → [your site] → General (how to find it)
  3. Save changes

Configuration Options​

SettingDescription
Account IDYour Sealmetrics Account ID (required)
Pixel URLCustom pixel domain for first-party tracking (optional)

E-commerce Events​

The plugin automatically tracks the complete e-commerce funnel:

EventTypeProperties
pageviewAutoAll pages with content grouping
view_itemMicroconversionproduct_name, product_id, sku, price, currency, category, brand
add_to_cartMicroconversionproduct_name, product_id, sku, price, quantity, currency, variation attributes
begin_checkoutMicroconversioncart_total, currency, items_count
purchaseConversionrevenue, currency, payment_method, coupon, items array

Content Groups​

Automatic detection based on WooCommerce page type:

Page TypeGroup
Shop pagecatalog
Product categorycatalog
Single productproduct
Cartcart
Checkoutcheckout
Order confirmationthankyou
My Accountaccount

Features​

Brand Detection​

The plugin automatically detects product brands from popular plugins:

  • YITH WooCommerce Brands
  • Perfect Brands for WooCommerce
  • WooCommerce Brands
  • Custom product_brand taxonomy

Variable Products​

All variation attributes are captured automatically:

{
product_name: "T-Shirt - Large, Blue",
size: "Large",
color: "Blue",
// ... other selected attributes
}

Add to Cart Tracking​

Works with all add-to-cart methods:

  • Standard add to cart buttons
  • AJAX add to cart
  • Variable product forms
  • Quantity changes

Purchase Tracking​

Full e-commerce data is captured on order confirmation:

sealmetrics.conv('purchase', 129.99, {
currency: 'EUR',
payment_method: 'PayPal',
coupon: 'SAVE10',
items: [
{
product_id: '123',
product_name: 'Product Name',
sku: 'SKU-123',
price: '49.99',
quantity: '2',
category: 'Clothing',
brand: 'Brand Name',
size: 'Large',
color: 'Blue'
}
]
});

Duplicate Prevention​

The plugin prevents duplicate purchase tracking:

  • Uses order meta to track sent conversions
  • Handles page refreshes on thank you page

Privacy​

  • No cookies used
  • No order IDs stored externally
  • No customer data collected
  • Designed for GDPR and ePrivacy (self-assessed, see Compliance)
  • No consent banner for Sealmetrics' own analytics (self-assessed; Germany: open question — see Germany)

Troubleshooting​

Tracker not loading​

  1. Verify Account ID is configured in Settings > Sealmetrics
  2. Clear WordPress cache
  3. Check browser console for JavaScript errors

Purchases not tracking​

  1. Ensure the order confirmation page loads correctly
  2. Check WooCommerce order status is "completed" or "processing"
  3. Verify no conflicting analytics plugins

Add to cart not working​

  1. Check AJAX add to cart is enabled in WooCommerce settings
  2. Verify no JavaScript errors in browser console
  3. Test with the default theme (Storefront) to rule out theme conflicts
Written and maintained by the Sealmetrics Team