Simula Ad SDK for Flutter

Overview

The Simula Ad SDK enables Flutter developers to monetize conversational AI applications with contextually relevant, non-intrusive ads. The SDK provides native ad placements and sponsored mini-games that integrate naturally with chat interfaces.

Key Features

  • Contextual Targeting - AI-powered ad matching based on conversation content
  • Native Ad Slots - Flexible ad placements that blend with your UI
  • Mini-Games - Sponsored interactive experiences for AI characters

Installation

Add the package to your pubspec.yaml:

dependencies:
  simula_ads: ^1.0.0

Then run:

flutter pub get

Quick Start

1. Provider Setup

Wrap your application with SimulaProvider to initialize the SDK:

@override
Widget build(BuildContext context) {
  return SimulaProvider(
    apiKey: 'SIMULA_xxx',
    child: YourAppWidget(),
    primaryUserID: 'xxxxx', // Optional: User ID for better ad targeting
    hasPrivacyConsent: true, // Optional: Privacy consent flag
    devMode: false, // Optional: Enable dev mode for testing
  );
}

2. Component Integration

Add components where you want ads or games to appear:

Native Ads:

NativeAdSlot(
  slot: 'feed',
  position: index,
  context: NativeContext(
    searchTerm: 'cute anime waifu',
    tags: ['anime', 'cute'],
  ),
  width: double.infinity,
  onImpression: (ad) => print('Impression: ${ad.id}'),
  onError: (error) => print('Error: $error'),
)

Mini-Games:

MiniGameMenu(
  isOpen: menuOpen,
  onClose: () => setState(() => menuOpen = false),
  charName: 'Luna',
  charID: 'luna-123',
  charImage: 'https://cdn.example.com/avatars/luna.png',
)

Documentation

For complete API reference, integration guides, and examples:

View Full Documentation

Support

License

MIT

Libraries

simula_ads
Simula Ad SDK for Flutter