CAS.AI plugin for Flutter

Integrating CAS SDK into an app is the first step toward displaying ads and earning revenue. Once you've integrated and initialized the SDK, you can choose an ad format and follow the steps to implement it.

Prerequisites

Make sure that your app's build file uses the following values:

Use Flutter 3.0.0 or higher
For Android:
- Minimum API level 23 or higher
For iOS:
- Use Xcode 26.0 or higher
- Minimum Target iOS version 13.0 or higher

Import CAS.AI Mobile Ads package

Include the CAS.AI plugin for Flutter in your Flutter project.

With Flutter command:

flutter pub add clever_ads_solutions

Subscribe to receive notifications about CAS updates.

Now in your Dart code, you can use:

import 'package:clever_ads_solutions/clever_ads_solutions.dart';

Platform specific setup

To monetize your app using CAS.AI mediation, in addition to importing the package, you need to configure your Android and iOS projects by using the CAS Gradle plugin for Android and a Ruby CAS script for iOS.

The CAS Android SDK provide a Gradle Plugin to simplify and automate certain integration steps. Our plugin will automatically add mediated network dependencies to your project, which you configure in an cas { } block.

In your Android app Gradle file (usually <project>/android/app/build.gradle), add the com.cleveradssolutions.gradle-plugin inside the plugins block.

plugins {
  id("com.android.application") // before CAS plugin
  id("com.cleveradssolutions.gradle-plugin") version "4.7.4"
}

cas {
  // Plugin configuration
}

Make sure to update the CAS Gradle plugin version whenever you update the CAS Flutter package. The CASGradle plugin version matches the version of the CAS Android SDK. For detailed setup instructions, visit the CAS Android repository.

The Ruby script performs automatic configuration of your iOS project. To apply it, follow the steps outlined below.

Download the casconfig.rb
Place the script in ios app directory <project>/ios
Open the terminal window and go to ios directory:

cd ios

Run ruby script with your app CAS ID:

ruby casconfig.rb <CAS ID>

Repeat the script before every update of the app to make sure you are using up-to-date configurations. For more details about the script and its updates, visit the CAS iOS repository🔗.

The <project>/ios/Podfile is a specification that describes the dependencies of your iOS project. All CAS frameworks are hosted and distributed through their own source repository. Please add CAS source repository url to the beginning of the Podfile:

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/cleveradssolutions/CAS-Specs.git'

Mediation dependencies should be added to the target block, before the end line.

target 'Runner' do
    pod ...
    ...
end

Run pod update terminal command inside the ios directory after modifying the Podfile.

Make sure to update the CAS pods version whenever you update the CAS Flutter package. The Ads Solution pods version matches the version of the CAS iOS SDK.

Choose Mediated Networks

CAS.AI is a mediation SDK with no built-in live ad inventory. At least one ad network adapter or solution must be integrated before publishing to display ads and generate revenue.

Choose an integration path based on your app's target audience. If you're unsure which solution best fits your application, please contact your account manager.

During development, you can test ad formats using Test Ads without adding any ad network SDKs.

Check the details of the ad network adapters supported by CAS.AI Mediation in the Android repository and iOS repository tables.

Recommended for most applications targeting a general or mixed audience. Includes a broad set of stable, high-performance networks.

// <project>/android/app/build.gradle
cas {
    includeOptimalAds = true
}

# <project>/ios/Podfile
pod 'CleverAdsSolutions-SDK/Optimal', '4.7.4'

Advertising Identifier

CAS Mediation uses the Google Advertising ID and Apple Identifier for Advertisers (IDFA) to deliver personalized and more relevant ads to each user.
To enable the use of the Advertising ID in your app, you need to complete the following setup steps.

Get Started

Ad formats

Advanced topics