Quick Start Guide

Before You Begin

What You'll Need:

A Shopify or WooCommerce store
Facebook Business Manager access
Facebook Pixel ID (we'll show you how to find it)
5 minutes of your time

Create Your Harper Account

First, let's create your account. It's free to start and you can upgrade later.

Steps:

Go to Harper Signup Page
Enter your email address and create a password
Verify your email address (check your inbox)
Complete your profile with business information

💡 Tip: Use your business email to make it easier to manage team access later.

Connect Your Facebook Account

Connect your Facebook Business Manager to enable conversion tracking.

How to Find Your Facebook Pixel ID:

Go to Facebook Events Manager
Select your business account from the dropdown
Click on your Pixel (or create a new one if you don't have one)
Your Pixel ID is the 15-16 digit number at the top
Copy this ID - you'll need it in the next step

In Harper Dashboard:

Go to Settings → Integrations → Facebook
Click "Connect Facebook"
Paste your Facebook Pixel ID
Click "Authorize" to grant permissions
Select which events you want to track

✅ Success: You should see "Facebook Connected" with a green checkmark.

Connect Your Store

Choose your e-commerce platform and follow the appropriate guide:

🛍️For Shopify Users

In Harper dashboard, go to Stores → Add Store
Select "Shopify"
Enter your Shopify store URL (e.g., mystore.myshopify.com)
Click "Connect Shopify"
You'll be redirected to Shopify - click "Install App"
Grant permissions and return to Harper

View Detailed Shopify Guide →

🔌For WooCommerce Users

In Harper dashboard, go to Stores → Add Store
Select "WooCommerce"
Download the Harper plugin
In WordPress admin, go to Plugins → Add New → Upload
Upload the plugin ZIP file and activate it
Go to WooCommerce → Harper
Paste your API key from Harper dashboard
Click "Connect"

View Detailed WooCommerce Guide →

Install Tracking Code

The tracking code captures clicks and conversions. Don't worry - it's automatically installed for Shopify and WooCommerce users!

✅ Automatic Installation (Recommended)

If you connected via Shopify or WooCommerce integration, the tracking code is already installed. You can skip to Step 5!

Manual Installation (Custom Stores)

For custom stores or other platforms, add this code to your website's <head> section:

<!-- Harper Tracking Code -->
<script>
  (function(w,t,r,a,c,k){
    w.Harper=w.Harper||function(){
      (w.Harper.q=w.Harper.q||[]).push(arguments)
    };
    w.Harper.storeId='YOUR_STORE_ID';
    var s=document.createElement('script');
    s.async=1;
    s.src='https://cdn.harper.com/tracking.js';
    document.head.appendChild(s);
  })(window);
</script>
<!-- End Harper Tracking Code -->

⚠️ Important: Replace YOUR_STORE_ID with your actual Store ID from the Harper dashboard.

Verify Everything Works

Let's make sure tracking is working correctly:

Test Click Tracking:

Go to your Harper dashboard
Click on "Test Mode" in the top right
Copy the test Facebook ad URL
Paste it in a new browser tab and visit your store
Return to Harper - you should see the test click appear within seconds

Test Conversion Tracking:

While still in Test Mode, make a test purchase on your store
Use the test mode discount code provided
Complete the checkout process
Check Harper dashboard - conversion should appear within 30 seconds
Check Facebook Events Manager - event should be sent via CAPI

✅ Everything Working?

If you see both the test click and test conversion, you're all set! Harper is now tracking all your Facebook ad traffic and conversions.

❌ Not Working?

If tracking isn't working, check our troubleshooting guide:

View Troubleshooting Guide →

Go Live!

Once testing is complete, switch to Live Mode and start tracking real traffic:

In Harper dashboard, click "Exit Test Mode"
Confirm you want to go live
That's it! Harper is now tracking all Facebook ad traffic

🎉 Congratulations!

You're now tracking Facebook conversions accurately. Here's what happens next:

Every Facebook ad click is captured and tracked
Conversions are automatically attributed to the correct ads
Data is sent to Facebook via CAPI for better optimization
You can view detailed reports in your dashboard

What to Do Next

Now that tracking is set up, here are some recommended next steps:

📊 Understand Your Dashboard

Learn how to read attribution reports and make data-driven decisions

🎯 Multi-Touch Attribution

Understand how customers interact with multiple ads before purchasing

🚀 Optimize CAPI

Fine-tune your Conversion API settings for maximum accuracy

💡 Best Practices

Tips and tricks to get the most out of Harper

📹 Video Tutorial

Prefer to watch? Here's a 5-minute video walkthrough of the entire setup process:

Video tutorial coming soon

Stuck? We're Here to Help!

If you run into any issues during setup, our support team is ready to assist you.

Contact Support View FAQ