Click Tracking

Click tracking is the first step in every Affitor integration. It detects affiliate visits, creates the click/customer relationship, and stores the browser identifier used by later signup and sale attribution.

What It DoesCopy Anchor Link

When someone lands on your site through an affiliate link such as:

https://yoursite.com?aff=PARTNER123

the tracker:

1. detects the ?aff= parameter
2. sends click data to Affitor
3. creates or updates the tracked customer relationship
4. stores affitor_click_id in a first-party cookie
5. makes later signup and sale attribution possible

That cookie value is later reused as:

• click_id in API payloads
• affitor_click_id in Stripe metadata

Choose Your Installation MethodCopy Anchor Link

npm SDKCopy Anchor Link

Install the tracker package:

npm install @affitor/sdk

React / Next.jsCopy Anchor Link

// app/providers.tsx — client component
'use client';
import { AffitorProvider } from '@affitor/sdk/react';

export function Providers({ children }: { children: React.ReactNode }) {
  return <AffitorProvider programId="YOUR_PROGRAM_ID">{children}</AffitorProvider>;
}
// wrap {children} with <Providers> once in app/layout.tsx

Child components read the loaded tracker with useAffitor() from @affitor/sdk/react. It returns null while the tracker is loading and during server rendering.

Any JS / TS appCopy Anchor Link

import { loadAffitor } from '@affitor/sdk';

const affitor = await loadAffitor('YOUR_PROGRAM_ID');

loadAffitor() loads the tracker script once and resolves to the tracker instance (the same object as window.affitor). It resolves to null during server rendering.

AstroCopy Anchor Link

Astro isn't React, so the React <AffitorProvider> shown above doesn't apply. Load the tracker from a client <script> in your shared layout:

---
// src/layouts/Layout.astro
---
<head>
  <!-- ... -->
  <script>
    import { loadAffitor } from '@affitor/sdk';
    loadAffitor('YOUR_PROGRAM_ID');
  </script>
</head>

Prefer a no-build install? Drop the Script Tag into the same <head> with Astro's is:inline directive, so Astro leaves the external script untouched:

<script
  is:inline
  src="https://api.affitor.com/js/affitor-tracker.js"
  data-affitor-program-id="YOUR_PROGRAM_ID">
</script>

Track referred signups the same way — call signup() from a client <script> after the user authenticates. See Lead Tracking (Signup).

Useful optionsCopy Anchor Link

Script TagCopy Anchor Link

<script
  src="https://api.affitor.com/js/affitor-tracker.js"
  data-affitor-program-id="YOUR_PROGRAM_ID"
  data-affitor-debug="false">
</script>

Required attributesCopy Anchor Link

How Affiliate Links WorkCopy Anchor Link

Affitor looks for the aff query parameter on landing URLs, for example:

https://yoursite.com?aff=PARTNER123
https://yoursite.com/pricing?aff=PARTNER123

When that parameter is present, the tracker records the click and creates the customer relationship used by signup and sale attribution.

Verifying InstallationCopy Anchor Link

Enable debug modeCopy Anchor Link

SDK:

import { loadAffitor } from '@affitor/sdk';
const affitor = await loadAffitor('YOUR_PROGRAM_ID', { debug: true });

With React, pass debug to the provider: <AffitorProvider programId="YOUR_PROGRAM_ID" debug>.

Script tag:

<script
  src="https://api.affitor.com/js/affitor-tracker.js"
  data-affitor-program-id="YOUR_PROGRAM_ID"
  data-affitor-debug="true">
</script>

What to verifyCopy Anchor Link

Open your browser console and network tab, then confirm:

• The tracker loads without errors
• Cookies can be written and read
• Affitor debug messages appear in the console
• Click or test-click activity appears in the dashboard or test-event tooling

Common IssuesCopy Anchor Link

No click data appearsCopy Anchor Link

Check:

• The tracker script loaded successfully
• The page was visited with a valid ?aff= parameter
• Your program ID is correct
• CSP rules or browser extensions are not blocking the script

Cookies are missingCopy Anchor Link

Check:

• The site is served over HTTPS in production
• Browser privacy tools are not blocking cookies
• The affiliate landing page executed the tracker before the visitor continued

Later signup/sale tracking failsCopy Anchor Link

This usually means one of the following:

• Click tracking did not run before the signup or sale event
• The browser session lost affitor_click_id between landing and conversion
• Signup/payment identifiers do not consistently match your internal customer ID

Next StepsCopy Anchor Link

Once click tracking is working, continue with:

• Lead Tracking
• Payment Tracking
• Testing Integration