UTM Tracker for Gravity Forms
| 开发者 | auxanoglobalservices14 |
|---|---|
| 更新时间 | 2026年7月13日 14:27 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Your forms collect leads. UTM Tracker for Gravity Forms tells you where each one came from.
The plugin reads campaign data from the URL a visitor arrives on — UTM tags, advertising click IDs, and your own custom parameters — remembers it in first-party cookies, and automatically fills matching hidden fields when any Gravity Form is submitted. Every entry arrives with the exact campaign, ad click, landing page, and traffic channel that generated it. No coding required.
Stop guessing which marketing works. See which Google Ads campaign fills your pipeline, which social post actually converts, and which leads arrived from AI search — directly in your Gravity Forms entries, ready for reports, CRM sync, and follow-up.
Why UTM Tracker?
- Set up in minutes — a guided Get Started wizard connects your forms and creates the hidden fields for you.
- Captures everything that matters — UTMs, click IDs from every major ad platform, landing pages, referrer, device data, and custom parameters.
- Attribution built in — first-touch and last-touch models, plus automatic traffic channel detection (including AI Search).
- Tools for marketers and developers — a visual URL Builder with saved templates on one side; REST API, JavaScript API, shortcodes, and hooks on the other.
- Private by design — tracking data lives in first-party cookies and your own WordPress database. No external services, ever.
- A visitor lands on your site through a campaign link (for example, a Google Ads or Facebook ad with UTM tags).
- The plugin captures the campaign data from the URL and saves it in first-party cookies.
- When the visitor submits a Gravity Form — even days later — matching hidden fields are filled in automatically.
- The campaign data is saved with the entry, ready for your reports and follow-up.
utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_id
Advertising click IDs
gclid, gbraid, wbraid (Google Ads), fbclid (Meta), msclkid (Microsoft Ads), ttclid (TikTok), li_fat_id (LinkedIn), twclid (X/Twitter)
Custom parameters
Add your own URL keys — for example affiliate, coupon, salesperson, campaign_owner — one per line. They appear automatically in the URL Builder, Templates, and Gravity Forms field setup.
Landing pages & page context
First landing page, current landing page, current page URL, form submission URL, page title, URL path, and query string.
Visitor & session data (optional)
Browser, operating system, device type, referrer hostname, session ID, visit date, visit time, and timezone. Each value can be mapped to a Gravity Forms hidden field.
To capture any value, add a Hidden field in Gravity Forms with a matching parameter name — or let the One-Click Field Setup create the fields for you.
Attribution Models
Choose how cookie values behave when the same visitor returns through a different campaign:
- Last Touch Attribution — cookie values are updated whenever new parameters appear in the URL, so the most recent campaign is recorded.
- First Touch Attribution — cookie values stay locked to the first campaign detected, so later visits do not overwrite them.
- Paid Search and Organic Search
- Paid Social and Organic Social
- Email, Referral, and Direct
- AI Search — visits from ChatGPT, Perplexity, Claude, and other AI platforms are recognized via UTM values and known AI referrer domains.
- Reports dashboard — a 7-day lead attribution summary read live from your Gravity Forms entries: interactive charts for leads by traffic channel, top sources, mediums, and campaigns, plus the latest captured leads. No extra tables; charts render via a locally bundled Chart.js with zero external requests.
- Get Started wizard — guided four-step onboarding that connects your forms and turns tracking on.
- One-Click Field Setup — pick a form and the required hidden fields are created automatically, with duplicate detection.
- UTM URL Builder — compose campaign links visually: choose fields, drag to reorder, live preview, one-click copy.
- QR Code generator — every campaign URL gets a scan-ready QR code with print-quality PNG and SVG downloads, generated entirely in your browser. Perfect for flyers, packaging, and offline campaigns.
- Templates — save complete campaign links as reusable templates with search, sorting, duplicate, and a default template.
- Cookie Manager — inspect, search, and copy stored tracking values with expiry display.
- Debug Panel — verify captured values in the admin, or add
?utgf_debug=1to any page as an administrator for a frontend overlay. - Export / Import — move your configuration between sites as a JSON file.
- Configurable cookie duration — from 1 to 3650 days, using a quick preset or a custom value.
- JavaScript API — the global
UTMTrackerobject providesget(),getAll(),has(),clear(), and attribution helpers. - REST API —
GET /wp-json/utm-tracker/v1/currentreturns the active tracked values. - Dynamic shortcodes — output tracked values in posts and pages, for example
[utm_source]or[landing_page]. - Action & filter hooks — customize parameters, cookie behavior, field aliases, and more.
- Your data stays yours. Tracking values are stored in first-party cookies and saved to Gravity Forms entries in your own database. The plugin makes no external requests and sends nothing to third-party services.
- Built to be light. The dependency-free frontend tracker loads with the non-blocking defer strategy, and admin assets load only on the plugin's own pages.
安装:
Quick start (recommended)
- Install the plugin from Plugins → Add New, or upload the folder to
/wp-content/plugins/, then activate it. - Make sure Gravity Forms is installed and activated.
- The Get Started wizard opens automatically — pick a form, choose the values to capture, and click Finish. The hidden fields are created for you and tracking is on.
- Open UTM Tracker → Settings and turn on the tracking options you need; set your cookie duration and attribution model.
- In Gravity Forms, open the form you want to track and add a Hidden field for each value.
- On each hidden field, enable Allow field to be populated dynamically.
- Enter the exact Parameter Name for the tracking key you want — for example
utm_source,gclid,traffic_channel, orlanding_page. - Test your setup by visiting a campaign URL, then open UTM Tracker → Debug to confirm the values are captured.
https://example.com/contact/?utm_source=google&utm_medium=cpc&utm_campaign=summer_sale
Tip: The field label in Gravity Forms can be anything you like — only the Parameter Name needs to match the tracking key exactly.常见问题:
Do I need to know how to code?
No. The Get Started wizard and One-Click Field Setup create the required hidden fields for you, and all options are configured from the admin screens. The developer APIs are optional extras.
Does the field label matter in Gravity Forms?
No. Only the Parameter Name needs to match the tracking key exactly (for example, utm_source). The field label can be anything you like.
Does it work with AJAX forms?
Yes. The tracker refreshes hidden fields when a form is rendered and when it is submitted, including AJAX-powered Gravity Forms.
Does it support multi-page forms?
Yes. Hidden fields are re-populated as each page of a multi-step form loads.
Does it support multiple forms on one page?
Yes. Every form with matching hidden field parameter names receives the tracked values.
Can I track custom URL parameters?
Yes. Add your parameter names one per line under UTM Tracker → Tracking → Custom Parameters, then create matching hidden fields (for example: affiliate, coupon, salesperson, campaign_owner).
What is First Touch Attribution?
With First Touch Attribution, cookie values are set once on the visitor's first detected campaign and are not overwritten by later visits — so you always know how the visitor first found you.
What is Last Touch Attribution?
With Last Touch Attribution, cookie values are updated whenever new parameter values appear in the URL, so the most recent campaign is the one recorded.
How does Traffic Channel Detection work?
The plugin reviews click IDs, the UTM medium and source, the referrer hostname, and AI Search signals to assign a channel such as Paid Search, Organic Social, or AI Search.
Does it support AI Search traffic?
Yes. AI Search is detected when utm_medium is ai, ai_search, llm, or chatbot, when utm_source matches a known AI platform in either short or domain form (for example, chatgpt or chatgpt.com, perplexity or perplexity.ai, claude or claude.ai), or when the referrer is a known AI search domain. The domain forms matter because AI platforms tag their outbound links this way (ChatGPT appends utm_source=chatgpt.com) while stripping the referrer.
Does it support Google Ads click IDs?
Yes. gclid, gbraid, and wbraid are tracked and classified as Paid Search.
Where is the tracking data stored?
In first-party cookies in the visitor's browser and, once a form is submitted, in the Gravity Forms entry in your own WordPress database. Nothing is sent to external services.
What happens to my data when I uninstall the plugin?
By default, nothing is deleted — your settings and URL Builder templates are kept so a reinstall picks up where you left off. To remove everything, enable Delete all plugin data when the plugin is uninstalled under UTM Tracker → Settings → Import / Export before deleting the plugin.
Will it slow down my site?
No. The frontend tracker is a single dependency-free script that loads with the non-blocking defer strategy, and it makes no external requests.
How do I test that tracking is working?
Open UTM Tracker → Debug, add ?utgf_debug=1 to any page URL while logged in as an administrator, or use UTM Tracker → Cookies to inspect the stored values.
How do I clear cookies during testing?
Use UTM Tracker → Cookies, or add ?utgf_cookie_manager=1 to any page URL while logged in as an administrator.
Can I export and import my plugin settings?
Yes. Go to UTM Tracker → Settings → Import / Export to download your configuration as a JSON file, or import it back later.
Is there a developer API?
Yes. You can use the JavaScript UTMTracker object, dynamic shortcodes, WordPress filters, and the REST endpoint /wp-json/utm-tracker/v1/current. See the Developer tab under UTM Tracker settings for full documentation.
How do I get support?
For direct support, email admin@auxanoglobalservices.com. You can also open UTM Tracker → Settings and click Email Support, or post on the WordPress.org support forum.
更新日志:
2.2.7
- Refreshed the URL Builder page design with a cleaner, three-column responsive layout (Editor, Preview, and QR Code).
- Moved Generated Campaign URL and QR Code into a sticky preview stack on desktop, so output stays visible while editing.
- Relocated and duplicated the "Save Layout" button to the top-right header and bottom-right footer action bar.
- Enabled vertical resizing on the Generated URL preview textarea to easily view long tracking links.
- Upgraded the "Add Field" selector to a custom multiselect dropdown with checkboxes, allowing users to select multiple fields simultaneously and batch-add them via the "+ Add Field" button (which automatically hides on load and runtime when all available parameters have been added).
- Fixed QR Code load race condition with a two-way event synchronization handshake, ensuring the QR code renders instantly on page load and reload.
- Improved spacing, row styling alignment, focus highlights, and notice banners.
- Added a full-width Leads Over Time chart to the Reports dashboard — a smooth area line showing daily leads across the last 7 days, so you can see your trend at a glance.
- Added three more report breakdowns: Device Breakdown (Desktop / Mobile / Tablet doughnut from the plugin's device tracking), Leads by Form (which forms capture the most leads, clickable to filter), and Top Landing Pages (which pages actually convert visitors into leads, with the full URL on hover).
- The Reports dashboard now shows eight charts in a clean uniform two-column grid: Leads Over Time and Traffic Channels lead, with related breakdowns paired beneath.
- Leads by Traffic Channel is now a doughnut chart — color-coded channel share with the total lead count in the center and a clickable legend showing the count and percentage for every channel — while the ranked Top lists stay as bars.
- Click any chart bar, doughnut segment, or legend item to instantly filter the Recently Captured Leads table; filters from different charts combine (for example Channel = Paid Search AND Source = google), each shown as a removable chip with the number of matching leads and a Clear all option. The selected bar or segment is highlighted while the rest dim, and the leads table scrolls into view. All client-side on already-loaded data — no extra queries.
- Every chart can be downloaded as a crisp high-resolution PNG or copied straight to the clipboard from the buttons in its card header — generated locally in the browser.
- Added a Refresh button to the Reports header — flushes the cached aggregates and rebuilds the report from live Gravity Forms entries on demand (nonce-protected, administrators only).
- No changes to tracking, attribution, cookies, shortcodes, or Gravity Forms field population — fully backward compatible.
- Added a Reports dashboard (UTM Tracker → Reports) — a lead attribution summary for the last 7 days: total leads, tracked forms, leads with UTM data, leads by traffic channel, top sources, top mediums, top campaigns, and all recently captured leads (10 per page).
- Overview cards show icons with the number as the focus, and Last Updated displays relative time (e.g. "Updated 5 minutes ago"). Every breakdown row shows its share of leads as a percentage beside the count.
- Recently Captured Leads links each row to its Gravity Forms entry, truncates long campaign names with a hover tooltip, and uses an em dash for missing values.
- Recently Captured Leads is powered by the bundled DataTables library in the same style as the Templates screen — instant search and column sorting (Entry, Date, Form, Source, Medium, Campaign, Channel), loaded only on the Reports page.
- Reports read live from your existing Gravity Forms entries via the official Gravity Forms API — no new database tables and no duplicated analytics data. Deleting an entry removes it from the reports automatically.
- Aggregates are cached with a WordPress transient and refresh automatically when an entry is submitted, edited, trashed, or deleted. No cron jobs.
- Report breakdowns are interactive horizontal bar charts powered by a locally bundled Chart.js 4.5.1 with chartjs-plugin-datalabels 2.2.0 (both MIT) — gradient rounded bars with values shown right on the bars, staggered animations, tooltips with counts and percentages, and fully responsive resizing. Loaded only on the Reports page; no CDNs or external requests.
- Only administrators can access the Reports page; a friendly notice is shown if Gravity Forms is inactive.
- Fixed Traffic Channel misclassification as "Referral" for direct visitors — your own domain is no longer treated as a referrer. Internal page navigation and the form page itself (the HTTP referer at submission) now count as Direct, and the channel detected on arrival stays stable across page views instead of being overwritten during internal navigation.
- Improved AI Search detection — domain-style
utm_sourcevalues are now recognized (chatgpt.com,openai.com,perplexity.ai,claude.ai,gemini.google.com,copilot.microsoft.com,grok.com,deepseek.com,mistral.ai,meta.ai, and more). AI platforms tag outbound links with these while stripping the referrer, so this traffic previously fell through to Direct. - Fixed WordPress 5.0 compatibility flagged by Plugin Check — replaced
wp_date()andwp_timezone()(WordPress 5.3+) with equivalents that work on the plugin's declared minimum version. - No changes to tracking, attribution, cookies, APIs, or Gravity Forms field population.
- Added a QR Code generator to the URL Builder — a scan-ready QR code is rendered live for the generated campaign URL and updates as you type, with no page reload.
- Download the QR code as a print-quality PNG (1024px+) or a scalable SVG, automatically named after your template. Ideal for flyers, packaging, and offline campaigns.
- QR codes are generated entirely client-side using the bundled qrcode-generator 1.4.4 library (MIT, human-readable source) — no external APIs or remote services, and the assets load only on the URL Builder page.
- Added an opt-in uninstall data cleanup setting under UTM Tracker → Settings → Import / Export — "Delete all plugin data when the plugin is uninstalled". Off by default, so your settings and templates survive a reinstall unless you explicitly enable it.
- When enabled, deleting the plugin removes everything it created: all plugin options, transients, and the URL Builder templates database table. Multisite is supported — each site's own setting is honoured.
- Rewrote the plugin documentation: clearer overview of what the plugin does and why it is useful, reorganized feature sections, a quick-start installation guide, and a new Privacy & Performance section.
- Expanded the FAQ with answers on coding requirements, data storage, uninstall behavior, and site performance.
- No changes to tracking, attribution, cookies, APIs, or Gravity Forms field population.
- Removed development-only files from the plugin package (
tools/traffic-channel-test.phpandtools/build-release.ps1). - No changes to tracking, attribution, cookies, shortcodes, or Gravity Forms field population — fully backward compatible.
- The URL Builder Templates list is now powered by DataTables — instant name search, column sorting (Template Name, Source, Medium, Campaign, Default, Created), and pagination, styled to match the plugin UI.
- DataTables 2.3.8 is bundled locally (MIT licensed) with its non-minified source — no external requests or CDNs.
- Search, sorting, and pagination run on the client for a fast, responsive experience; the search box lives in the page header.
- All per-row actions (Edit, Copy URL, Duplicate, Set Default, Delete) continue to work from the actions menu.
- No changes to tracking, attribution, cookies, shortcodes, or Gravity Forms field population — fully backward compatible.
- Redesigned the URL Builder from a fixed set of UTM fields into a dynamic tool where you choose exactly which fields appear.
- Added drag-and-drop reordering, add/remove field controls, and a grouped "Add Field" picker (UTM, Advertising Click IDs, Page & Landing, Attribution, Visitor & Session, and your Custom Parameters).
- The builder now saves both the field layout AND the field values, so a template is a complete, reusable campaign link. Values are restored when you reopen or edit a template.
- Added a required, unique Template Name as the first field — duplicate names are rejected with a clear message.
- Added an optional Notes field to each template for internal reminders (audience, purpose, notes).
- Custom parameters you create now appear automatically in the URL Builder and Templates — no code changes needed.
- Live URL preview and one-click copy remain, and the generated URL is now correctly encoded.
- Added a management table listing every saved template with a serial number, Template Name, Source, Medium, Campaign, Default status, and Created date.
- Added a per-row actions menu (Edit, Copy URL, Duplicate, Set Default, Delete).
- Added pagination (10 per page) with a "Showing X–Y of Z" summary and page controls.
- Added a search box to filter templates by name.
- Added "Add New Template" — opens a blank builder; after saving, you are taken to the list where the new template appears.
- Exactly one template is always the default; deleting the default automatically promotes another.
- Added a centralized field registry so every field is defined once and reused by the URL Builder and the Gravity Forms field injector. Extend it with the utgf_field_registry filter.
- Added a dedicated database table for URL Builder templates (created on activation and via an upgrade check), a repository layer, and REST endpoints (create, read, update, duplicate, delete) under utm-tracker/v1.
- The field registry is cached per request for performance and refreshed automatically when settings change.
- All new admin actions are capability-limited to administrators, nonce-protected, and sanitize, validate, and escape their data; database access uses prepared statements.
- No changes to tracking, attribution, cookies, shortcodes, or existing Gravity Forms field population — fully backward compatible.
- Added a Get Started setup wizard — a guided four-step onboarding flow: Welcome, Connect Gravity Forms, Tracking Features, and Finish. It opens once after activation and can be reopened anytime from UTM Tracker → Get Started.
- Added One-Click Field Setup on the Gravity Forms tab (also used by the wizard) — select a form and automatically create the required Hidden fields for any supported tracking value using the official Gravity Forms API.
- Added automatic duplicate detection — fields already present on a form are shown as "Added" and skipped instead of being recreated.
- Added grouped field selection (UTM, click IDs, page context, attribution, and visitor/session) that respects your enabled tracking options.
- Hidden fields are created only when onboarding is completed on the Finish step; onboarding can be completed only once.
- Note: the optional "Stay Updated" email subscription is not enabled in this release — the email field is hidden and no email is collected or sent. The underlying hook (utgf_process_subscription) remains available for a future version.
- Improved page load speed — frontend tracking script and all admin scripts now load with the non-blocking defer strategy, eliminating render-blocking execution.
- Improved asset scoping — plugin styles and scripts load only on settings and wizard pages.
- Improved wizard layout — reduced spacing so the setup card fits comfortably within standard viewport heights without scrolling.
- Improved dropdown fields — custom cross-browser SVG chevron styling with standardized height, padding, and focus ring.
- Improved tooltip display — help icons wrapped in span containers to preserve the title attribute after Lucide icon replacement; animated CSS tooltip card added.
- Fixed settings toggle switch alignment — containers no longer shrink under long descriptions.
- Fixed Query String tracking so it now works independently of Landing Pages — enabling Query String alone captures utgf_query_string. Previously the field stayed empty unless Landing Pages was also enabled.
- Improved Automatic Session Data toggle descriptions with plain-language help text, and added a "Cookie vs live" note clarifying which fields persist in cookies versus which are read at form submission.
- Improved admin layout to use the full available page width with alignment, spacing, and responsive refinements.
- All new admin actions are nonce-protected, capability-limited to administrators, with sanitized input and escaped output.
- No changes to attribution models, REST/JS APIs, or shortcodes — fully backward compatible. Query String tracking now works standalone, as noted above.
- Added first-touch and last-touch attribution models with dedicated UTM summary cookies
- Added landing page tracking: first landing page, current landing page, current page URL, submission URL, page title, URL path, and query string
- Added automatic traffic channel detection: Paid Search, Organic Search, Paid Social, Organic Social, Email, Referral, Direct, AI Search, and Other
- Added AI Search detection via UTM source/medium values and AI referrer domains
- Added custom parameter tracking with Gravity Forms and shortcode support
- Added REST API endpoint: GET /wp-json/utm-tracker/v1/current
- Added JavaScript API: UTMTracker.get(), getAll(), has(), clear(), getTrafficChannel(), getFirstTouch(), getLastTouch(), and page context helpers
- Added dynamic shortcodes for UTMs, click IDs, visitor data, page context, and traffic channel
- Added Cookie Manager with search, filter, copy value, and expiry display
- Added Debug Panel in admin and frontend overlay (?utgf_debug=1)
- Added UTM URL Builder and export/import settings as JSON
- Improved Gravity Forms integration with server-side population, field aliases, and AJAX/multi-page support
- Improved cookie optimization — browser, OS, device, and page URLs computed at runtime
- Improved admin UI with developer documentation tab
- Fixed hidden field population for aliased parameters (landing_page, referrer, browser, traffic_channel, etc.)
- Fixed query string and submission URL tracking
- Fixed traffic channel Direct fallback incorrectly overriding AI Search UTM detection
- Fixed admin namespace and debug panel JavaScript errors
- Migrated admin icons to Lucide
- Redesigned navigation to segmented pill layout
- Added brand logo in admin header
- Fixed URL Builder tooltip, JavaScript boot callback, and skeleton loading overlays
- Standardized button and form field styles
- Added expanded UTM and click ID tracking
- Added custom URL parameter support
- Added first-touch and last-touch attribution models
- Added landing page, referrer, device, and session tracking
- Added debug panel, cookie manager, URL builder, REST API, shortcodes, and export/import
- Rebuilt plugin with namespaced OOP architecture
- Removed jQuery dependency from frontend tracker
- Added admin settings page
- Added configurable cookie duration presets
- Initial release.