Installation

Installing the Tracking Pixel

Learn how to install the Keak tracking pixel on your website to enable A/B testing and visitor tracking.

Important Note

You must launch your first test before getting the pixel!

We provide you with your Keak pixel after you launch your first test. You cannot get the pixel until you've created at least one A/B test using our extension.

What is the Keak Pixel?

The Keak Pixel is a snippet of JavaScript code that allows you to track visitor activity and modify your website when a new test is launched.

How It Works

The pixel:

  • Loads a small library of functions on your website
  • Tracks visitor events (page views, clicks, conversions)
  • Applies test variations to visitors in real-time
  • Sends conversion data to your Keak dashboard

What It Tracks

  • Page views and visitor sessions
  • Conversions based on your test goals
  • Test variations shown to each visitor
  • User behavior and interactions

Tracked conversions appear in your reporting dashboard and test details.

Accessing the Pixel Tab

After launching your first test:

  1. Navigate to your Keak dashboard
  2. Go to the Pixel tab in the sidebar
  3. You'll see the pixel code manager

Platform Selection

The Pixel tab lets you choose your platform for customized installation code:

JavaScript Frameworks

  • HTML/CSS/JS (General)
  • Next.js
  • React
  • Vue.js
  • Angular
  • Svelte
  • Astro
  • Remix
  • Vite
  • Gatsby

No-Code Platforms

  • Shopify
  • WordPress
  • Webflow
  • Squarespace
  • Wix
  • Framer

Installation

For Most Platforms

  1. Select your platform from the grid
  2. Copy the generated code
  3. Paste in your <head> section before the closing </head> tag
  4. Deploy your changes

The pixel code is automatically generated for your selected platform.

For Shopify (Special Setup)

Shopify requires TWO scripts for full functionality:

Step 1: Theme Script

Install in theme.liquid:

  1. Go to Shopify admin → Online Store → Themes
  2. Click "Actions" → "Edit code"
  3. Open theme.liquid file
  4. Paste the Theme Script code in the <head> section
  5. Save changes

This enables test variants and page view tracking.

Step 2: Web Pixel Script

Install in Customer Events for checkout tracking:

  1. Go to Shopify admin → Settings → Customer events
  2. Click "Add custom pixel"
  3. Name it "Keak Analytics"
  4. Paste the Web Pixel Script code
  5. Click "Save" and then "Connect"

This enables checkout completion and revenue tracking.

Why two scripts? The theme script handles variants and page tracking, while the web pixel captures checkout events and revenue - both are required for full Shopify integration.

AI Setup Assistant

For JavaScript frameworks, the Pixel tab provides AI setup instructions.

How to Use

  1. Select your framework (Next.js, React, etc.)
  2. Click "Copy for AI Assistant"
  3. Paste into ChatGPT, Claude, or Cursor
  4. Your AI assistant will help you integrate the pixel

The AI instructions include:

  • Platform-specific integration steps
  • Code placement guidance
  • Best practices for your framework
  • Troubleshooting tips

Video Guides

Platform-specific video tutorials are available for:

  • Shopify
  • WordPress
  • Webflow
  • Squarespace
  • Wix
  • Framer

These show step-by-step installation for each platform.

Verifying Installation

After installing the pixel:

Check Pixel Status

  1. Visit the Pixel tab in your dashboard
  2. Look for "Active" status indicator
  3. Green status means pixel is working

Test Page View Tracking

  1. Visit your website
  2. Check dashboard for new page view
  3. Should appear within seconds
  4. Confirms tracking is working

Check Browser Console

  1. Open browser dev tools (F12)
  2. Look for Keak initialization messages
  3. No errors should appear
  4. Confirms script loaded correctly

Troubleshooting

Pixel Not Tracking?

  • Check installation: View page source and search for "keak"
  • Check browser console: Look for errors
  • Verify pixel code: Ensure you copied the complete code
  • Check ad blockers: Some ad blockers may interfere
  • Clear cache: Browser or CDN cache may need clearing

Script Not Loading?

  • Verify script URL is accessible
  • Check Content Security Policy settings
  • Ensure no JavaScript errors on page
  • Try in incognito mode

Shopify-Specific Issues

  • Variants not showing? Check theme.liquid installation
  • Checkout not tracking? Verify web pixel in Customer Events
  • Revenue not appearing? Ensure both scripts are installed
  • Test Shopify tracking: Make a test purchase

Privacy & Performance

Privacy Compliant

The Keak pixel is designed with privacy in mind:

  • No personally identifiable information (PII) collected
  • GDPR compliant
  • Respects Do Not Track signals
  • Cookie-free option available

Performance Optimized

The pixel is built for speed:

  • Tiny file size: < 10KB compressed
  • Async loading: Doesn't block page rendering
  • CDN delivery: Fast load times globally
  • Typical impact: < 0.1 seconds to page load time

Platform-Specific Notes

Shopify

  • Install in both theme.liquid AND Customer Events
  • Revenue tracking automatic with web pixel
  • Supports all Shopify themes

WordPress

  • Use header/footer plugin or theme customizer
  • Works with all major WordPress themes
  • Compatible with page builders

Webflow

  • Add to Project Settings → Custom Code
  • Place in Head Code section
  • Publish site after installation

Next.js

  • Add to _document.tsx or layout.tsx
  • Place in <Head> component or metadata
  • Use AI setup assistant for guidance

Next Steps: After installing the pixel, launch your first test to start optimizing your website.