Tracking Overview

Affitor tracking captures the complete customer journey—from the first click on an affiliate link to the final purchase.

---

How Tracking Works

When a partner shares their affiliate link, Affitor tracks three key events:

Event	What it captures	When it fires
Click	Visitor arrives via affiliate link	Page load with ?ref= parameter
Signup	Visitor registers or submits a form	Your signup form completion
Sale	Customer completes purchase	Stripe payment success

Each event is linked together using tracking cookies, so you always know which partner drove which sale.

---

The Tracking Flow

graph LR
    A[Partner Shares Link] --> B[Customer Clicks]
    B --> C[Visits Site]
    C --> D[Signs Up]
    D --> E[Purchases]

    A -.->|Unique ?ref= URL| A1[Unique link]
    B -.->|Cookie set| B1[Click tracked]
    C -.->|60 day cookie| C1[Cookie persists]
    D -.->|trackLead called| D1[Lead tracked]
    E -.->|Stripe metadata| E1[Sale tracked]

Step by step:

1. Partner gets unique link: https://yoursite.com?ref=PARTNER123
2. Customer clicks: Affitor script detects ?ref= parameter
3. Cookie stored: customer_code saved (60-days lifetime)
4. Customer browses: Cookie persists across sessions
5. Customer signs up: You call trackLead() with user_id → linked to customer
6. Customer purchases: Stripe metadata with user_id captures sale → commission created

---

What You Need to Implement

Three integrations connect your site to Affitor:

Integration	Purpose	Difficulty
Pageview Tracker	Track clicks from affiliate links	Easy – npm install or one script tag
Lead Tracking	Track signups and registrations	Easy – one function call
Payment Tracking	Track sales via Stripe	Medium – metadata setup

Most advertisers complete all three in under 30 minutes.

Choose Your Integration Method

Method	Install	Best for
npm SDK (@affitor/tracker)	npm install @affitor/tracker	React, Next.js, Vue, any JS/TS app
Script tag	Copy-paste <script> tag	Static HTML, WordPress, no-build sites

Both methods provide the same tracking functionality. The npm SDK adds TypeScript types, Promise-based loading, and React hooks.

---

Attribution

How Attribution Works

Affitor uses last-click attribution with cookie-based tracking.

When a customer clicks an affiliate link:

1. customer_code created and stored in cookie
2. Customer-partner relationship created in database
3. Cookie lasts 60 days
4. Attribution window is 60 days from first click
5. Any purchase within window credits that partner

Multiple Clicks

If a customer clicks Partner A’s link, then later clicks Partner B’s link:

• Partner B gets credit (last-click wins)
• Cookie is overwritten with new customer code

---

Tracking Data

What Affitor Captures

Data	Source	Purpose
customer_code	Auto-generated on first click	Identify visitor & link events together
program_id	Your program ID	Route to correct program
Timestamp	Automatic	When event occurred
User agent	Browser	Analytics
IP address	Request	Fraud detection

Cookie Storage

Cookie	Value	Lifetime
customer_code	Unique visitor ID	60 days

Cookies are set automatically by the tracker script. No action required.

---

Privacy & Compliance

GDPR Considerations

Affitor tracking uses first-party cookies on your domain. You should:

1. Include in cookie policy: Mention affiliate tracking cookies
2. Cookie consent: If required in your jurisdiction, include in consent flow
3. Data retention: Tracking data follows your Affitor program settings

No Third-Party Tracking

Affitor doesn’t:

• Use third-party cookies
• Share data with ad networks
• Track users across other sites

---

Next Steps

Set up tracking in order:

1. Pageview Tracker – Capture clicks (5 minutes)
2. Lead Tracking – Capture signups (10 minutes)
3. Payment Tracking – Capture sales (15 minutes)