--- title: 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. ## Install CAS.AI addon Visit [releases assets](https://github.com/cleveradssolutions/CAS-Construct/releases) to get the latest version of the `.c3addon`. Navigate to `Menu > View > Addon Manager` window. Install new addon... Select the `CASMobileAds.c3addon`. Subscribe to receive notifications about CAS updates. 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. In most cases, a CASID is the same as your app store ID. You can find an app store ID in the URL of your app’s Apple App Store URL. For example, the URL is `apps.apple.com/us/app/id123456789` then app store ID is `123456789`. ## 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. Check the details of the ad network adapters supported by CAS.AI Mediation in the [Android repository](https://github.com/cleveradssolutions/CAS-Android/blob/master/Adapters/README.md) and [iOS repository](https://github.com/cleveradssolutions/CAS-iOS/blob/master/Adapters/README.md) tables. During development, you can test ad formats using Test Ads mode without adding any ad network SDKs. ### 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](https://support.google.com/googleplay/android-developer/answer/12918983?hl=en) and fully compatible with the [Children’s Online Privacy Protection Act (COPPA)](https://www.ftc.gov/tips-advice/business-center/privacy-and-security/children%27s-privacy). - 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](https://github.com/cleveradssolutions/CAS-Android/blob/master/Adapters/README.md). Below, as an example, only GoogleAds, CASExchange, and DTExchange are shown. - Android Integration Adapters: `googleAds casExchange dtExchange` For iOS, the name must match the Adapter names from the [iOS Adapters table](https://github.com/cleveradssolutions/CAS-Android/blob/master/Adapters/README.md). Below, as an example, only GoogleAds, CASExchange, and DTExchange are shown. - iOS Integration Adapters: `GoogleAds CASExchange DTExchange` ## Advertising Identifier CAS Mediation uses the [Google Advertising ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) and [Apple Identifier for Advertisers (IDFA)](https://developer.apple.com/documentation/adsupport) 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](https://support.google.com/googleplay/android-developer/answer/9893335?sjid=10683822576513227860-EU). - 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](https://developer.apple.com/documentation/bundleresources/information_property_list/nsusertrackingusagedescription) for accessing the IDFA, add plugin variable `IOS_USER_TRACKING_USAGE` to the `config.xml` with a custom message describing your usage. Below is an example description text: - iOS Integration Tracking Usage Description: `Your data will remain confidential and will only be used to provide you a better and personalised ad experience` - 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 ## 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](https://developers.facebook.com/docs/marketing-apis/data-processing-options) 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"}`