affiliatebase-tracking

Lightweight, zero-dependency affiliate tracking script for AffiliateBase. Cookie-based attribution, conversion tracking, and automatic Stripe integration.


Features

- Cookie-based referral attribution (30-day default)
- Multiple tracking parameters (?via=, ?ref=, ?affiliate=)
- Automatic Stripe Buy Button / Pricing Table integration
- Conversion tracking via email
- Promo code attribution
- Cross-domain link tagging
- Automatic form integration
- Zero dependencies, pure JavaScript (~26KB)

Quick Start

Add this snippet to your website's or before :

``html

async
src="https://cdn.jsdelivr.net/npm/affiliatebase-tracking@1/src/index.js"
data-org-id="YOUR_ORG_ID"
>
`

Replace YOUR_ORG_ID with your organization ID from the AffiliateBase dashboard.

That's it! The script will automatically track referrals from affiliate links.

Usage

$3

When a referred visitor signs up or makes a purchase, track the conversion:

`javascript
affiliatebase("convert", { email: "customer@example.com" });
`

$3

`javascript
affiliatebase("ready", () => {
if (window.AffiliateBase.referral) {
console.log("Referred by:", window.AffiliateBase.affiliate?.name);
}
});
`

$3

Add data-affiliatebase to your Stripe elements for automatic attribution:

`html




pricing-table-id="prctbl_xxx"
publishable-key="pk_live_xxx"
data-affiliatebase
>
`

$3

Add data-affiliatebase="true" to forms to automatically include referral data:

`html




Sign Up




`

Configuration

$3

| Attribute | Required | Description |
| --------------------------- | -------- | --------------------------------------- |
| data-org-id | Yes | Your organization ID |
| data-debug | No | Set to "true" for console logging |
| data-affiliatebase-params | No | Custom URL parameters (comma-separated) |

$3

The script automatically detects these URL parameters:

- ?via=TOKEN (primary)
- ?ref=TOKEN
- ?affiliate=TOKEN
- ?a=TOKEN
- ?referral=ID (preload existing referral)

Example affiliate link: https://yoursite.com?via=john123

API Reference

$3

`javascript
// Track conversion
affiliatebase("convert", { email: "customer@example.com" });

// Force attribution to specific affiliate
affiliatebase("source", "affiliate_token");

// Execute when loaded
affiliatebase("ready", () => {
console.log("Ready!");
});
`

$3

Access attribution data via window.AffiliateBase:

`javascript
window.AffiliateBase.referral; // Referral ID (UUID) or ""
window.AffiliateBase.affiliate; // Affiliate object or false
window.AffiliateBase.campaign; // Campaign object or false
window.AffiliateBase.coupon; // Coupon object or false
`

$3

`javascript
window.addEventListener("AffiliateBase.initialized", () => {
console.log("Tracking initialized");
});

window.addEventListener("AffiliateBase.tracked", (e) => {
console.log("Referral tracked:", e.detail.referral);
});
`

TypeScript

Type definitions are included:

`typescript
import "affiliatebase-tracking";

affiliatebase("convert", { email: "test@example.com" });

if (window.AffiliateBase.referral) {
console.log("Affiliate:", window.AffiliateBase.affiliate?.name);
}
``

Browser Support

- Chrome/Edge (last 2 versions)
- Firefox (last 2 versions)
- Safari (last 2 versions)
- iOS Safari (last 2 versions)

License

MIT

Links

- AffiliateBase
- Dashboard
- npm