Track the complete customer journey from first click to conversion with referral and Google Ads attribution data captured in your WordPress forms. Overview Form Attribution Tracking is a WordPress plugin that automatically captures and stores complete attribution data from Google Ads campaigns (and
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 6.0 and PHP 8.0.
SourceWordPress plugins · Nov 16, 2026
01 / Source details
Aboutthistool.
Track the complete customer journey from first click to conversion with referral and Google Ads attribution data captured in your WordPress forms.
Overview
Form Attribution Tracking is a WordPress plugin that automatically captures and stores complete attribution data from Google Ads campaigns (and other traffic sources) directly in form submissions. This enables you to connect specific leads back to their originating campaigns, keywords, and ads in Google Ads for accurate conversion tracking and ROI measurement.
The plugin uses first-touch attribution, meaning it captures the visitor’s original traffic source on their first visit and maintains that data through their entire journey until they convert via a form submission.
Key Features
Complete Google Ads Attribution Data
Automatically captures 8 attribution fields for every form submission:
Attribution Medium – Traffic medium (cpc, organic, referral, etc.)
Attribution Campaign – Campaign name from utm_campaign
Attribution Term – Keyword from utm_term
Attribution Content – Ad variation from utm_content
Google Click ID (GCLID) – Direct link to the specific Google Ads click
Landing Page – The first page the visitor landed on
First Click Timestamp – When the visitor first arrived
Google Ads Conversion Tracking
The Google Click ID (GCLID) field enables you to: – Import conversions directly back into Google Ads – Connect form submissions to specific ad clicks – Measure true campaign ROI based on actual leads/sales – Track the complete path from ad click to conversion – Attribute conversions to the exact keyword and ad that drove them
Smart Tracking Technology
First-Touch Attribution – Captures original source, not last-click
Cookie Persistence – Maintains attribution data across multiple sessions (configurable 1-365 days)
Form Management – See which forms have attribution tracking and bulk-add fields to all forms
Debug Mode – Browser console logging for troubleshooting
Flexible Configuration – Customize cookie duration and auto-add behavior
How It Works
Data Capture Flow
01Visitor Arrives – When someone visits your site, the JavaScript tracking code immediately captures: All UTM parameters from the URL
02Google Click ID (GCLID) if present
03HTTP referrer to determine traffic source
04Current page URL as landing page
05Current timestamp
06Attribution Stored – All data is packaged as JSON and stored in a first-party cookie with your configured expiration (default 30 days)
07First-Touch Persistence – If the visitor returns multiple times before converting, the original attribution data is preserved (not overwritten)
08Form Submission – When the visitor fills out a form, the tracking code automatically: Reads the stored attribution data
09Populates hidden fields in the form
10Submits with the complete attribution chain
11PHP Fallback – If JavaScript fails to populate fields, the PHP integration captures attribution server-side before form processing
Integration with Google Ads
To enable conversion imports in Google Ads:
12Forms will capture the GCLID parameter automatically from your ad URLs
13Export your form submissions (including attribution fields) as CSV
14In Google Ads, navigate to Tools → Conversions → Uploads
15Create a conversion action using the GCLID field to match conversions
16Upload your leads with timestamps and GCLIDs
17Google Ads will attribute the conversions to the exact campaigns, ad groups, keywords, and ads that generated them
This creates a closed feedback loop between your ad spend and actual business results.
Configuration
Settings
Access settings via Form Attribution Tracking → Settings :
Auto-add to new forms – Automatically adds all 8 attribution fields when new forms are created
Cookie Duration – How long to preserve first-touch attribution data (1-365 days, default 30)
Debug Mode – Enables detailed logging in browser console for troubleshooting
Managing Existing Forms
Use the Manage Forms tab to: – View all forms and their attribution tracking status – Bulk-add attribution fields to all existing forms with one click – See which forms already have tracking enabled
Statistics
The Statistics tab provides: – Total submissions tracked across all forms – Breakdown of traffic sources (Google, Facebook, Direct, etc.) – Recent form submissions with their attribution data – Forms-with-tracking count
Usage
For Marketers
Once installed and configured, the plugin works automatically. Every form submission will include complete attribution data that you can:
Export to CSV and upload to Google Ads for conversion tracking
Analyze in your CRM to understand which campaigns drive the best leads
Use to calculate true cost-per-lead and ROI by campaign
Review to optimize your landing pages and ad targeting
For Developers
JavaScript API
The plugin exposes a global API for programmatic access:
`javascript
// Get full attribution data object const attribution = window.FormAttributionTracking.getAttributionData(); // Returns: { utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, landing_page, timestamp }
// Get just the traffic source (legacy method) const source = window.FormAttributionTracking.getReferralSource();
// Manually trigger form field population window.FormAttributionTracking.populateFormFields();
use FormAttributionTracking\Abstracts\AbstractFormIntegration;
class CustomFormPluginIntegration extends AbstractFormIntegration { public function isAvailable(): bool { return class_exists(‘CustomFormPlugin’); }
public function getName(): string { return 'Custom Form Plugin'; } public function getVersion(): string { return '1.0.0'; } protected function registerHooks(): void { // Hook into your form plugin's save/render events add_action('custom_form_save', [$this, 'onFormSaved'], 10, 2); } public function addReferralSourceField(int $formId
02 / Source details
Gettingstarted.
Requirements
01WordPress 6.0 or higher
02PHP 8.0 or higher
03At least one supported form plugin (Gravity Forms, Fluent Forms, or Formidable Forms)
Setup Steps
04Upload the plugin files to /wp-content/plugins/form-attribution-tracking/
05Run composer install --no-dev in the plugin directory (if installing from source)
06Activate the plugin through the WordPress admin panel
07Navigate to Form Attribution Tracking in the WordPress admin menu
08Configure your settings (recommended: 30-day cookie duration, auto-add enabled)
09The plugin will automatically add attribution fields to new forms, or use the “Manage Forms” tab to add fields to existing forms
FinderPress Media Auditor helps site administrators scan for broken images, missing Media Library files, unreachable media URLs, and other media issues across WordPress content. Use it to audit images, video, audio, PDFs, featured images, and attachment files without sending scan data to an external
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati