CAS.AI plugin for Construct

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 Construct 3 r401 or higher

Android Cordova:

  • Minimum API level 23 or higher
  • Kotlin build suport by Cordova preference:
<preference name="GradlePluginKotlinEnabled" value="true" />
<preference name="GradlePluginKotlinVersion" value="2.0.21" />

iOS Cordova:

  • Use Xcode 16.4 or higher
  • Minimum Target iOS version 13 or higher
  • Swift build support by Cordova preference:
<preference name="SwiftVersion" value="5.0" />

Install CAS.AI addon

  • Visit releases assets to get the latest version of the .c3addon.

  • Navigate to Menu > View > Addon Manager window.

  • Install new addon...

  • Select the CASMobileAds.c3addon.

Subscribe

Subscribe to receive notifications about CAS updates.

Construct

The CAS.AI addon is also published on Construct products at the link.

Create CAS.AI Mobile Ads object

Double-click on layout to add a new object. Find CAS.AI object and click insert.

image

Select created object to configure CAS.AI plugin.

Some required configuration steps for your project will be performed automatically using the CAS Gradle plugin for Android and the CAS Ruby script for iOS. You need to register your app on the https://cas.ai platform using the bundle package name for Android and the iTunes ID for iOS.

  • For Android the bundle package name will be detected automatically.
  • For iOS you must specify the registered iTunes ID in the CAS Id (iTunes Id) plugin properties. If you do not provide your iTunes ID, the ads in your app will be replaced with test ads.

Mediated Networks

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.

Optimal Ads Solution

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

  • iOS Integration
    Solutions: Optimal
  • Android Integration
    Solutions: Optimal

Families Ads Solution

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

  • iOS Integration
    Solutions: Families
  • Android Integration
    Solutions: Families

Choice networks

Advanced publishers familiar with ad network integrations can configure their own set of adapters. Add the adapter names you want to CAS_ADAPTERS variables from the linked list for each platform, separating them with ,, ;, or a space ( ).

For Android, the name must match the Adapter names from the Android Adapters table. Below, as an example, only GoogleAds, CASExchange, and DTExchange are shown.

  • Android Integration
    Adapters: googleAds casExchange dtExchange

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.

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

  • Android Integration
    Use Ad ID: 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).

App information

Target Audience

Mark apps as child-directed or COPPA-applicable in the CAS UI. If you know specific users are COPPA-applicable, set the audience:

  • Children - Compliance with all applicable legal regulations and industry standards relating to advertising to children.
  • Not Children - Audiences over the age of 13 NOT subject to the restrictions of child protection laws.
  • Unknown - For app's target age groups include both children and older audiences, any ads that may be shown to children must comply with Google Play's Families Ads Program.

App Keyworkds

Set a list of keywords, interests, or intents related to your application, separated by ,. Words or phrases describe the current activity of the user for targeting purposes.

App Conetnt URL

Set the content URL for a website whose content matches the app's primary content. This website content is used for targeting and brand safety purposes. Limitation: max URL length 512.

Mediation Extras

Additional custom parameters passed to mediation metworks. In JSON format.

Meta Audience Network Data Processing Options for US Users

Meta Audience Network Data Processing Options for US Users Limited Data Use is a data processing option that gives you more control over how your data is used in Meta’s systems and better supports your compliance efforts with various US state privacy regulations. To utilize this feature, you must proactively enable Limited Data Use. Visit Meta’s developer documentation for details.

If you do not want to enable Limited Data Use (LDU) mode, pass an empty string as a value of mediation extras with key FB_dp:

  • App Information
    Mediation Extras: {"FB_dp":""}

To enable LDU for users and specify user geography, set LDU:

  • App Information
    Mediation Extras: {"FB_dp":"LDU"}