v1.3.4-beta Advertising ID Collection & App Store Compliance

Added:

• Advertising ID Extraction: Unified cross-platform support for iOS IDFA and Android GAID with intelligent caching and error handling
• Interactive Setup Dialog: One-time configuration wizard on first import guides developers through advertising ID setup with clear privacy requirements
• Safe Compilation Controls: Automatic ENABLE_ADVERTISING_ID scripting define symbol management prevents accidental IDFA inclusion in App Store builds
• Enhanced Analytics Integration: MixPanel events automatically enriched with advertising IDs, source attribution, and platform detection when enabled
• Privacy-First Controls: Runtime methods to enable/disable advertising ID collection with automatic cache cleanup and permission validation

Improved:

• Zero-Configuration Setup: Automated handling of all technical requirements eliminates manual scripting define symbol configuration
• Default Privacy Protection: Advertising ID collection disabled by default for App Store safety - requires explicit developer enablement
• Smart Caching: 5-minute cache prevents excessive API calls while maintaining fresh data for analytics attribution

Technical Details:

• Compilation Safety: Uses conditional compilation (#if ENABLE_ADVERTISING_ID) to ensure IDFA code is completely excluded when disabled
• Default Behavior: All advertising ID features are OFF by default - safe for immediate App Store submission without additional configuration
• Platform Detection: Automatic iOS/Android/Editor platform detection with appropriate mock data for development testing

Setup Requirements:

• Android: Add implementation 'com.google.android.gms:play-services-ads-identifier:18.2.0' to mainTemplate.gradle (only if enabled)
• iOS: Declare IDFA usage in App Store Connect and implement ATT permission request before calling EnableAdvertisingIdCollection()
• No Breaking Changes: Existing v1.3.3 code works unchanged - new features are opt-in only

Migration:

• Seamless Upgrade: Drop-in replacement for v1.3.3 with zero code changes required
• Safe Defaults: Advertising ID collection disabled by default ensures App Store compliance out-of-the-box
• Enhanced Analytics: Existing MixPanel events automatically improved when advertising IDs are explicitly enabled

This beta release makes advertising ID integration simple and safe. The default-disabled approach with compile-time safety ensures App Store compliance while providing powerful attribution capabilities when explicitly enabled by developers.