Skip to content

v2.0.0-alpha.1 - Enterprise Marketing Attribution Platform

Pre-release
Pre-release

Choose a tag to compare

View all tags
@LTKort LTKort released this 22 Sep 09:23
· 62 commits to main since this release
v2.0.0-alpha
4907f50
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🚀 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

⚖️ 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
Assets 2
Loading