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%
Starter Templates – AI-Powered Templates for Elementor & Gutenberg
Starter Templates: AI Website Builder and Elementor Templates The future of website creation is here! With Starter Templates, you can create professional-looking websites in just minutes, powered by AI. Leverage the Starter Templates AI website builder to generate websites with: Stunning designs All relevant sections and pages High quality stock images to help engage visitors Compelling website copy tailored to your business Extensive customization options Say goodbye to spending days or weeks designing and building a website. With Starter Templates, you can build websites faster than ever with AI. Try the live demo of Starter Templates HIGHLIGHTS ★ WordPress AI website builder ★ Built-in AI assistant ★ Fast and easy to use ★ Large library of Elementor templates ★ Hundreds of WordPress block editor (Gutenberg) templates ★ 200+ Sections and block patterns ★ Supported page builders: Spectra, Elementor, WordPress editor ★ Fully customizable websites How Does Starter Template AI Website Builder Work? Starter Templates integrates with ZipWP, our amazing AI website building platform. It takes care of everything for you, from design to content generation. Let AI do the heavy lifting, so you can focus on your ideas! Our mission is to unlock the power of the internet for small businesses. Creating a website shouldn’t be difficult, and growing a business on the internet shouldn’t be complicated. With Starter Templates, you can create a stunning website in a matter of minutes. Simply describe your idea, and watch as a WordPress website is built before your eyes. Want to create a lightweight website for your business that also looks exceptional? Follow the steps below: Select the type of website you’re creating (portfolio, business site, landing page, or something else). Provide your business name. Describe your business. Use AI to refine your description prompt if you need to. The AI will suggest images based on your input. Select the images you want to use. Add your contact details and social media handles so people can interact. Choose the website structure from the options. Select any site features you need. The AI will generate a website in under 2 minutes. Customize your site as you see fit! Whether you’re a beginner with no website building experience, or a seasoned web designer, Starter Templates has you covered. All Features Starter Template has all the essentials you need to create amazing websites! AI Website Builder Thanks to the power of AI, you can create your dream website effortlessly. Our AI analyzes your business description and goals, then selects the perfect design, generates professional copy, and curates visuals to match your brand. No more wrestling with complex themes or plugins – just describe your idea and let AI do the rest! Lightning Fast Websites Starter Templates prioritizes speed and efficiency without compromising quality. Here’s what sets us apart: Optimized Code Pages created with Starter Templates have efficient code, and are free from all unnecessary elements. This translates to faster load times and a smoother user experience for visitors regardless of browser or device. Realistic Templates Starter Templates goes beyond stunning design. It delivers readymade website templates specifically crafted with your business in mind. Launching an eCommerce store? We have a diverse selection of store templates to get you selling in no time. Creating a business website? We have dozens of professional-quality designs ready for you to make your mark. No matter your industry or niche, we have a template that perfectly aligns with your vision. Classic Starter Templates Whether you’re a small business owner, freelancer, or nonprofit organization, there’s a template that suits your needs. Templates are carefully crafted to provide a polished and attractive look for your website. The cherry on top? Starter Template supports multiple page builders, including Elementor, Spectra and Gutenberg. You have the flexibility to customize your website your way. Hundreds of Sections and Block Patterns Want to customize your website to make it truly unique? Use sections and block patterns to add your personal style. Available sections include: Hero Page Header About Services Features Contact Why Choose Us Call To Action Portfolio Gallery Testimonials Pricing FAQ Team Statistics AI-Integrated Adaptive Design Library Personalize blocks and patterns to match your website style with the power of AI. The design library within the Starter Templates plugin is integrated with AI and royalty-free image repositories. All elements come pre-populated with relevant text and images that you can easily customize to match your brand. Elementor Templates A fan of Elementor? Look no further! Starter Templates offers a vast collection of professionally designed Elementor templates. You can effortlessly import entire websites crafted with Elementor, individual pages, or even specific blocks to enhance your site’s functionality and aesthetic appeal. Then just drag, drop, customize, and launch your website! WordPress Block Editor Templates The WordPress block editor (formerly Gutenberg) is changing the game for website creation. Building from scratch can be time-consuming. Fortunately, Starter Templates offers a vast library of readymade templates to ignite your website’s potential. AI Assistant for WordPress Our AI Assistant works in a similar way to ChatGPT but is specifically tailored for WordPress. With just a click of a button, you can use the power of artificial intelligence to help write copy for landing pages, proofread blog posts, translate content into different languages, generate custom HTML and CSS codes, and much more! Royalty-Free Images The Starter Templates plugin offers seamless integration with leading royalty-free image repositories such as Pexels and Unsplash. You have access to millions of top-tier images within your WordPress dashboard. Simply search for the image you need and select it. Training Videos As the saying goes, “Give someone a fish, and they will eat for a day; teach them how to fish, and they will eat for a lifetime.” Embracing this philosophy, we offer a range of comprehensive training videos designed to complement our templates. They provide the knowledge and skills necessary to build, launch, and maintain your website. Types of Websites You Can Create Starter Templates is perfect for building websites for: ✔ Personal branding ✔ Restaurants ✔ Service providers ✔ Nonprofits and charities ✔ Events ✔ Startups ✔ Local businesses ✔ Wellness businesses ✔ Landing pages ✔ Lead generation websites ✔ eCommerce stores ✔ Blogs ✔ Manufacturing businesses ✔ Any other type of WordPress website There’s no limit to what you can create! Please note: To access templates and AI features, you’ll need a ZipWP account. ZipWP platform. Signing up is quick, easy, and 100% free. Fun Facts About Starter Templates ➜ Over 5,000 websites are built with Starter Templates every day. ➜ The plugin has been installed on more than 2 million websites. ➜ Starter Templates has more than 4,500 five-star reviews. ➜ Our team of dedicated full-time WordPress experts help and support hundreds of users daily. ➜ A devoted team full-time designers keep the design library up to date. ➜ Our plugin offers more than 100 free Elementor templates. ➜ You can import a complete website, individual page, or section of a page in seconds. ➜ We support 2 page builders: Spectra and Elementor as well as the WordPress editor ➜ “eCommerce” is the most searched keyword in our library. The Starter Templates Plugin Works With… ➜ Astra Theme ➜ Spectra website builder ➜ WordPress block editor/Gutenberg ➜ Elementor page builder ➜ WooCommerce ➜ WPForms ➜ Sitekit