FirstPromoter

<p>FirstPromoter for WordPress allows you to easily integrate FirstPromoter’s affiliate tracking scripts with your WordPress website.</p>
<p>With this plugin, you can track referrals, registrations, and sales across your website, with special integrations for popular platforms.</p>
<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>
<p>When enabled, the WooCommerce integration allows you to:</p>
<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>
<p>The OptimizePress integration tracks form submissions and captures emails for referral tracking.</p>
<h4>Contact Form 7 Integration</h4>
<p>When enabled, the Contact Form 7 integration allows you to:</p>
<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><strong>Requires API key</strong> – uses server-side tracking</li>
</ul>
<h4>MemberPress Integration</h4>
<p>When enabled, the MemberPress integration allows you to:</p>
<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>
<p><strong>Important</strong>: If you’re using FirstPromoter’s Stripe integration, only enable signup tracking. Leave sale tracking OFF to avoid duplicate sales.</p>
<h4>Custom Form Tracking</h4>
<p>When enabled, the Custom Form Tracking integration allows you to:</p>
<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>
<p>When enabled, the URL Email Capture integration allows you to:</p>
<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>
<p>When enabled, the Payment Links integration allows you to:</p>
<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>
<p>After activation, you’ll find a new menu item in your WordPress admin dashboard labeled “FirstPromoter”.</p>
<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>
<p>The FirstPromoter API key is <strong>required</strong> for the following features:</p>
<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>
<p>The following features work <strong>without</strong> an API key:</p>
<ul>
<li>WooCommerce signup tracking</li>
<li>WooCommerce checkout email capture</li>
<li>OptimizePress integration</li>
<li>MemberPress signup tracking (without sales)</li>
</ul>
<p>You can find your API key in your FirstPromoter dashboard: Settings > Integrations > Manage API keys</p>
<h4>Integration Settings</h4>
<p>The plugin supports multiple types of integrations:</p>
<ol>
<li><strong>WooCommerce Integration</strong>: Track new account registrations and checkouts</li>
<li><strong>OptimizePress Integration</strong>: Track form submissions</li>
<li><strong>Contact Form 7 Integration</strong>: Track contact form submissions with email capture</li>
<li><strong>MemberPress Integration</strong>: Track member signups, transactions, and recurring payments</li>
<li><strong>Custom Form Tracking</strong>: Track email submissions from any form using CSS selectors</li>
<li><strong>URL Email Capture</strong>: Capture referrals from thank you pages where the email is in the URL</li>
<li><strong>Payment Links</strong>: Automatically append the tracking ID to payment links on your pages</li>
</ol>
<p>Enable the integrations that apply to your website and configure their specific settings.</p>
<h3>External Services</h3>
<p>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.</p>
<h4>FirstPromoter Tracking Service</h4>
<p><strong>What it is:</strong> FirstPromoter’s affiliate tracking platform that monitors referral activity and conversions.</p>
<p><strong>What data is sent:</strong><br />
– Email addresses (for referral tracking)<br />
– User IDs (when available)<br />
– Order information including amount, order ID, and coupon codes (when WooCommerce sales tracking is enabled)<br />
– Page visit information for referral attribution</p>
<p><strong>When data is sent:</strong><br />
– Every time a page loads (for referral attribution via JavaScript tracking)<br />
– When users register or create accounts (if integration is enabled)<br />
– When purchases are completed (if WooCommerce integration is enabled)<br />
– When custom tracking events are triggered</p>
<p><strong>Service provider:</strong> FirstPromoter (https://firstpromoter.com)<br />
– Terms of Service: https://firstpromoter.com/terms<br />
– Privacy Policy: https://firstpromoter.com/privacy<br />
– API Documentation: https://docs.firstpromoter.com/api-reference-v2/</p>
<h4>FirstPromoter CDN Service</h4>
<p><strong>What it is:</strong> Content delivery network that serves the FirstPromoter tracking JavaScript library.</p>
<p><strong>What data is sent:</strong> Standard web request data (IP address, user agent, referrer)</p>
<p><strong>When data is sent:</strong> On every page load where tracking is active</p>
<p><strong>Service details:</strong><br />
– CDN URL: https://cdn.firstpromoter.com/fpr.js<br />
– v2 API Endpoints: https://api.firstpromoter.com/api/v2/track/*<br />
– This is required for the tracking functionality to work</p>
<h3>Technical Details</h3>
<p>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:</p>
<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.

FirstPromoter vs WC Affiliate – WooCommerce Affiliate Plugin