=== BaseCloud UTM Tracker === Contributors: basecloud Tags: utm, tracking, analytics, marketing, gravity forms, campaigns, attribution, gclid, cookies Requires at least: 5.0 Tested up to: 6.8 Stable tag: 1.2.2 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Track UTM parameters and GCLID from marketing campaigns. Automatically stores UTM data in cookies and populates Gravity Forms fields for better campaign attribution. == Description == **BaseCloud UTM Tracker** is a powerful WordPress plugin designed to help marketers and website owners track the effectiveness of their marketing campaigns by capturing and storing UTM parameters and Google Click IDs (GCLID). = Key Features = * **Automatic UTM Parameter Tracking** - Captures utm_source, utm_medium, utm_campaign, utm_term, and gclid from URLs * **Cookie Storage** - Stores UTM data in secure cookies for configurable duration (1-365 days) * **Gravity Forms Integration** - Automatically populates form fields with UTM data for seamless lead attribution * **Customizable Parameters** - Configure which parameters to track based on your needs * **Privacy Compliant** - Uses secure, same-site cookies with proper expiration * **HTTPS Support** - Automatically uses secure cookies on SSL-enabled sites * **Professional Dashboard** - Clean, intuitive admin interface with BaseCloud branding = How It Works = 1. **URL Tracking**: When visitors arrive via marketing campaigns (e.g., `yoursite.com?utm_source=google&utm_medium=cpc`), the plugin captures these parameters 2. **Cookie Storage**: UTM data is stored in browser cookies for the duration you specify 3. **Form Population**: When visitors fill out Gravity Forms, UTM data automatically populates hidden or visible fields 4. **Campaign Attribution**: Track which campaigns generate leads and conversions = Perfect For = * **Digital Marketing Agencies** - Track campaign performance across multiple clients * **E-commerce Sites** - Understand which marketing channels drive sales * **Lead Generation** - Attribute leads to specific campaigns and sources * **Content Marketing** - Track which content drives engagement * **PPC Campaigns** - Monitor Google Ads and other paid campaign effectiveness = Gravity Forms Integration = **NEW in v1.2.0:** The plugin can automatically create hidden fields for you! Enable "Auto-Create Hidden Fields" in settings, and the plugin will automatically add these fields to new forms: * `referrer` - Previous page URL (NEW!) * `utm_source` - Campaign source (Google, Facebook, etc.) * `utm_medium` - Campaign medium (CPC, email, social, etc.) * `utm_campaign` - Campaign name * `utm_term` - Campaign keywords * `gclid` - Google Click ID for Google Ads tracking * `gbraid` - Google Brand Engagement (iOS 14+) * `wbraid` - Web to App Brand Engagement **Manual Setup:** Create text fields with these exact labels, set visibility to "Hidden", and enable "Allow field to be populated dynamically" if not using auto-creation. = Technical Features = * **Lightweight** - Minimal impact on site performance * **Standards Compliant** - Follows WordPress coding standards * **Secure** - Proper data sanitization and validation * **Translatable** - Ready for internationalization * **Mobile Friendly** - Works across all devices and browsers = Use Cases = **Marketing Attribution**: Track which campaigns generate the most leads and sales. **A/B Testing**: Compare performance between different campaign variations. **ROI Analysis**: Calculate return on investment for different marketing channels. **Customer Journey**: Understand how visitors discover and interact with your site. == Installation == = Automatic Installation = 1. Log in to your WordPress admin panel 2. Navigate to Plugins > Add New 3. Search for "BaseCloud UTM Tracker" 4. Click "Install Now" and then "Activate" = Manual Installation = 1. Download the plugin ZIP file 2. Log in to your WordPress admin panel 3. Navigate to Plugins > Add New > Upload Plugin 4. Choose the ZIP file and click "Install Now" 5. Activate the plugin = Configuration = 1. Navigate to **UTM Tracker** in your WordPress admin menu 2. Enable UTM tracking 3. Set cookie duration (default: 7 days) 4. Enable Gravity Forms integration if needed 5. Configure tracked parameters (default includes all standard UTM parameters) 6. Save settings == Frequently Asked Questions == = What UTM parameters are tracked by default? = The plugin tracks these parameters by default: * utm_source * utm_medium * utm_campaign * utm_term * gclid (Google Click ID) = How long are UTM parameters stored? = UTM data is stored in cookies for the duration you specify in settings (1-365 days, default is 7 days). = Does this work with other form plugins besides Gravity Forms? = Currently, the plugin is optimized for Gravity Forms integration. Support for other form plugins may be added in future versions. = Is the plugin GDPR compliant? = The plugin uses functional cookies necessary for tracking campaign attribution. You should include UTM tracking in your privacy policy and cookie notice. = Can I track custom parameters? = Yes! You can add custom parameters in the plugin settings. Simply add one parameter per line in the "Tracked Parameters" field. = Does this affect site performance? = No, the plugin is designed to be lightweight with minimal impact on site performance. The JavaScript code is optimized and only loads when needed. = Can I see the UTM data somewhere? = UTM data is stored in cookies and automatically populates Gravity Forms fields. You can view this data in your form submissions or integrate with analytics tools. == Screenshots == 1. **Plugin Settings** - Clean, professional admin interface for configuring UTM tracking 2. **Gravity Forms Integration** - UTM data automatically populates form fields 3. **Dashboard Menu** - Easy access with custom BaseCloud branding 4. **Cookie Storage** - Secure storage of UTM parameters for attribution == Changelog == = 1.2.2 = **🚀 Enhanced Secret Sauce - CRM/Webhook Integration Update** • **NEW: Google Brand Engagement Tracking** - Added gbraid and wbraid parameter support for iOS 14+ tracking • **IMPROVED: Enhanced Secret Sauce Code** - Updated core tracking engine with latest best practices • **FIXED: GCLID Cookie Naming** - Removed bc_ prefix for better CRM/webhook compatibility • **ENHANCED: CRM Integration** - Optimized field population for seamless webhook data transfer • **IMPROVED: Event Triggering** - Added input and change events for better form integration • **UPDATED: Default Parameters** - Now includes referrer, utm_source, utm_medium, utm_campaign, utm_term, gclid, gbraid, wbraid • **OPTIMIZED: Label-Based Population** - Streamlined field detection for text fields set to hidden visibility • **ENHANCED: Popup Integration** - Improved Elementor popup support with better event handling = 1.2.1 = **🔧 Critical Gravity Forms Integration Fix** • **FIXED: Proper Field Creation** - Auto-created fields now use text fields with hidden visibility (WordPress best practice) • **NEW: Server-Side Population** - Added reliable server-side field population using Gravity Forms filters • **IMPROVED: Dynamic Population** - Fields now properly support "Allow field to be populated dynamically" setting • **ENHANCED: Parameter Name Support** - Correct parameter names (gclid, utm_source, etc.) for dynamic population • **ADDED: Triple Population Method** - Server-side + parameter matching + label fallback for 100% reliability • **FIXED: Field Detection** - Smart field detection prevents overwriting existing data • **IMPROVED: Form Compatibility** - Better compatibility with all Gravity Forms features and add-ons = 1.2.0 = **🚀 Major Feature Release - Enhanced Tracking & Automation** • **NEW: Referrer Tracking** - Automatically captures and stores the previous page URL (document.referrer) • **NEW: Auto-Create Hidden Fields** - Automatically adds UTM hidden fields to new Gravity Forms • **Enhanced JavaScript Engine** - Improved "secret sauce" code with modern ES6 features • **Smart Cookie Logic** - Only sets cookies if they don't exist, preventing data overwriting • **Advanced Popup Support** - Enhanced integration with Elementor and other page builders • **Automatic Field Detection** - Intelligent field creation with duplicate prevention • **Form-Level Settings** - Per-form control for UTM field creation in Gravity Forms admin • **Updated Default Parameters** - Now includes referrer tracking by default • **Improved Field Population** - Better support for multiple forms and popup scenarios • **Enhanced Admin UI** - Added referrer field to the field reference guide = 1.1.6 = **Major UI Enhancement** • Modern dashboard layout with real-time status indicators • Enhanced admin interface with responsive grid design • Added visual status cards showing tracking configuration at-a-glance • Improved success messages and user feedback • Professional styling with better visual hierarchy • Enhanced field reference guide with color-coded categories • Added quick stats display for cookie duration and integrations • Mobile-responsive admin interface • Better documentation integration and support links = 1.1.5 = **Release Update** • Bug fixes and improvements • Updated version for deployment = 1.1.4 = **Release Update** • Bug fixes and improvements • Updated version for deployment = 1.1.3 = **GitHub Actions Deployment Trigger** • Re-triggered automated deployment to WordPress.org • Ensure assets are properly deployed via GitHub Actions • Force deployment pipeline activation • Test automated SVN commit process = 1.1.2 = **Assets and Deployment Fix** • Added GitHub Actions workflow for automated WordPress.org deployment • Corrected asset filenames to meet WordPress.org requirements • Fixed plugin branding assets (banners and icons) • Established automated deployment pipeline matching Security Manager = 1.1.1 = **Deployment System Enhancement** • Updated deployment script to use Git-based approach • Removed SVN dependencies for cleaner deployment process • Added plugin network compatibility information • Improved deployment workflow matching Security Manager = 1.1.0 = **Admin Interface Enhancement** • Updated admin menu title from "UTM Tracker" to "UTM Analytics" • Enhanced admin interface terminology for better clarity • Improved user experience in WordPress dashboard navigation • Minor version bump for interface improvements = 1.0.3 = **Description Enhancement** • Enhanced plugin description with improved clarity • Added emphasis on secure cookie storage • Improved analytics terminology for better user understanding • Minor text improvements for professional presentation = 1.0.2 = **Assets Update** * Added professional plugin assets (banners and icons) * Enhanced WordPress.org directory presentation * Improved plugin branding and visual identity * Updated deployment workflow for assets = 1.0.1 = **Minor Update & Testing** * Improved GitHub repository integration and documentation * Enhanced deployment workflow testing * Minor code optimizations for better performance * Updated repository links and branding consistency = 1.0.0 = **Initial Release** * Complete UTM parameter tracking system * Gravity Forms integration for automatic field population * Configurable cookie duration (1-365 days) * Custom parameter tracking support * Professional admin interface with BaseCloud branding * HTTPS and security best practices * WordPress coding standards compliance * Translation ready == Upgrade Notice == = 1.0.0 = Initial release of BaseCloud UTM Tracker. Install now to start tracking your marketing campaign performance! == Privacy Policy == BaseCloud UTM Tracker uses cookies to store UTM parameters for campaign attribution. This data helps website owners understand which marketing campaigns are most effective. The plugin: * Stores UTM parameters in browser cookies * Does not collect personal information * Uses secure, same-site cookies * Allows configuration of cookie duration * Follows WordPress privacy best practices Website owners should include UTM tracking in their privacy policy and inform users about the use of functional cookies for campaign attribution. == Support == For support, feature requests, or bug reports, please visit: * **Plugin Support**: [WordPress.org Support Forum](https://wordpress.org/support/plugin/basecloud-utm-tracker/) * **Professional Support**: [BaseCloud Global](https://www.basecloudglobal.com/support/) * **Documentation**: [Plugin Documentation](https://www.basecloudglobal.com/docs/utm-tracker/) == About BaseCloud == BaseCloud Global is a technology company focused on creating powerful, user-friendly WordPress solutions for businesses and marketers. Our plugins are designed with performance, security, and usability in mind. Visit us at [basecloudglobal.com](https://www.basecloudglobal.com/) for more WordPress solutions.