velocity_ads 0.8.0

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

0.8.0

Stability improvements.

Dependencies

• Requires VelocityAds Android SDK: 0.8.0
• Requires VelocityAds iOS SDK: 0.8.0

0.7.0

Required adUnitId on all native ad requests, a new extra-small (xs) ad view size, and a taller small (s) size.

Added

• VelocityNativeAdViewSize.xs — new extra-small ad view size (64dp/pt height).

Changed

• Android SDK transitive dependencies updated — The bundled VelocityAds Android SDK now ships against newer Kotlin and AndroidX libraries, which flow into your app's dependency graph on Android:
  • kotlin-stdlib 2.1.21 (from 1.9.22) — publishers on Kotlin below 2.1.0 may see a build warning about a stdlib version mismatch. The build still succeeds and the app runs correctly; upgrading your project's Kotlin version to 2.1.0 or higher silences the warning.
  • kotlinx-coroutines-android and kotlinx-coroutines-play-services 1.10.2 (from 1.6.4).
  • androidx.core:core-ktx 1.16.0 (from 1.8.0).

Added

• VelocityNativeAd.getLargeImageUrl({required int width, required int height}) — Returns the landscape hero image URL with {{width}}/{{height}} Cloudinary placeholders substituted for the supplied pixel dimensions. Use this when the image view size is known at render time to request an optimally-sized URL. Returns null when the ad has no large image. For simple cases where the exact size is not needed, use ad.data.largeImageUrl which resolves to 1920×640.

Breaking Changes

• adUnitId is now required — VelocityNativeAdRequest and VelocityNativeAdViewRequest constructors now require adUnitId as their first positional argument. The field is no longer nullable; remove any adUnitId: null usages.
  • VelocityNativeAdRequest(prompt: ...) → VelocityNativeAdRequest(adUnitId: 'ad-unit-id', prompt: ...)
  • VelocityNativeAdViewRequest(size: ..., ...) → VelocityNativeAdViewRequest(adUnitId: 'ad-unit-id', size: ..., ...)
• VelocityNativeAdViewSize.s height increased from 50dp/pt to 100dp/pt — update any fixed-height containers or layout constraints that assume the previous 50dp/pt value.

Supported Platforms

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

Dependencies

• Requires VelocityAds Android SDK: 0.7.0
• Requires VelocityAds iOS SDK: 0.7.0

0.6.0

Expanded demand offering, removal of SDK-internal ad data fields, and native SDK dependency bumps to 0.6.0 on both platforms.

Added

• Expanded demand offering and improved performance — NativeAdView ads now benefit from an expanded advertiser network and optimized ad delivery, resulting in higher fill rates and faster load times.

Changed

• Android and iOS SDK dependencies bumped to 0.6.0 — io.velocity:ads-sdk:0.6.0 and VelocityAdsSDK 0.6.0.

Breaking Changes

• VelocityNativeAdData model fields removed – The following fields have been removed from the public VelocityNativeAdData struct (accessible via VelocityNativeAd.data):

  • id: String
  • adTemplateId: String?
  • expandButton: String?

  If your app reads any of these fields from VelocityNativeAd.data, remove those references.

Supported Platforms

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

Dependencies

• Requires VelocityAds Android SDK: 0.6.0
• Requires VelocityAds iOS SDK: 0.6.0

0.5.1

README update.

Changed

• Updated README to reflect the latest additions.

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