Form Attribution Tracking
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 Source – Traffic source (google, facebook, direct, etc.) 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) JavaScript + PHP Fallback – Dual-layer tracking ensures data capture even if JavaScript is disabled Dynamic Form Support – Mutation observer watches for forms loaded via AJAX UTM Parameter Detection – Automatically parses and stores all UTM parameters Intelligent Source Categorization – Recognizes and categorizes traffic from Google, Facebook, LinkedIn, and 15+ other platforms Universal Form Plugin Support Works seamlessly with: – Gravity Forms – Fluent Forms – Formidable Forms Modular architecture makes it easy to extend to other form plugins. Comprehensive Admin Dashboard Statistics Dashboard – View submission counts, attribution source distribution, and recent activity 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 Visitor Arrives – When someone visits your site, the JavaScript tracking code immediately captures: All UTM parameters from the URL Google Click ID (GCLID) if present HTTP referrer to determine traffic source Current page URL as landing page Current timestamp Attribution Stored – All data is packaged as JSON and stored in a first-party cookie with your configured expiration (default 30 days) First-Touch Persistence – If the visitor returns multiple times before converting, the original attribution data is preserved (not overwritten) Form Submission – When the visitor fills out a form, the tracking code automatically: Reads the stored attribution data Populates hidden fields in the form Submits with the complete attribution chain PHP 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: Forms will capture the GCLID parameter automatically from your ad URLs Export your form submissions (including attribution fields) as CSV In Google Ads, navigate to Tools → Conversions → Uploads Create a conversion action using the GCLID field to match conversions Upload your leads with timestamps and GCLIDs Google 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(); // Access configuration const config = window.FormAttributionTracking.config; ` JavaScript Events Listen for when attribution data is populated: `javascript window.addEventListener(‘attributionDataPopulated’, function(event) { console.log(‘Attribution captured:’, event.detail.attribution); console.log(‘Fields populated:’, event.detail.fieldsCount); }); ` PHP Hooks and Filters Extend or customize the plugin: `php // Add custom form plugin integration add_filter(‘attribution_tracking_integrations’, function($integrations) { $integrations[‘CustomForms’] = new CustomFormsIntegration(); return $integrations; }); // React to integration initialization add_action(‘attribution_tracking_integration_initialized’, function($integration_name) { error_log(“Attribution tracking initialized for: ” . $integration_name); }); // Hook into debug logging add_action(‘form_referral_source_debug_log’, function($message, $context, $source) { error_log(“[$source] $message: ” . print_r($context, true)); }, 10, 3); ` Attribution Field Names The plugin creates these hidden fields in your forms: attribution_source – Traffic source identifier attribution_medium – Marketing medium attribution_campaign – Campaign name attribution_term – Keyword/search term attribution_content – Ad content variation attribution_gclid – Google Ads Click ID attribution_landing_page – First page visited attribution_timestamp – ISO 8601 timestamp of first visit All fields are automatically populated by JavaScript and have PHP fallbacks. Traffic Source Detection The plugin intelligently categorizes traffic sources: UTM Parameters (Highest Priority) If UTM parameters are present in the URL, they are captured exactly as provided. Known Platforms (Automatic Categorization) The plugin recognizes and categorizes referrers from: – Google (google.com, google.co.uk, etc.) – Facebook (facebook.com, fb.com, m.facebook.com) – Twitter/X (twitter.com, x.com, t.co) – LinkedIn (linkedin.com, lnkd.in) – YouTube (youtube.com, youtu.be) – Instagram (instagram.com) – TikTok (tiktok.com) – Pinterest (pinterest.com, pin.it) – Reddit (reddit.com) – Bing (bing.com) – Yahoo (yahoo.com) – DuckDuckGo (duckduckgo.com) Generic Referrals For unlisted referrers, the clean hostname is stored (e.g., “example.com”) Direct Traffic When no referrer or UTM parameters are present, traffic is marked as “direct” Troubleshooting Attribution Data Not Being Captured Enable Debug Mode in plugin settings Open browser console (F12) and check for “[Referral Source]” log messages Verify cookies are enabled in the browser Check that JavaScript is not being blocked Fields Not Populating in Forms Enable Debug Mode and check console for “Field populated” messages Verify the form fields exist (check Manage Forms tab) Test with a fresh browser/incognito window Check that the form HTML includes the expected hidden field names Forms Not Showing in Dashboard Verify your form plugin (Gravity Forms, Fluent Forms, or Formidable Forms) is active Check that you have forms created in that plugin Look for PHP errors in debug.log if WP_DEBUG is enabled GCLID Not Being Captured Verify your Google Ads URLs include the {gclid} parameter Use Google’s Campaign URL Builder to test: https://ga-dev-tools.google/campaign-url-builder/ Check that cookies are working (GCLID is stored in the attribution cookie) Enable Debug Mode to see what parameters are being captured Extending the Plugin Adding Support for Other Form Plugins Create a new integration class: `php <?php namespace FormAttributionTracking\Integrations; 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): bool { // Implement logic to add hidden fields to forms } public function removeReferralSourceField(int $formId): bool { // Implement logic to remove hidden fields } public function hasReferralSourceField(int $formId): bool { // Check if form has attribution fields } public function getAllForms(): array { // Return array of all forms } } ` Register your integration: `php add_filter(‘attribution_tracking_integrations’, function($integrations) { $integrations[‘CustomFormPlugin’] = new CustomFormPluginIntegration(); return $integrations; }); ` Architecture The plugin uses a clean, modern PHP 8+ architecture: ` src/ ├── Contracts/ │ └── FormIntegrationInterface.php # Interface all integrations must implement ├── Abstracts/ │ └── AbstractFormIntegration.php # Base class with common functionality ├── Integrations/ │ ├── GravityFormsIntegration.php # Gravity Forms support │ ├── FluentFormsIntegration.php # Fluent Forms support │ └── FormidableFormsIntegration.php # Formidable Forms support ├── Views/ │ └── admin-page.php # Admin dashboard template └── Plugin.php # Main plugin orchestration class ` Privacy & Compliance This plugin stores first-party cookies to maintain attribution data. Consider these compliance aspects: Cookie Duration: Configurable 1-365 days (default 30) Data Stored: Marketing attribution data only (no PII) First-Party Cookies: Data stays on your domain User Control: Respects browser cookie settings GDPR: Consider adding cookie consent notices per your requirements Data Retention: Attribution data is only stored in form submissions per your form plugin’s data retention policies Support & Contributing For bug reports, feature requests, or contributions: Plugin Author: Ryan Howard Website: https://www.ryanhoward.dev Text Domain: form-attribution-tracking License This plugin is licensed under the GPL v2 or later.
Top keywords
- attribution52×3.27%
- form30×1.89%
- forms29×1.82%
- google25×1.57%
- data23×1.45%
- php18×1.13%
- source17×1.07%
- ads16×1.01%
- com16×1.01%
- tracking16×1.01%
- attribution data15×0.94%
- fields15×0.94%
Yoast SEO – Advanced SEO with real-time guidance and built-in AI
Real-time SEO guidance, schema, and AI built in. Help search engines and AI systems understand your content. All AI tools included, no hidden fees. Yoast SEO: the #1 WordPress SEO plugin Since 2008, Yoast SEO has helped site owners get their content found. More than 10 million websites now run it, from small local businesses to some of the most visited sites on the web. Our mission is SEO for everyone. You should not need a specialist, a big budget, or a technical background to give your content a fair chance of being discovered. Yoast SEO gives you everything you need to manage your on-site SEO. The Yoast SEO Premium plugin and its extensions unlock more advanced and AI-powered tools. Ready for search, and ready for AI People no longer only type queries into Google. They ask AI assistants, and those answers are built from content the AI has crawled, understood, and trusted. Yoast SEO helps you prepare for both. Schema.org structured data, so search engines and AI systems can understand what your content is actually about. Premium outputs significantly more schema types, including the E-E-A-T signals (experience, expertise, authoritativeness, and trustworthiness) that help AI systems understand who you are. Schema aggregation for NLWeb (Premium), which combines your site’s structured data into a single, deduplicated graph, so AI agents get a complete picture of your content in one request. Turn it on with a single toggle. LLMs.txt management, to guide how large language models interact with your content, including manual control over which pages are included. Bot blocker (Premium), to control which AI crawlers can use your content for training, including GPTBot, CCBot, and Google-Extended. Abilities API, so AI tools, dashboards, and automated workflows can read your SEO, readability, and inclusive language scores directly. Algorithm changes have been arriving for over 15 years, and Yoast has tracked every one of them. Keeping the plugin updated means you benefit from ongoing technical improvements, schema updates, and AI advancements automatically, all guided by our signature traffic light approach. Real-time guidance while you write SEO is one of the most consistent and cost-effective sources of website traffic, though it can be complex. Whether you are just starting out or you have done this for years, Yoast SEO tells you what to fix before you publish, not after. Red, orange, green. That is the whole idea. You get in-depth content and readability analysis that helps you create content designed to perform well in search, without needing to learn a new discipline first. Quick and easy setup Setting up Yoast SEO is quick and straightforward. No technical background required. Our step-by-step configuration wizard walks you through the essentials, so Yoast SEO can generate accurate structured data that helps search engines understand your site. Switching from another SEO plugin? Migration is seamless. You can import your existing SEO data and settings safely with our built-in import and export tools. AI tools built into your workflow Yoast’s AI tools come with Yoast SEO Premium, and they sit inside the editor you already use. There is no separate AI subscription, no extra login, and no credit top-up to buy. Every suggestion waits for your approval before anything saves. Yoast AI Generate: creates five SEO-friendly titles and meta descriptions instantly, with one-click regeneration for more options. Yoast AI Optimize: suggests improvements to keyphrase placement, including introduction, distribution, and density, with the option to apply or dismiss each edit. Yoast AI Summarize: generates a quick summary of your post to place anywhere in the block editor, so readers grasp the value fast. Yoast AI Content Planner (Premium): suggests five site-specific post ideas and builds a structured starter draft the moment you open a new post. Ideas are grounded in your own site, not generic topics, so your team never begins from a blank page. Bulk editor with AI drafts: review and fix titles, meta descriptions, and focus keyphrases across your whole site from one workspace, with search and status filters and a dedicated view per content type. The bulk editor is free. With Premium, select what needs work and AI drafts the metadata, including social sharing titles and descriptions, for you to approve. All AI tools included: no extra accounts, no separate credit purchase, no hidden costs. Content analysis and optimization SEO analysis to guide your keyword targeting, with up to 5 keyphrases in Premium and support for 20+ languages. Readability analysis for clear, engaging, user-friendly writing. Inclusive language analysis, so your content is more considerate and accessible. SERP previews for both desktop and mobile results. HowTo and FAQ blocks with built-in schema support. Breadcrumbs block for improved navigation. Semrush integration for keyword research directly inside Yoast SEO. Wincher integration to track keyword performance from your dashboard. Elementor integration for optimization inside your favorite builder. Technical SEO, handled for you Yoast SEO takes care of much of your site’s technical SEO automatically, which frees you to focus on your content. Automated meta tag optimization right out of the box. Canonical URLs to prevent duplicate content issues. Advanced XML sitemaps for clear site indexing. Deep Schema.org integration to improve how search engines and AI systems understand your site. Complete breadcrumb control for visitors and crawlers. Performance improvements that help reduce load times. Crawl settings to manage how bots access your site and reduce unnecessary server load. Every update delivers ongoing technical SEO enhancements automatically. Keep your website in perfect shape Whether you are a creator, a business owner, or a developer, Yoast SEO helps you maintain your site’s SEO health: Cornerstone content tools to organize and prioritize your key pages. Front-end SEO inspector to view and edit titles, descriptions, and schema live. SEO roles to delegate plugin access securely across your team. Regular 2-week update cycle, so you stay compatible with the latest SEO standards and search engine changes. Powerful integrations Yoast SEO works seamlessly with popular WordPress tools: Google Site Kit: access insights from Search Console, Analytics, and PageSpeed inside WordPress. Advanced Custom Fields (ACF): combine with ACF Content Analysis for Yoast SEO for advanced field optimization. Elementor: use full Yoast SEO functionality inside Elementor’s editor. Algolia: improve internal search accuracy and performance. Semrush: discover and optimize for high-value keywords. Wincher: track keyword positions and trends in Google Search. Jetpack: manage SEO and social previews in one place. Easy Digital Downloads (EDD): improve digital product visibility with integrated schema. Mastodon: verify your website on Mastodon with Yoast SEO Premium. WooCommerce: optimize ecommerce SEO with the dedicated WooCommerce extension. Yoast SEO Premium: AI-powered SEO for WordPress Yoast SEO Premium builds on everything above with advanced automation, AI tools, and professional support. It helps you optimize efficiently for both traditional search and AI-driven discovery. What it helps you tackle: Keeping pace with algorithm changes and AI search. Reaching the right audience. Automating redirects, crawl controls, and internal linking. Finding orphaned content and improving your site structure. Getting expert help when you need it. Premium highlights: AI-generated titles and meta descriptions, page by page or in bulk. AI Content Planner, so you never open a blank page. Smart internal linking suggestions to strengthen your site structure. Social previews for Facebook and X. Redirect manager with bulk tools, CSV import and export, and automatic prompts when you move or delete content. Bot blocker for AI crawlers, including GPTBot, CCBot, and Google-Extended. Schema aggregation for NLWeb, plus significantly more schema types than free. IndexNow integration, so search engines hear about your updates the moment you publish. Front-end SEO inspector for real-time editing. SEO workouts for orphaned and cornerstone content. Task list, unlocked in full, showing what to work on next with priority levels and time estimates. Google Docs add-on, so writers can run the full Yoast analysis before content ever reaches WordPress. One seat included. 24/7 premium support from SEO specialists. Included at no extra cost: Yoast Local SEO: help nearby customers find you, with local schema, a store locator, and opening hours management. Yoast Video SEO: help Google understand your videos, with video sitemaps and schema. Yoast News SEO: help your news content get discovered in Google News and Top Stories. Yoast WooCommerce SEO: advanced SEO for online stores Yoast WooCommerce SEO builds on Yoast SEO Premium with ecommerce-specific tools for your store’s visibility. Key ecommerce features: WooCommerce-specific XML sitemap that excludes non-shopping content. Product structured data for rich results, including price, reviews, and availability. Canonical URL management to prevent duplicates. Ecommerce-focused content analysis for GTINs, SKUs, and short descriptions. AI Generate for ecommerce: optimized titles and meta descriptions for product and category pages, at page level or drafted in bulk for products and categories. What that gets you: Better product visibility through automated structured data. More efficient crawling for large catalogs. Time saved through metadata templates and automation. Metadata across your whole catalog without editing rows one at a time. Built for WooCommerce, trusted by thousands of online stores worldwide. For developers Yoast SEO is built with developers in mind. With modern APIs, hooks, and a unified indexables system, you can extend or integrate SEO functionality across custom themes, plugins, or headless setups. REST API Retrieve SEO metadata for any post or URL, including meta tags, Open Graph, Twitter Cards, and Schema.org data. Learn more about the REST API. Surfaces API Access SEO data directly in code via YoastSEO()->meta->for_current_page(). Supports titles, descriptions, canonicals, and schema. Read the Surfaces API documentation. Metadata API Use the Metadata API to filter, override, or extend meta tags with WordPress hooks such as wpseo_title, wpseo_metadesc, and wpseo_canonical. Schema API The Schema API lets you modify or extend Schema.org graph pieces, including Article, Organization, Person, Breadcrumb, and WebPage entities. Abilities API integration Let AI tools, dashboards, and automated workflows read Yoast SEO data programmatically, including SEO, readability, and inclusive language scores for recent posts. Block editor compatibility Yoast SEO integrates directly with the WordPress block editor. It outputs schema for HowTo and FAQ blocks by default, and you can extend schema for custom blocks. Indexables At the core of Yoast SEO lies the indexables system, unifying all SEO data for faster queries and consistent metadata across outputs. Ongoing support and education Yoast is powered by expert developers, testers, and SEO specialists who keep improving the plugin. We are committed to helping you grow your SEO skills: Yoast SEO Academy: free and premium SEO courses, included in all paid plans. Yoast SEO blog, newsletter, and webinars. Yoast SEO Update podcast for the latest SEO insights. Bug reports on GitHub, for issue tracking rather than support. Yoast SEO: built to make search optimization accessible, reliable, and ready for the future of AI search.