🚀 v2.0.0-alpha- Major Platform Enhancement Pre-Release

This is a alpha release of MarketingDataTracker v2.0, featuring comprehensive multi-platform support and enterprise-grade
marketing attribution capabilities. This release is for early testing and feedback.

⚠️ Alpha Notice

This is a pre-release version intended for testing purposes only. While we've maintained backward compatibility, please test
thoroughly in a staging environment before using in production.

🎯 Major New Features

🌐 Multi-Platform Support System (12+ Platforms)

• Google Ads - Enhanced with 20+ ValueTrack parameters
• Meta/Facebook - Dynamic campaign parameters
• Microsoft Ads - UET tracking integration
• LinkedIn, Twitter/X, Pinterest, TikTok - Social platform tracking
• Reddit, Snapchat, Amazon - Extended platform coverage
• TradeTracker & Email Marketing - Affiliate and email attribution

🎪 Click ID Management Enhancement

• Priority-based click ID detection (gclid > fbclid > msclkid)
• Automatic extraction from cookie formats
• getPrimaryGoogleClickId() method with configurable priority
• Session-based storage for custom attribution

🔗 Marketing URL Builder

• Fluent interface for campaign URL generation
• Platform-specific templates (Google Ads, Meta, Microsoft, etc.)
• ValueTrack and dynamic parameter support
• Chainable methods for easy URL construction

📊 Event-Driven Architecture

• MarketingDataCreated - Fired on data capture
• ConversionTracked - Conversion tracking events
• ClickIdDetected - Click ID detection events
• MarketingDataUpdated - Data update events

🛒 E-commerce & Conversion Tracking

• GTM-compatible event format
• Revenue attribution framework
• Product tracking with trackViewItem(), trackAddToCart(), trackPurchase()
• Conversion funnel analytics

🍪 Cookie Management System

• Automatic EncryptCookies middleware exception registration
• Fallback to $_COOKIE for encrypted cookies
• Consent management support
• Group-based cookie organization

🔍 Advanced Features

• Wildcard pattern support (_ga*, utm_*, _gcl*)
• Automatic model observation for UTM capture
• Platform detection from marketing data
• Comprehensive test suite converted to Pest

📦 Installation

composer require marshmallow/marketing-data-tracker:^2.0.0-alpha

🔄 Upgrading from v1

100% Backward Compatible - Your existing code continues to work without changes.

1. Update your composer.json:
   "marshmallow/marketing-data-tracker": "^2.0.0-alpha"

2. Run:
   composer update marshmallow/marketing-data-tracker
   php artisan vendor:publish --tag="marketing-data-tracker-config"

3. Review the https://github.com/marshmallow-packages/marketing-data-tracker/blob/main/UPGRADE.md for new feature activation

🧪 Testing This Release

What to Test

• ✅ Existing UTM tracking functionality
• ✅ New platform detection ($model->platform_name)
• ✅ Click ID priority ($model->getPrimaryGoogleClickId())
• ✅ URL Builder (MarketingUrlBuilder::googleAds())
• ✅ E-commerce tracking ($product->trackViewItem())
• ✅ Cookie value retrieval (especially _fbp, _gcl_aw)

Known Issues

• Some test failures in wildcard pattern matching (non-critical)
• Performance optimization for large parameter sets pending

📊 What's Changed

New Files & Services

• PlatformManager - Platform configuration management
• CookieManager - Cookie tracking with consent
• MarketingUrlBuilder - Fluent URL construction
• TracksConversions & TracksEcommerceEvents traits
• Complete event system with 4 new event classes

Enhanced Files

• HasMarketingParameters trait - New click ID methods
• MarketingData class - Cookie encryption handling
• MarketingDataServiceProvider - Auto cookie registration
• Configuration file - 700+ lines of platform configs

Statistics

• 25 files changed
• 5,696 insertions
• 29 deletions
• 17 new files created

🐛 Bug Fixes

• Fixed encrypted cookie reading issues
• Improved click ID extraction from cookie formats
• Enhanced platform detection accuracy

💡 Feedback Wanted

We're particularly interested in feedback on:

• Platform detection accuracy
• Cookie handling in different Laravel versions
• Performance with high-traffic sites
• Event system integration
• URL Builder usability

Please report issues or suggestions in our https://github.com/marshmallow-packages/marketing-data-tracker/issues.

📚 Documentation

• https://github.com/marshmallow-packages/marketing-data-tracker/blob/main/README.md - Complete feature documentation
• https://github.com/marshmallow-packages/marketing-data-tracker/blob/main/UPGRADE.md - Migration instructions
• https://github.com/marshmallow-packages/marketing-data-tracker/blob/main/CHANGELOG.md - Detailed changes

⚖️ License

MIT License - See LICENSE.md for details

⚠️ Remember: This is a pre-alpha release. Use in production at your own risk.

🤖 Generated with https://claude.ai/code

🏷️ Suggested Tags

• v2.0.0-alpha.1
• pre-release
• alpha
• breaking-changes (even though backward compatible, major version bump)
• enhancement