User Guide

Complete guide to using Algoboost Meta Pixel tracking for BigCommerce

📖 New to Algoboost?

Start with the Installation Guide to get set up first, then return here for advanced features and optimization tips.

Understanding Your Dashboard
Standard Event Tracking
Custom Event Tracking
Server-Side Conversions API (CAPI)
Product Catalog Feed
Managing Your Subscription
Troubleshooting
Optimization Tips

Understanding Your Dashboard

Dashboard Overview

Your Algoboost dashboard provides real-time tracking insights:

Configuration Section:

Pixel ID: Your Meta Pixel ID (15-16 digits)
CAPI Access Token: For Pro plan server-side tracking
Status Indicator: Green = Active, Red = Configuration needed

Event History:

Real-time log of all fired events
Event type, timestamp, and payload data
Filter by event type or date range
Events retained for 30 days

Usage Metrics:

Total events fired this month
Event breakdown by type
Plan usage and limits

Product Catalog:

XML feed URL for Facebook catalog
Product count and last update time
Feed validation status

Standard Event Tracking

Algoboost automatically tracks the following Meta Pixel events:

Event	When It Fires	Available On
PageView	Every page load	All plans (including FREE)
InitiateCheckout	Customer reaches checkout page	All plans (including FREE)
ViewContent	Customer views product page	Basic, Advanced, Pro
AddToCart	Product added to cart	Basic, Advanced, Pro
Purchase	Order completed	Basic, Advanced, Pro

Event Data Included

Each event includes:

Product Data: Product name, SKU, price, category
Value: Order total or product price
Currency: Your store's currency
Content IDs: Product IDs for catalog matching
Enhanced Match: Hashed customer email (when available)

💡 Pro Tip: All standard events work automatically - no configuration needed beyond entering your Pixel ID!

Custom Event Tracking

Advanced Pro

Advanced and Pro plans include custom event tracking for building sophisticated retargeting audiences.

Available Custom Events

1. Scroll Depth Tracking

Tracks how far users scroll on pages:

25% scroll depth
50% scroll depth
75% scroll depth
100% scroll depth (page bottom)

Use case: Create audiences of highly engaged users who read full product descriptions.

2. Time on Site

Tracks user engagement duration:

30 seconds on site
1 minute on site
2 minutes on site
5+ minutes on site

Use case: Target users who spend significant time browsing (high purchase intent).

3. Button Click Tracking

Tracks specific button interactions:

Add to Cart button clicks
Checkout button clicks
Product image clicks
CTA button clicks

Use case: Retarget users who clicked "Add to Cart" but didn't complete purchase.

4. Page Visit Tracking

Tracks visits to specific page types:

Category page views
Search result views
Blog/content page views
Landing page views

Use case: Build audiences based on product category interest.

5. Form Submission Tracking

Tracks form interactions:

Newsletter signup
Contact form submission
Product inquiry

Use case: Create lookalike audiences of engaged prospects.

Enabling Custom Events

Custom events are automatically enabled on Advanced and Pro plans. No additional configuration needed!

Server-Side Conversions API (CAPI)

Pro Plan Only

CAPI sends conversion data directly from your server to Meta, bypassing iOS 14+ restrictions and ad blockers.

Why Use CAPI?

Benefits of Server-Side Tracking

📈 20-40% More Data: Recover lost conversions from iOS 14+ and ad blockers
🍎 Bypass iOS Restrictions: Track iPhone users who opt-out of tracking
🛡️ Beat Ad Blockers: Server-side data can't be blocked
🎯 Better Attribution: More accurate ROAS calculations
⚡ Event Deduplication: Automatically prevent double-counting

How CAPI Works

Browser Pixel Fires: Standard events (PageView, ViewContent, AddToCart) tracked via JavaScript
Customer Completes Checkout: Order is placed on your store
Webhook Triggers: BigCommerce sends order data to Algoboost
Server Sends Purchase Event: Algoboost sends Purchase event directly to Meta's API
Deduplication: Meta uses event_id to merge browser and server events, preventing double-counting

Setting Up CAPI

Upgrade to Pro plan ($29.99/month)
Get a Conversions API Access Token from Facebook Events Manager
Enter the token in your Algoboost dashboard
Server-side tracking starts automatically!

