velocity_ads 0.5.0

A Flutter plugin for VelocityAds SDK - AI-powered contextual advertising for Android and iOS.

0.5.0

Large ad collapse/expand, preliminary text support, new theming tokens, and minimum Android API raised to 24.

Added

• Collapse for Large ad views — VelocityNativeAd now exposes a collapse() method and an isCollapsed getter. Calling collapse() on a loaded Large (VelocityNativeAdViewSize.l) SDK-rendered ad shrinks it from 280 to 158 logical pixels. The user can re-expand by tapping the SDK-rendered "See more" bar. Calling on non-Large ads is a no-op.
• Automatic height management in VelocityNativeAdSlot — The slot automatically adjusts its SizedBox height when a Large ad collapses or expands. No extra code required in recycled scroll views.
• Preliminary text — VelocityNativeAdRequest and VelocityNativeAdViewRequest now accept an optional includePreliminaryText parameter. When true, the server returns a short contextual sentence in VelocityNativeAdData.preliminaryText to display above the ad.
• AdColors.ctaBorder — Border color for the CTA button (1dp/pt stroke). Available on both platforms.
• AdColors.cardBorder — Border color for the ad card container (1dp/pt stroke). Available on both platforms.

Breaking Changes

• Minimum Android API raised to 24 — Apps targeting API 23 (Android 6.x) are no longer supported. Update your minSdkVersion to 24 or higher.
• Removed debug parameter from VelocityAds.initialize — Remove the argument from your initialize() call.

Supported Platforms

• Android (API 24+ / Android 7.0+)
• iOS (13.0+)

Dependencies

• Requires VelocityAds Android SDK: 0.5.0
• Requires VelocityAds iOS SDK: 0.4.0

0.4.1

Dependency updates and ad view size adjustment.

Changed

• Updated Android SDK dependency to io.velocity:ads-sdk:0.4.1.
• Updated iOS SDK dependency to velocityads-ios-sdk:0.3.1.

Breaking Changes

• VelocityNativeAdViewSize.m height increased from 100dp/pt to 160dp/pt.

Dependencies

• Requires VelocityAds Android SDK: 0.4.1
• Requires VelocityAds iOS SDK: 0.3.1

0.4.0

Major plugin overhaul. Updates minimum Android API level from 21 to 23 (Android 6.0).

Breaking Changes

• MAJOR Plugin release — This version includes an overhaul of the Velocity SDK API & features. In case you already have the Velocity Ads Plugin integrated — please review the docs and update the integration accordingly. This isn't a drag & drop change. Note that it's highly recommended to update the integration to use the NativeAdView API suite.
• Minimum Android API raised to 23 — Apps targeting API 21 or 22 (Android 5.x) are no longer supported. Update your minSdkVersion to 23 or higher.

Supported Platforms

• Android (API 23+ / Android 6.0+)
• iOS (13.0+)

Dependencies

• Requires VelocityAds Android SDK: 0.4.0
• Requires VelocityAds iOS SDK: 0.3.0

0.3.0

New Velocity Native Ad View introduced. Former Native Ad load static API replaced with instance-based API.

Added

• Native Ad View — New pre-rendered Velocity Native Ad View with built-in ad layouts in three sizes (s / m / l), theming support, custom color schemes, and typography.
• Set User ID API — A new VelocityAds.setUserId() API to set the user identifier.

Breaking Changes

• Instance-based ad API — use VelocityNativeAd(request).load(). Create with a request, call load(), then access data via getters or embed widget in the tree.

Supported Platforms

• Android (API 21+ / Android 5.0+)
• iOS (13.0+)

Dependencies

• Requires VelocityAds Android SDK: 0.3.0
• Requires VelocityAds iOS SDK: 0.2.0

0.2.2

Adds CocoaPods support for iOS.

Added

• .podspec for CocoaPods-based iOS projects.
• iOS plugin now supports both CocoaPods and Swift Package Manager.

0.2.1

iOS SDK dependency update and minimum iOS version reduction.

Changed

• Updated iOS SDK dependency to velocityads-ios-sdk v0.1.1.
• Lowered minimum iOS deployment target from 15.0 to 13.0.

Supported Platforms

• Android (API 21+ / Android 5.0+)
• iOS (13.0+)

Dependencies

• Requires VelocityAds Android SDK: 0.2.1
• Requires VelocityAds iOS SDK: 0.1.1

0.2.0

Adds iOS support and updates Android SDK.

Added

• iOS SDK integration via Swift Package Manager (velocityads-ios-sdk v0.1.0).
• Full iOS implementation of plugin API methods (initialize, loadNativeAd, isInitialized, setDoNotSell, setConsent).

Changed

• Updated Android SDK to v0.2.1.

Supported Platforms

• Android (API 21+ / Android 5.0+)
• iOS (15.0+)

Dependencies

• Requires VelocityAds Android SDK: 0.2.1
• Requires VelocityAds iOS SDK: 0.1.0

0.1.0

Initial release of VelocityAds Flutter Plugin for Android.

Added

• Android SDK integration (VelocityAds SDK v0.2.0).
• loadNativeAd() — Load native ads with AI-powered contextual targeting.
• Native ad model with rich data (title, description, image, CTA, rating, price, etc.).
• GDPR consent management (setConsent()).
• CCPA "Do Not Sell" support (setDoNotSell()).

Supported Platforms

• Android (API 21+ / Android 5.0+)

Dependencies

• Requires VelocityAds Android SDK: 0.2.0
• Flutter: >= 3.24.0
• Dart SDK: >= 3.5.0