[WordPress] 外掛分享： Form Attribution Tracking

前言介紹

• 這款 WordPress 外掛「Form Attribution Tracking」是 2025-11-16 上架。
• 目前尚無安裝啟用數，是個很新的外掛。如有要安裝使用，建議多測試確保功能沒問題！
• 上一次更新是 2025-11-17，距離現在已有 101 天。
• 外掛最低要求 WordPress 6.0 以上版本才可以安裝。
• 外掛要求網站主機運作至少需要 PHP 版本 8.0 以上。
• 尚未有人給過這款外掛評分。
• 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。

外掛協作開發者

ryhowa | samsonovteamwork |

外掛標籤

forms | referral | tracking | attribution |

內容簡介

總結文案：使用 Form Attribution Tracking WordPress 外掛，可以追踪從第一次點擊到轉換完整的客戶旅程，並捕捉在 WordPress 表單中的推薦和 Google Ads 歸因數據。

問題與答案：

1. 這個 WordPress 外掛的名稱是什麼？
- 回答：Form Attribution Tracking。

2. 這個外掛的主要功能是什麼？
- 回答：它可以自動捕捉並存儲從 Google Ads 廣告活動（和其他流量來源）直接在表單提交中的完整歸因數據，使您能夠將具體潛在客戶連接回其起始的廣告活動、關鍵字和 Google Ads 中的廣告，以進行準確的轉換跟蹤和 ROI 測量。

3. 這個外掛可以自動捕捉多少個歸因字段？
- 回答：它可以自動捕捉 8 個歸因字段，包括流量來源、流量媒介、廣告活動、關鍵字、廣告內容、Google Click ID、登陸頁面和第一次點擊的時間戳記。

4. 如何透過這個外掛實現 Google Ads 的轉換追踪？
- 回答：透過 Google Click ID（GCLID）字段，可以將轉換直接匯入回 Google Ads，將表單提交連接到具體的廣告點擊，基於實際潛在客戶/銷售量來測量真實的廣告 ROI，並追踪從廣告點擊到轉換的完整路徑。

5. 這個外掛具有哪些主要的智能追踪技術？
- 回答：它具有智能的第一次點擊歸因、Cookie 持久性、JavaScript + PHP 回退、動態表單支持、UTM 參數檢測和智能來源分類等智能追踪技術。

原文外掛簡介

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

各版本下載點

• 方法一：點下方版本號的連結下載 ZIP 檔案後，登入網站後台左側選單「外掛」的「安裝外掛」，然後選擇上方的「上傳外掛」，把下載回去的 ZIP 外掛打包檔案上傳上去安裝與啟用。
• 方法二：透過「安裝外掛」的畫面右方搜尋功能，搜尋外掛名稱「Form Attribution Tracking」來進行安裝。

（建議使用方法二，確保安裝的版本符合當前運作的 WordPress 環境。

---

1.0.0 | 1.0.1 | 1.0.2 | 1.1.0 | 1.1.1 | 1.1.2 | trunk |

延伸相關外掛（你可能也想知道）

• Track The Click 》追踪點擊次數, Track The Click 外掛能夠幫助網站擁有者更好地了解網站訪客與網站上連結的互動情形。這款外掛主要功能是即時追踪 WordPress 網站上發生的點擊...。
• Affiliates 》p>「Affiliates」系統可以幫助您成功地運行聯盟行銷計畫。, 它擁有一套最強大的成長導向工具。, , 為成長而設計, 全新且直觀的儀表板可協助您的合作夥伴輕鬆...。
• Stop Referrer Spam 》這個外掛可阻擋您網頁統計數據中看到的來源垃圾郵件。這個問題也被廣泛地稱為「垃圾郵件攻擊」。, 最大的垃圾郵件發送者列表, 此外掛使用最大的公共URL列表，...。
• Refer A Friend for WooCommerce by WPGens 》透過「口口相傳」增加您店家的銷售量，讓消費者向朋友宣傳您的產品。, 與 WooCommerce 2.4 及以上版本相容，包含最新的 7.x WooCommerce 版本。, 此外掛將在...。
• Affiliates WooCommerce Light 》透過建立您自己的聯盟網路，讓您的合作夥伴依據引薦銷售來獲取佣金，並讓您的業務成長。, 此外掛將 Affiliates 與 WooCommerce 整合。, 藉由此整合掛件，當有...。
• WP Referral Code 》WP Referral code 可幫助您為每個使用者生成推薦代碼，開始您自己的推薦行銷。當使用者註冊時，此外掛會捕捉推薦代碼。 WP Referral Code 提供了一個使用者友...。
• Refersion for WooCommerce 》, Refersion的目標是使管理聯盟計畫變得盡可能簡單。平均設置時間為6分鐘或更短(!)，完全不需要編碼或技術知識。讓複雜的事情交給我們。, 以下是您可以使用Re...。
• Affiliatly 》總結：Affiliatly是一款功能豐富且價格實惠的簡單而強大的聯盟管理軟件，可完全自定義以滿足您的需求，並具有易於設置和使用的特點，無需技術知識。其核心優...。
• EchoRewards — Refer-a-Friend & Referral Program for WooCommerce 》<!DOCTYPE html>, <html>, <body>, , <h2>總結：</h2>, <ul>, <li>EchoRewards通過將您的客戶機制轉變為聯盟會...。
• IvyCat AJAX Testimonials 》IvyCat AJAX Testimonials 在 WordPress Dashboard 的導覽列中新增一個「Testimonials」選單項目。, 您可以像輸入通常的文章一樣輕鬆輸入推薦評語，甚至可以...。
• Partnero – Affiliate & Referral Program Management for WooCommerce 》合作夥伴 for WooCommerce, - 推出一個完全定制的聯盟計劃，以增加客戶的獲取和保留, - Partnero是一個全面的合作夥伴管理工具，讓您通過推出著眼於合作夥伴...。
• Bonus for Woo 》此外掛旨在創建一個現金回饋的獎勵系統。, 現金回饋百分比是根據用戶的獎勵積分狀態計算的。, 每個用戶的狀態都有相應的現金回饋百分比。, 用戶的狀態取決於...。
• Affiliates Contact Form 7 Integration 》此外掛將與「Affiliates」、「Affiliates Pro」和「Affiliates Enterprise」整合，並與「Contact Form 7」搭配使用。此整合能儲存表單提交的資料並追蹤表單提...。
• SparkLoop 》輕鬆在您的網站上安裝 SparkLoop 追蹤腳本，只需幾分鐘即可開始追踪推薦。。
• Multilevel Referral Affiliate Plugin for WooCommerce 》利用社交推薦計劃免費吸引新客戶、增長並行銷您的企業。WooCommerce 多級推薦插件專為 WooCommerce 商店擁有者而設，為客戶分享您的網站給其朋友、家人和同事...。