Installing the Cavaco Tracking Pixel

Why the Pixel Matters

The Cavaco tracking pixel is a small piece of JavaScript code that you install on your store. It is the foundation of behavioral marketing in Cavaco AI. Without it, Cavaco cannot detect cart abandonments, track page views, or deliver on-site widgets like popups and banners.

Installation Methods

Method 1: Shopify (Recommended)

If you connected your store via the Shopify integration, the pixel is installed automatically. No manual steps are required. You can verify the installation by going to Settings > Integrations > Shopify and checking the "Pixel Status" indicator.

Method 2: BigCommerce

The BigCommerce integration also installs the pixel automatically upon connection. Verify via Settings > Integrations > BigCommerce.

Method 3: WooCommerce

After installing the Cavaco WooCommerce plugin, the pixel is injected automatically. Verify via your WordPress admin panel under Cavaco AI > Pixel Status.

Method 4: Manual Installation (Custom Stores)

For custom-built stores or platforms not natively supported:

Navigate to Settings > Integrations > Custom.
Copy the provided pixel code snippet.
Paste the snippet into the <head> section of every page on your store.
For single-page applications (SPAs), ensure the pixel fires on each route change.

Verifying the Pixel

After installation, visit your store in a browser and then return to Cavaco. Navigate to Settings > Integrations and check the pixel status. It should show as "Active" within a few minutes of your first page view.

What the Pixel Tracks

Page views and product views
Add-to-cart events
Cart abandonment events
Purchase completions (for attribution)
Customer identification (when a known subscriber visits)