Follow these steps to add Affonso affiliate tracking to your Next.js App Router application using the recommended Script component approach.
Add Tracking Script to Root Layout
Add the Affonso tracking script to your root layout file at app/layout.tsx
:
import Script from 'next/script';
export default function RootLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
<html lang='en'>
<head>
<Script
async
defer
src='https://affonso.io/js/pixel.min.js'
data-affonso='YOUR_PUBLIC_PROGRAM_ID'
data-cookie_duration='30'
strategy='afterInteractive'
/>
</head>
<body>{children}</body>
</html>
);
}
Next Steps
Once installed, you can access affiliate referral data and pass it to your payment provider. Learn how to integrate with your payment provider →
Testing
- Start your development server:
npm run dev
- Visit
localhost:3000?atp=test
- Check browser DevTools → Application → Cookies →
affonso_referral
- Deploy and verify tracking in your Affonso dashboard
Note: Tracking is disabled on localhost to avoid false data.