smartlinks_ad 2.0.1

In-app ads (banner, interstitial, native) for the SmartLinks Flutter SDK.

2.0.1

• Monorepo alignment with smartlinks_flutter 2.x; ads initialized via SmartLinks.initialize().
• Use SmartLinks.ads and SmartLinkBannerAd(adService: SmartLinks.ads) in host apps.

1.7.1

• App User ID Request Format Update: Updated the device registration and ad tracking network requests to send app_user_id as app-user-id in HTTP headers, and also included app_user_id in the device registration POST request body.

1.7.0

• Migration to smartlinks.live: Updated API endpoints and tracking checks to utilize the new smartlinks.live production domain.
• App User ID on Device Registration: Extended SmartLinksPushHandler.initialize to accept an optional appUserId parameter, enabling registration of push tokens alongside user identifiers without introducing hard dependencies to the core package.
• Verbose Registration Logging: Added detailed debug logging (Request URL, Headers, Body, and Response details/exceptions) to the device registration flow for easier troubleshooting.

1.6.0

• App User ID Tracking: Added support for linking impressions and clicks to specific user identifiers for cross-platform analytics and unique user tracking.
• Session Tracking: Implemented local session counting using shared_preferences to power frequency capping and session-based ad targeting.
• Enhanced Frequency Capping: Added support for min_session_count (delay ads until X sessions) and interval_minutes (time gap between views) to ensure a premium user experience.
• Flexible Ad Layouts: Redesigned SmartLinkBannerAd and SmartLinkInterstitialAd to support text-only ads (no image required), grouped text positioning, and automatic UI adjustment.
• Visual Improvements: Added SafeArea support, dynamic text alignment based on position, improved typography hierarchy, and modern button styling for banners.
• Detailed SDK Diagnostics: Integrated comprehensive debug logging for eligibility logic, ad selection, and tracking network responses.

1.5.1

• Bug Fix: Fixed a minor bug and improved stability.

1.5.0

• Foreground Notification Ads: Added explicit handling for foreground push notification ads so they appear locally while the app is actively running.
• Expanded Notification Text: Converted Android notification format to BigTextStyleInformation to prevent the ad body and Call-To-Action text from truncating.
• Robust URL Launching: Bypassed canLaunchUrl restrictions to ensure ad CTA links reliably open the external browser even without explicit intent queries in the host app's manifest.
• Provided a public processNotificationPayload(String?) method to allow apps using their own implementations of flutter_local_notifications to forward ad clicks for tracking and URL navigation.

1.4.0

• Smart Device Metadata: Updated registration logic to automatically capture and report device hardware models (e.g., iPhone/Pixel model identifiers), app versions, and platform languages.
• Added package_info_plus dependency to retrieve app version information.
• Replaced generic device type tags with specific hardware identifiers for better targeting resolution.

1.3.1

• Robust Push Registration: Enhanced SmartLinksPushHandler with retry mechanisms and explicit APNs token setting to resolve persistent [firebase_messaging/unknown] errors on iOS.
• Graceful Degradation: Added edge-case checks to skip FCM token registration gracefully if the host app has not initialized Firebase.

1.3.0

• Offline Analytics Batching: Implemented an offline queue for ad impressions and clicks. Events now cache locally when there is no network and sync automatically upon reconnection.
• Added native click tracking for SmartLinkBannerAd and SmartLinkInterstitialAd.
• Fully integrated NotificationAdService with the new offline analytics batch queue.

1.2.0

• UTM Parameters: Added UTM parameters to ads for better tracking.

1.1.0

• Breaking Change: Renamed SmartLinksAdService to SmartLinksAd and implemented as a Singleton.
• Internal Base URL: The base URL is now managed internally; no need to pass it during initialization.
• Logging Improvements: Switched from print to debugPrint for better console output management.
• Ad Randomization: Widgets now pick a random ad when multiple ads are eligible, ensuring better distribution.
• Banner Size Logic: Added automatic sizing for standard ad types (Large Banner, Medium Rectangle, etc.).
• Interstitial Enhancements: Added onDismissed callback and improved redirection logic using targetUrl.

1.0.0

• Initial release of smartlinks_ad package.
• Added support for Banner, Interstitial, and Native ads.
• Implemented frequency capping and ad scheduling.
• Included analytics tracking for impressions and clicks.

0.0.1

• Initial development release.