💡 Recommendation: Use both browser pixel AND CAPI together for maximum coverage. This gives you:

Browser-based tracking for users without restrictions
Server-side tracking to recover iOS 14+ and ad-blocked conversions
Automatic deduplication to prevent double-counting

Product Catalog Feed

Available on all plans (including FREE)

Algoboost automatically generates an XML product feed compatible with Facebook & Instagram Shopping and Dynamic Product Ads.

What's Included in the Feed?

Product ID and SKU
Product title and description
Price and sale price
Product images (primary image)
Availability status (in stock / out of stock)
Product URL
Category
Brand (if available)

Using the Catalog Feed

Copy your catalog URL from the Algoboost dashboard
Go to Facebook Commerce Manager
Create a new catalog and select "Data Feed"
Paste your Algoboost catalog URL
Set update frequency (hourly or daily)
Use the catalog for Dynamic Product Ads or Instagram Shopping

💡 Auto-Updates: Your catalog feed updates automatically when you add, edit, or remove products in BigCommerce. No manual sync required!

Managing Your Subscription

Upgrading or Downgrading Plans

You can change your plan anytime from your dashboard:

Upgrade: Takes effect immediately with prorated billing
Downgrade: Takes effect at the start of next billing cycle
No commitment - cancel anytime

Billing Management

All billing is handled through Stripe Customer Portal:

Update payment methods
View payment history and invoices
Update billing information
Manage subscriptions

Canceling Your Subscription

Go to your Algoboost dashboard
Click "Manage Subscription" or "Cancel Plan"
You'll be redirected to Stripe Customer Portal
Click "Cancel Subscription"
Access continues until end of billing period

⚠️ Note: If you uninstall the app, your subscription is automatically canceled and pixel tracking stops immediately.

Troubleshooting

Events Not Showing in Meta Events Manager

✅ Verify your Pixel ID is correct (15-16 digits)
✅ Check events are appearing in Algoboost dashboard
✅ Wait 1-2 minutes - Meta has slight delays
✅ Disable ad blockers and test again
✅ Use Facebook Pixel Helper to verify pixel is installed

Purchase Events Not Firing

✅ Ensure you're on Basic, Advanced, or Pro plan (not FREE)
✅ Complete a real test order (not abandoned cart)
✅ Check webhooks are enabled in BigCommerce
✅ For CAPI: Verify Access Token is valid

Product Catalog Feed Issues

✅ Verify you have published products
✅ Check product images are publicly accessible
✅ Ensure products have prices set
✅ Copy the exact feed URL from dashboard (don't type manually)

CAPI Events Not Sending

✅ Verify you're on Pro plan
✅ Check Access Token starts with "EAAA"
✅ Ensure token has not expired (regenerate if needed)
✅ Confirm webhooks are working (check Algoboost event log)

Optimization Tips

🎯 Best Practices for Maximum ROI

1. Enable CAPI (Pro Plan)

Server-side tracking recovers 20-40% of lost data from iOS users and ad blockers. This dramatically improves attribution and ROAS.

2. Use Custom Events for Retargeting

Build highly engaged audiences with scroll depth and time on site tracking. These users have higher conversion rates.

3. Create Lookalike Audiences

Use Purchase events to create lookalike audiences in Meta Ads Manager for prospecting campaigns.

4. Set Up Dynamic Product Ads

Use your product catalog feed to automatically show relevant products to users who viewed them.

5. Monitor Event Quality

Check your Events Manager "Event Match Quality" score. Algoboost includes enhanced match parameters to improve this score.

6. Test Your Pixel Regularly

Use Facebook Pixel Helper and "Test Events" in Events Manager to verify tracking is working correctly.

7. Implement GDPR/CCPA Consent

Add a cookie consent banner to comply with privacy regulations. This builds customer trust.

8. Review Event History

Check your Algoboost dashboard weekly to ensure events are firing correctly.

Need Help?

📧 Contact Support

Email: support@algoboost.io

Response Times:

FREE Plan: 48 hours
Basic Plan: 24 hours
Advanced & Pro Plans: 4 hours (priority support)

Additional Resources:

🚀 Ready to Maximize Your ROAS?

Upgrade to Pro for Server-Side CAPI and recover 20-40% of lost conversion data!

View Plans & Pricing