VelocityAds Flutter Plugin

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

Features

  • 🤖 AI-Driven Targeting - Contextual ads based on user conversations
  • 🔧 Custom Rendering - Build your own ad UI with VelocityNativeAd data fields
  • 🔒 Privacy Compliant - CCPA and GDPR support
  • 📱 Android and iOS Support - Native Android and iOS integration

Installation

Add to your app pubspec.yaml:

dependencies:
  velocity_ads: ^0.4.1

Then run:

flutter pub get

iOS Setup

CocoaPods (default): No additional setup needed. The plugin resolves automatically when you run pod install.

Swift Package Manager (optional): If your project uses SPM instead of CocoaPods, enable it in Flutter:

flutter config --enable-swift-package-manager

Quick Start

import 'dart:io';
import 'package:velocity_ads/velocity_ads.dart';

// Use the app key for the current platform (iOS and Android keys are different)
final appKey = Platform.isIOS ? 'your-ios-app-key' : 'your-android-app-key';

// Initialize SDK
await VelocityAds.initialize(
  appKey: appKey,
);

// Load a native ad (data-only, publisher-rendered UI)
final request = VelocityNativeAdRequest(prompt: 'Best running shoes');
final ad = VelocityNativeAd(request);
await ad.load(listener: MyAdListener());

// Build your custom UI with the ad data — ad.data fields are populated after load.
ad.destroy(); // Release when done

// Or load an SDK-rendered native ad view
final viewRequest = VelocityNativeAdViewRequest(
  size: VelocityNativeAdViewSize.m,
  prompt: 'Best running shoes',
);
final viewAd = VelocityNativeAd(viewRequest);
await viewAd.load(listener: MyAdListener());
await viewAd.createAdView(); // Creates the platform view; viewAd.widget is available after this.
// Add viewAd.widget to your widget tree
viewAd.destroy(); // Release when done

For a complete working example, see the example/ directory in the package source

Documentation

System Requirements

  • Flutter SDK: 3.24.0+
  • Dart SDK: 3.5.0+
  • Android: API 23+ (Android 6.0)
  • iOS: 13.0+
  • Xcode: 16.0+

License

This project is licensed under the Apache License, Version 2.0

Support

For issues and questions, contact support@velocityads.io

Libraries

velocity_ads