Lead Tracking

Lead tracking captures when referred visitors sign up or submit forms. This lets you see which partners drive qualified leads—not just clicks.

What It Does

When a visitor signs up on your site, you call window.affitor.trackLead(). This:

Captures the lead event with email
Links it to the stored partner_code from the click
Creates an attribution record in Affitor

Partners can then see: Clicks → Signups → Sales

Prerequisites

Before implementing lead tracking:

Pageview tracker installed
Visitor arrived via affiliate link (has partner_code cookie)

Basic Implementation

After your signup form submits successfully, call:

window.affitor.trackLead({
email: 'user@example.com'
});

That's the minimum. Email is required; everything else is optional.

Full Implementation

Include additional data for better analytics:

window.affitor.trackLead({
email: 'user@example.com',        // Required
name: 'John Doe',                 // Optional
phone: '+1234567890',             // Optional
additional_data: {
  signup_method: 'email',         // How they signed up
  user_id: 'user_123',            // Your internal user ID
  plan: 'free_trial',             // Plan they selected
  source: 'pricing_page'          // Where they signed up
}
});

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | email | string | Yes | User's email address | | name | string | No | User's full name | | phone | string | No | User's phone number | | additional_data | object | No | Any extra data you want to track |

Integration Examples

Standard Form

document.getElementById('signup-form').addEventListener('submit', async function(e) {
e.preventDefault();

const email = document.getElementById('email').value;
const name = document.getElementById('name').value;

// Your signup logic
const result = await createAccount(email, name);

if (result.success) {
  // Track the lead
  window.affitor.trackLead({
    email: email,
    name: name,
    additional_data: {
      user_id: result.userId,
      signup_method: 'form'
    }
  });

  // Redirect to dashboard or next step
  window.location.href = '/welcome';
}
});

React

function SignupForm() {
const handleSubmit = async (e) => {
  e.preventDefault();
  const formData = new FormData(e.target);

  // Your signup logic
  const result = await api.createAccount({
    email: formData.get('email'),
    name: formData.get('name')
  });

  if (result.success) {
    // Track the lead
    window.affitor?.trackLead({
      email: formData.get('email'),
      name: formData.get('name'),
      additional_data: {
        user_id: result.userId
      }
    });

    router.push('/welcome');
  }
};

return (
  <form onSubmit={handleSubmit}>
    <input name="email" type="email" required />
    <input name="name" type="text" />
    <button type="submit">Sign Up</button>
  </form>
);
}

// After OAuth callback
async function handleOAuthCallback(user) {
// User authenticated via Google/GitHub/etc.

// Track the lead
window.affitor?.trackLead({
  email: user.email,
  name: user.name,
  additional_data: {
    signup_method: 'google',
    user_id: user.id
  }
});

// Continue to dashboard
window.location.href = '/dashboard';
}

When to Call trackLead()

Call trackLead() after the signup is confirmed successful:

| Scenario | When to track | |----------|---------------| | Form signup | After form validation passes and account is created | | OAuth signup | After OAuth callback, user authenticated | | Email verification | After signup, not after verification (track intent) | | Free trial | When trial starts | | Waitlist | When added to waitlist |

Don't track

Failed signups
Duplicate signups
Bot submissions

Checking for Affitor

The tracker might not be loaded if:

Visitor has ad blocker
Script failed to load
Visitor didn't come from affiliate link

Always check before calling:

if (window.affitor) {
window.affitor.trackLead({ email: email });
}

// Or use optional chaining
window.affitor?.trackLead({ email: email });

Lead Tracking

What It Does

Prerequisites

Basic Implementation

Full Implementation

Parameters

Integration Examples

Standard Form

React

When to Call trackLead()

Checking for Affitor

Verifying Lead Tracking

Test Mode

Dashboard Verification

Next Steps

Payment Tracking

Testing Integration

Lead Tracking

What It Does

Prerequisites

Basic Implementation

Full Implementation

Parameters

Integration Examples

Standard Form

React

Google/OAuth Signup

When to Call trackLead()

Checking for Affitor

Verifying Lead Tracking

Test Mode

Dashboard Verification

Next Steps

Payment Tracking

Testing Integration