內容簡介
FirstPromoter 外掛讓您輕鬆將 FirstPromoter 的聯盟追蹤腳本整合至您的 WordPress 網站，能夠追蹤推薦、註冊及銷售，並支援多個熱門平台的整合。
【主要功能】
• 將 FirstPromoter 追蹤添加至 WordPress 網站
• WooCommerce 整合，追蹤新帳號註冊及結帳
• OptimizePress 整合，追蹤表單提交
• Contact Form 7 整合，追蹤表單提交及電子郵件捕獲
• MemberPress 整合，追蹤會員註冊及交易
• 自訂表單追蹤，使用 CSS 選擇器追蹤電子郵件提交
外掛標籤
開發者團隊
原文外掛簡介
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.
Features
Add FirstPromoter tracking to your WordPress site
WooCommerce integration – track new account registrations and checkouts
OptimizePress integration – track form submissions
Contact Form 7 integration – track form submissions with email capture
MemberPress integration – track member signups, transactions, and recurring payments
Custom Form Tracking – track email submissions from any form using CSS selectors
URL Email Capture – capture referrals from thank you pages where the email is in the URL
Payment Links – automatically append the FirstPromoter tracking ID to payment links on your pages
Cross-domain tracking support
Automatically send sales data to FirstPromoter (WooCommerce, MemberPress)
Automatic refund and cancellation tracking (WooCommerce)
Track recurring subscription payments (MemberPress)
Force tracking bypass for privacy browsers and ad-blockers
WooCommerce Integration
When enabled, the WooCommerce integration allows you to:
Capture emails when users create new accounts
Capture emails at checkout
Automatically send sale information to FirstPromoter
Track refunds and generate negative commissions
Track order cancellations and update customer status
OptimizePress Integration
The OptimizePress integration tracks form submissions and captures emails for referral tracking.
Contact Form 7 Integration
When enabled, the Contact Form 7 integration allows you to:
Track form submissions automatically (all forms tracked)
Capture email addresses from any field containing “email” in its name
Attribute form leads to the correct referral source
Requires API key – uses server-side tracking
MemberPress Integration
When enabled, the MemberPress integration allows you to:
Track new member signups and registrations (always enabled)
Automatically send transaction data to FirstPromoter (requires API key)
Track recurring subscription payments (requires API key)
Associate members with their referral source
API sale tracking uses prefixed user IDs (“mepr-“) to prevent conflicts
Important: If you’re using FirstPromoter’s Stripe integration, only enable signup tracking. Leave sale tracking OFF to avoid duplicate sales.
Custom Form Tracking
When enabled, the Custom Form Tracking integration allows you to:
Track email submissions from any form on your site — no plugin dependency required
Works with any form builder, custom HTML forms, or dynamically loaded popups
Configure CSS selector pairs: one for the email input, one for the submit button or form element
Supports multiple forms with separate selector pairs
Uses MutationObserver to handle dynamically loaded forms (popups, AJAX-injected content)
AJAX fallback for ad-blocker bypass when force tracking is enabled
URL Email Capture
When enabled, the URL Email Capture integration allows you to:
Track referrals from thank you pages where the email is passed as a URL query parameter
Useful when your checkout, funnel, or external platform redirects to a confirmation page with the customer’s email in the URL (e.g. /[email protected])
Configure the URL parameter key for the email (e.g. email)
Optionally configure a second parameter key for the user ID (e.g. uid)
No plugin dependency required — works on any WordPress page
Payment Links
When enabled, the Payment Links integration allows you to:
Automatically append the FirstPromoter tracking ID to payment links on your pages as the client_reference_id parameter
Works with Stripe buy.stripe.com links, custom Stripe checkout domains, or any direct payment URL
Configure the URL prefix to match — defaults to https://buy.stripe.com/, supports comma-separated multiple prefixes
Uses MutationObserver to handle dynamically added links (popups, AJAX-injected content)
No plugin dependency required — works on any WordPress page
Configuration
After activation, you’ll find a new menu item in your WordPress admin dashboard labeled “FirstPromoter”.
Base Configuration
Navigate to the FirstPromoter settings page in your WordPress admin
Enter your FirstPromoter Account ID (required)
Enter your API key (required for most integrations – see below)
If you want to track across multiple domains, enter them in the Cross Domain field, separated by commas
Click “Save” to store your settings
API Key Requirements
The FirstPromoter API key is required for the following features:
Contact Form 7 integration (all tracking)
WooCommerce sale tracking
MemberPress sale tracking
MemberPress recurring payment tracking
The following features work without an API key:
WooCommerce signup tracking
WooCommerce checkout email capture
OptimizePress integration
MemberPress signup tracking (without sales)
You can find your API key in your FirstPromoter dashboard: Settings > Integrations > Manage API keys
Integration Settings
The plugin supports multiple types of integrations:
WooCommerce Integration: Track new account registrations and checkouts
OptimizePress Integration: Track form submissions
Contact Form 7 Integration: Track contact form submissions with email capture
MemberPress Integration: Track member signups, transactions, and recurring payments
Custom Form Tracking: Track email submissions from any form using CSS selectors
URL Email Capture: Capture referrals from thank you pages where the email is in the URL
Payment Links: Automatically append the tracking ID to payment links on your pages
Enable the integrations that apply to your website and configure their specific settings.
External Services
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.
FirstPromoter Tracking Service
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/
FirstPromoter CDN Service
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
Technical Details
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:
Adds the base FirstPromoter tracking script to all pages
Captures and tracks user emails at registration and checkout (when enabled)
Supports cross-domain tracking
Can send WooCommerce sales data directly to FirstPromoter’s API
