velocity_ads 0.2.2

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

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 NativeAd data
• 🔒 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.2.2

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
final ad = await VelocityAds.loadNativeAd(
  prompt: "Best running shoes",
  dimensions: AdDimensions(width: 320, height: 250),
);

// Build your custom UI with the ad data
print('Ad loaded: ${ad.title}');

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

Documentation

• Integration Guide - Complete setup and usage guide
• Obfuscation Guide - Code obfuscation best practices

System Requirements

• Flutter SDK: 3.24.0+
• Dart SDK: 3.5.0+
• Android: API 21+ (Android 5.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 [e-mail]