FirstPromoter

FirstPromoter for WordPress allows you to easily integrate FirstPromoter’s affiliate tracking scripts with your WordPress website.
With this plugin, you can track referrals, registrations, and sales across your website, with special integrations for popular platforms.
<h4>Features</h4>
<ul>
<li>Add FirstPromoter tracking to your WordPress site</li>
<li>WooCommerce integration – track new account registrations and checkouts</li>
<li>OptimizePress integration – track form submissions</li>
<li>Contact Form 7 integration – track form submissions with email capture</li>
<li>MemberPress integration – track member signups, transactions, and recurring payments</li>
<li>Custom Form Tracking – track email submissions from any form using CSS selectors</li>
<li>URL Email Capture – capture referrals from thank you pages where the email is in the URL</li>
<li>Payment Links – automatically append the FirstPromoter tracking ID to payment links on your pages</li>
<li>Cross-domain tracking support</li>
<li>Automatically send sales data to FirstPromoter (WooCommerce, MemberPress)</li>
<li>Automatic refund and cancellation tracking (WooCommerce)</li>
<li>Track recurring subscription payments (MemberPress)</li>
<li>Force tracking bypass for privacy browsers and ad-blockers</li>
</ul>
<h4>WooCommerce Integration</h4>
When enabled, the WooCommerce integration allows you to:
<ul>
<li>Capture emails when users create new accounts</li>
<li>Capture emails at checkout</li>
<li>Automatically send sale information to FirstPromoter</li>
<li>Track refunds and generate negative commissions</li>
<li>Track order cancellations and update customer status</li>
</ul>
<h4>OptimizePress Integration</h4>
The OptimizePress integration tracks form submissions and captures emails for referral tracking.
<h4>Contact Form 7 Integration</h4>
When enabled, the Contact Form 7 integration allows you to:
<ul>
<li>Track form submissions automatically (all forms tracked)</li>
<li>Capture email addresses from any field containing “email” in its name</li>
<li>Attribute form leads to the correct referral source</li>
<li>Requires API key – uses server-side tracking</li>
</ul>
<h4>MemberPress Integration</h4>
When enabled, the MemberPress integration allows you to:
<ul>
<li>Track new member signups and registrations (always enabled)</li>
<li>Automatically send transaction data to FirstPromoter (requires API key)</li>
<li>Track recurring subscription payments (requires API key)</li>
<li>Associate members with their referral source</li>
<li>API sale tracking uses prefixed user IDs (“mepr-“) to prevent conflicts</li>
</ul>
Important: If you’re using FirstPromoter’s Stripe integration, only enable signup tracking. Leave sale tracking OFF to avoid duplicate sales.
<h4>Custom Form Tracking</h4>
When enabled, the Custom Form Tracking integration allows you to:
<ul>
<li>Track email submissions from any form on your site — no plugin dependency required</li>
<li>Works with any form builder, custom HTML forms, or dynamically loaded popups</li>
<li>Configure CSS selector pairs: one for the email input, one for the submit button or form element</li>
<li>Supports multiple forms with separate selector pairs</li>
<li>Uses MutationObserver to handle dynamically loaded forms (popups, AJAX-injected content)</li>
<li>AJAX fallback for ad-blocker bypass when force tracking is enabled</li>
</ul>
<h4>URL Email Capture</h4>
When enabled, the URL Email Capture integration allows you to:
<ul>
<li>Track referrals from thank you pages where the email is passed as a URL query parameter</li>
<li>Useful when your checkout, funnel, or external platform redirects to a confirmation page with the customer’s email in the URL (e.g. <code>/thank-you?email=user@example.com</code>)</li>
<li>Configure the URL parameter key for the email (e.g. <code>email</code>)</li>
<li>Optionally configure a second parameter key for the user ID (e.g. <code>uid</code>)</li>
<li>No plugin dependency required — works on any WordPress page</li>
</ul>
<h4>Payment Links</h4>
When enabled, the Payment Links integration allows you to:
<ul>
<li>Automatically append the FirstPromoter tracking ID to payment links on your pages as the <code>client_reference_id</code> parameter</li>
<li>Works with Stripe <code>buy.stripe.com</code> links, custom Stripe checkout domains, or any direct payment URL</li>
<li>Configure the URL prefix to match — defaults to <code>https://buy.stripe.com/</code>, supports comma-separated multiple prefixes</li>
<li>Uses MutationObserver to handle dynamically added links (popups, AJAX-injected content)</li>
<li>No plugin dependency required — works on any WordPress page</li>
</ul>
<h3>Configuration</h3>
After activation, you’ll find a new menu item in your WordPress admin dashboard labeled “FirstPromoter”.
<h4>Base Configuration</h4>
<ol>
<li>Navigate to the FirstPromoter settings page in your WordPress admin</li>
<li>Enter your FirstPromoter Account ID (required)</li>
<li>Enter your API key (required for most integrations – see below)</li>
<li>If you want to track across multiple domains, enter them in the Cross Domain field, separated by commas</li>
<li>Click “Save” to store your settings</li>
</ol>
<h4>API Key Requirements</h4>
The FirstPromoter API key is required for the following features:
<ul>
<li>Contact Form 7 integration (all tracking)</li>
<li>WooCommerce sale tracking</li>
<li>MemberPress sale tracking</li>
<li>MemberPress recurring payment tracking</li>
</ul>
The following features work without an API key:
<ul>
<li>WooCommerce signup tracking</li>
<li>WooCommerce checkout email capture</li>
<li>OptimizePress integration</li>
<li>MemberPress signup tracking (without sales)</li>
</ul>
You can find your API key in your FirstPromoter dashboard: Settings > Integrations > Manage API keys
<h4>Integration Settings</h4>
The plugin supports multiple types of integrations:
<ol>
<li>WooCommerce Integration: Track new account registrations and checkouts</li>
<li>OptimizePress Integration: Track form submissions</li>
<li>Contact Form 7 Integration: Track contact form submissions with email capture</li>
<li>MemberPress Integration: Track member signups, transactions, and recurring payments</li>
<li>Custom Form Tracking: Track email submissions from any form using CSS selectors</li>
<li>URL Email Capture: Capture referrals from thank you pages where the email is in the URL</li>
<li>Payment Links: Automatically append the tracking ID to payment links on your pages</li>
</ol>
Enable the integrations that apply to your website and configure their specific settings.
<h3>External Services</h3>
This plugin connects to FirstPromoter’s external services to provide affiliate and referral tracking functionality. It’s essential for the plugin’s operation to track referrals, registrations, and sales.
<h4>FirstPromoter Tracking Service</h4>
What it is: FirstPromoter’s affiliate tracking platform that monitors referral activity and conversions.
What data is sent: 
– Email addresses (for referral tracking) 
– User IDs (when available) 
– Order information including amount, order ID, and coupon codes (when WooCommerce sales tracking is enabled) 
– Page visit information for referral attribution
When data is sent: 
– Every time a page loads (for referral attribution via JavaScript tracking) 
– When users register or create accounts (if integration is enabled) 
– When purchases are completed (if WooCommerce integration is enabled) 
– When custom tracking events are triggered
Service provider: FirstPromoter (https://firstpromoter.com) 
– Terms of Service: https://firstpromoter.com/terms 
– Privacy Policy: https://firstpromoter.com/privacy 
– API Documentation: https://docs.firstpromoter.com/api-reference-v2/
<h4>FirstPromoter CDN Service</h4>
What it is: Content delivery network that serves the FirstPromoter tracking JavaScript library.
What data is sent: Standard web request data (IP address, user agent, referrer)
When data is sent: On every page load where tracking is active
Service details: 
– CDN URL: https://cdn.firstpromoter.com/fpr.js 
– v2 API Endpoints: https://api.firstpromoter.com/api/v2/track/* 
– This is required for the tracking functionality to work
<h3>Technical Details</h3>
This plugin works by adding the FirstPromoter tracking script to your website and handling various trigger points for tracking registrations, checkouts, and custom events. The plugin:
<ol>
<li>Adds the base FirstPromoter tracking script to all pages</li>
<li>Captures and tracks user emails at registration and checkout (when enabled)</li>
<li>Supports cross-domain tracking</li>
<li>Can send WooCommerce sales data directly to FirstPromoter’s API</li>
</ol>

Integrate FirstPromoter's affiliate tracking with WooCommerce, OptimizePress, Contact Form 7, MemberPress, and any custom form or thank you page.

Pippin Williamson

Andrew Munro / AffiliateWP

Aubrey Portwood

Affiliate Info allows you to show affiliate information based on the affiliate 
currently being tracked. When a user clicks an affiliate’s referral URL and 
arrives on your website, the affiliate’s ID is stored by AffiliateWP. 
Affiliate Info simply shows information based on the tracked affiliate.
Let’s say you have an affiliate named John who shares his referral URL. 
Any user that clicks on John’s referral link can now see a variety of information 
about John, anywhere on your website.
You can show:
<ul>
<li>John’s WordPress display name</li>
<li>John’s website URL</li>
<li>John’s email address (be careful with this!)</li>
<li>John’s gravatar image</li>
<li>John’s WordPress username</li>
<li>John’s biographical info (from his WordPress profile)</li>
<li>John’s Twitter username</li>
<li>John’s Facebook URL</li>
<li>John’s Google+ URL</li>
</ul>
There are currently 9 shortcodes to show the information above:
<ol>
<li>[affiliate_info_name]</li>
<li>[affiliate_info_website]</li>
<li>[affiliate_info_email]</li>
<li>[affiliate_info_gravatar]</li>
<li>[affiliate_info_username]</li>
<li>[affiliate_info_bio]</li>
<li>[affiliate_info_twitter]</li>
<li>[affiliate_info_facebook]</li>
<li>[affiliate_info_googleplus]</li>
</ol>
There’s also 2 shortcodes that you can embed the above in:
<ol>
<li>[affiliate_info_referred] – show content only when an affiliate is being tracked</li>
<li>[affiliate_info_not_referred] – show content only when an affiliate is not being tracked. Useful for providing a fallback.</li>
</ol>
If you’re a developer you can access this information directly with some useful 
PHP functions.
Affiliate Info also works in tandem with AffiliateWP’s Credit Last Referrer option 
which means the information will change each time a new referral URL is used.
Some potential uses for this add-on include:
Showing the customer who referred them
Show a custom message based on the affiliate being tracked. For example, 
“You’ve been referred by John” or “Your site representative is John”.
For example:
Your site representative is [affiliate_info_name]
If no affiliate is being tracked it will just show “Your site representative is ” 
so use the [affiliate_info_referred] shortcode to make sure nothing is shown when 
no affiliate is being tracked.
For example:
[affiliate_info_referred]Your site representative is [affiliate_info_name][/affiliate_info_referred]
Allow the site visitor to contact the affiliate
There may be instances where your affiliates are in direct contact with your customers. Show the affiliate’s email address, or add a form (Gravity Forms or another form plugin) which sends an email to the affiliate being tracked.
Note, if you’re going to show any form of email address out in the wild, make sure you protect it using one of the many plugins available on the WordPress repo.
Create a landing page
Create a landing page for your products that show the current tracked affiliate’s information. This is especially useful if an affiliate does not have a website, or you want more control over how your products are advertised. Affiliates can link directly to your landing page with their referral URL, and their information will be displayed.
What is AffiliateWP?
<a href="https://affiliatewp.com/" title="AffiliateWP" rel="nofollow ugc">AffiliateWP</a> provides a complete affiliate management system for your WordPress website that seamlessly integrates with all major WordPress e-commerce and membership platforms. It aims to provide everything you need in a simple, clean, easy to use system that you will love to use.

AffiliateWP – Affiliate Info

Display information based on the affiliate's referral URL.

FirstPromoter vs AffiliateWP – Affiliate Info