🎯 Conversion Tracking Setup Guide

Track when people who clicked your ad take actions on your website.
You only pay when someone actually converts!

Back to Ad Manager

⚡ Quick Setup (2 Steps)

Step 1: Install Tracking Script (One Time)

Copy and paste this code into your website's HTML inside the <head> tag (before </head>):

<!-- Supperage Conversion Tracking -->
<script src="https://supperage.com/js/supperage-tracking.js"></script>
<script>
    SupperageTracking.init('YOUR_AD_ID_HERE');
</script>

Replace YOUR_AD_ID_HERE with your actual ad ID found in your campaign dashboard. You can find your ad ID in the URL when viewing your campaign: /advertising/123

Step 2: Track Actions

Call the relevant tracking function wherever the conversion happens on your site:

// When user signs up:
SupperageTracking.trackSignup();

// When user makes a purchase:
SupperageTracking.trackPurchase(5000);

// When user downloads something:
SupperageTracking.trackDownload();

Full Website Example

Here is how a complete HTML page looks with tracking integrated for downloads, signups, and purchases.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>My Online Course Website</title>

    <!-- STEP 1: Install Tracking -->
    <script src="https://supperage.com/js/supperage-tracking.js"></script>
    <script>
        SupperageTracking.init('456');
    </script>
</head>
<body>
    <h1>Welcome to My Online Course!</h1>

    <button id="downloadBtn">Download Free Ebook</button>
    <button id="signupBtn">Sign Up</button>
    <button id="buyBtn">Buy Course - ₦5,000</button>

    <script>
        // STEP 2: Track conversions

        document.getElementById('downloadBtn').addEventListener('click', function() {
            SupperageTracking.trackDownload();
            window.location.href = '/ebook.pdf';
        });

        document.getElementById('signupBtn').addEventListener('click', function() {
            // Your signup logic here...
            SupperageTracking.trackSignup();
        });

        document.getElementById('buyBtn').addEventListener('click', function() {
            // After payment confirmation...
            SupperageTracking.trackPurchase(5000);
        });
    </script>
</body>
</html>

📊 Available Action Types

Use the right function for each type of conversion you want to track.

Action Type When to Use Code to Use
signup User creates an account SupperageTracking.trackSignup()
purchase User buys something SupperageTracking.trackPurchase(amount)
download User downloads a file or app SupperageTracking.trackDownload()
form_submit User submits any form SupperageTracking.trackFormSubmit()
contact User contacts you (chat, email, phone) SupperageTracking.trackContact()
lead User becomes a potential customer SupperageTracking.trackLead()
trial User starts a free trial SupperageTracking.trackTrial()
other Any custom action SupperageTracking.track('other', value, {meta})
💡 Passing Extra Data

You can pass extra info (like product name, order ID) using the metadata parameter:

// Purchase with product info
SupperageTracking.trackPurchase(15000, {
    product: 'Premium Plan',
    order_id: 'ORD-12345'
});

// Signup with user source
SupperageTracking.trackSignup({ source: 'google_search' });

// Custom action
SupperageTracking.track('other', 0, { action: 'video_watched' });

✅ How to Test It Works

  1. Open your website and press F12 to open the Developer Console.
  2. Perform a test action (like clicking your signup button).
  3. Look for: "✅ Supperage conversion tracked successfully" in the console.
  4. Then check your campaign dashboard — the Actions count should increase.

❓ Frequently Asked Questions

Where exactly in my HTML do I place the script?

Place it inside the <head> section of every page where you want to track conversions — before the closing </head> tag.

Do I need a different script for each ad?

No. One script per page. Just change the ID inside SupperageTracking.init('YOUR_AD_ID') to match the specific campaign you're tracking.

When am I charged for an action?

You are only charged the CPA rate when the tracking script successfully reports a conversion. The cost is deducted from your ad budget immediately.

What if my budget runs out?

Once your campaign budget is exhausted, actions will still be recorded but no further charges will be made. The campaign will be marked as completed.

Create a New Ad View My Campaigns