Markopolo AI for WooCommerce

Markopolo AI for WooCommerce is a reliable tracking plugin that uses a hybrid architecture (JavaScript + PHP) to capture customer behavior and send events to the Markopolo AI analytics platform. Perfect for e-commerce stores looking to optimize their marketing campaigns with accurate event tracking.

Key Features

• Hybrid Architecture: JavaScript for view events, PHP for action events (maximum reliability)
• Complete Event Tracking: ViewItem, ViewCart, AddToCart, RemoveFromCart, BeginCheckout, Purchase
• Tag ID Support: Unique identifier for each store sent with every event
• Easy Configuration: Simple settings page in WordPress Admin (Settings → Markopolo AI)
• Session Management: UUID-based session tracking with sessionStorage
• First-Party Cookies: Manages muid cookie with 1-year expiry for accurate user tracking
• Marketing Attribution: Automatically captures Facebook Pixel, TikTok, Google Analytics cookies
• International Phone Formatting: Phone number validation with E.164 formatting
• Customer Data Persistence: Stores email and phone in localStorage for cross-session tracking
• Rich Product Data: Captures product variants, categories, SKU, pricing
• Complete Order Tracking: Full purchase data including shipping, tax, and order details
• WooCommerce HPOS Compatible: Fully compatible with High-Performance Order Storage
• Works with All Themes: Compatible with classic themes, block themes, and WooCommerce Blocks

How It Works

1. Install and activate the plugin
2. Go to Settings → Markopolo AI and enter your Tag ID
3. The plugin automatically starts tracking customer behavior
4. Events are sent to Markopolo AI platform for analysis and optimization

Event Types Tracked

• ViewItem: When customers view product pages (JavaScript)
• ViewCart: When customers view their shopping cart (JavaScript)
• AddToCart: When items are added to cart (PHP – works with all themes)
• RemoveFromCart: When items are removed from cart (PHP)
• BeginCheckout: When customers start the checkout process (JavaScript)
• Purchase: When orders are completed with full transaction details (PHP)

Why Hybrid Architecture?

This plugin uses both JavaScript and PHP for maximum reliability:

• JavaScript Layer: Handles view events (ViewItem, ViewCart, BeginCheckout), cookie management, session tracking, and marketing pixel capture
• PHP Layer: Handles action events (AddToCart, RemoveFromCart, Purchase) using native WooCommerce hooks for 100% reliability

This approach ensures tracking works with all WooCommerce setups including WooCommerce Blocks, classic themes, AJAX add-to-cart, and form-based add-to-cart.

Privacy & GDPR

This plugin tracks customer behavior including email addresses and phone numbers from checkout forms. Ensure your privacy policy covers this data collection. All tracking respects user consent and follows WordPress best practices.

Developer Friendly

• Clean, well-documented code
• Plain JavaScript (no build tools required)
• WordPress coding standards compliant
• Uses native WooCommerce hooks
• Simple, maintainable architecture

Privacy Policy

This plugin tracks customer behavior including:
* Page views and product interactions
* Email addresses and phone numbers from checkout forms
* Marketing cookies (Facebook Pixel, TikTok, Google Analytics)
* Session data and user identifiers

All data is sent to the Markopolo AI platform for analytics purposes. Ensure your privacy policy covers this data collection and complies with applicable privacy regulations (GDPR, CCPA, etc.).

Support

For support, please:
* Visit our documentation: https://docs.markopolo.ai
* Email: support@markopolo.ai
* GitHub Issues: https://github.com/markopolo-inc/woocommerce-tracking-plugin/issues