Home - cleveradssolutions/CAS-Flutter GitHub Wiki

• Import CAS.AI Mobile Ads package
• Platform specific setup
• Mediated Networks
• Advertising Identifier

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

With Flutter command:

flutter pub add clever_ads_solutions

Now in your Dart code, you can use:

import 'package:clever_ads_solutions/clever_ads_solutions.dart';

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.3.0"
}

cas {
  // Plugin configuration
}

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

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

cd ios

4. Run ruby script with your app CAS ID:

ruby casconfig.rb <CAS ID>

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/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.

CAS.AI SDK offers three integration paths. Choose one based on your app’s target audience. If you're unsure which solution best fits your application, please contact your account manager.

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.

Android build.gradle:

cas {
    includeOptimalAds = true
}

iOS Podfile:

pod 'CleverAdsSolutions-SDK/Optimal', '4.3.0'

Required for applications directed exclusively at children, in accordance with the Google Play Families Policy and fully compatible with the Children’s Online Privacy Protection Act (COPPA).

Android build.gradle:

cas {
    includeFamiliesAds = true
}

iOS Podfile:

pod 'CleverAdsSolutions-SDK/Families', '4.3.0'

Advanced publishers familiar with ad network integrations can configure their own set of adapters. For detailed instructions on how to integrate specific adapters into your app, refer to the Android wiki page and the iOS wiki page.

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.

CAS Mediation allows you to easily enable or disable the use of the Advertising ID, depending on your app’s privacy requirements.

cas {
    useAdvertisingId = true
}

An application must not use an advertising identifier if at least one of the following conditions is true:

• The app’s target audience includes only children, as defined in the Families Policy.
• The app is being built for devices that do not use Google Play Services (e.g. Amazon or Huawei devices).

To use the App Tracking Transparency authorization request for accessing the IDFA, update your <project>/ios/Runner/Info.plist to add the NSUserTrackingUsageDescription key (Name in Xcode Property List Editor: Privacy - Tracking Usage Description) with a custom message describing your usage. Below is an example description text:

<key>NSUserTrackingUsageDescription</key>
<string>Your data will remain confidential and will only be used to provide you a better and personalised ad experience</string>

Some examples include:

• Your data will remain confidential and will only be used to provide you a better and personalised ad experience
• Your data will be used to provide you a better and personalised ad experience
• Your data will be used to create a customized experience tailored to your interests
• Allowing tracking will enable more personalized ads for you
• We try to show ads for apps and products that will be most interesting to you based on the apps you use
• This identifier will be used to deliver personalized ads to you
• This only uses device info for more interesting and relevant ads

To optimize performance and to improve the user experience, you can localize the NSUserTrackingUsageDescription string. Please follow the Documentation > Xcode > Localization instructions to learn how to localize your app.
The table below gives you a variety of localizations that you can use at your discretion.

🔗 Next

• Initialization