Configuring SDK - cleveradssolutions/CAS-Unreal GitHub Wiki

:zap: Before you start
Make sure you have correctly setup project.

In your Unreal project editor, navigate to Edit > Project Settings > Plugins > CAS.AI Config - [Platform] to modify default configuration for each native platform.

[!NOTE]
Repeat the following steps for Android and iOS platforms.

CAS App ID

In most cases, a CAS App Id is the same as the Android App's package name, and the iOS App's store Id.

  • A package name uniquely identifies your app on the device and in the Google Play Store.
  • The store ID of an iOS app uniquely identifies your app in the Apple App Store.
  • You can find an app's store ID in the URL of your app’s Apple App Store listing. For example, the URL of an app page is apps.apple.com/us/app/id123456789. The app's store ID is 123456789.
  • If you haven't created an CAS account and registered an app yet, now's a great time to do so at CAS.ai.
  • In a real app, it is important that you use your actual CAS App ID.

Autoload ad formats

Select the advertisement formats that will be loaded automatically after the ads initialization. The chosen ad formats will also be automatically loaded after being displayed or encountering a loading error. In this case, you may choose not to use the ad loading functions and instead simply call the ad display functions when needed. The ad will be displayed if it is ready; otherwise, a failure event will be triggered.

  • Autoload Banner Ads
  • Autoload MRec Ads
  • Autoload Interstitial Ads
  • Autoload Rewarded Ads
  • Autoload App Open Ads

[!WARNING]
Do not select ad formats that you do not intend to show to the user, as it will impact the performance of the application.

Enabling test ads

Read about Test ads mode and Test Device Ids here.

  • TestAdsMode

Target app audience

Select the audience your game is targeting.

  • Mixed - The app is intended for audiences of all ages.
  • Children - Children restrictions and Google Families Ads Program participation apply to this app. Audience under 12 years old.
  • NotChildren - Audience over 12 years old only. There are no restrictions on ad filling.

[!TIP]
Read more about COPPA compliance.

Auto Consent Flow

Select to automatic ask for consent from the user on ads initialization. To get consent for collecting personal data of your users, we suggest you use a built-in Consent Flow, comes with a pre-made consent form that you can easily present to your users.

  • Auto Consent Flow

[!TIP]
Read more about User Consent Flow.

Use Advertising Id

The Advertising ID is a unique, user-resettable ID for advertising, provided by Google Play services (AD_ID) or by Apple (IDFA). Crucial for mobile attribution, i.e. tracking the user journey, its purpose is to measure user interactions with ad campaigns and track events like installs and in-app activity.

  • Use Advertising Id

User Tracking Usage Description (iOS Only)

If your app calls the App Tracking Transparency API, you must provide custom text, known as a usage-description string, which displays as a system-permission alert request. The usage-description string tells the user why the app is requesting permission to use data for tracking the user or the device. The user has the option to grant or deny the authorization request.

[!TIP]

Privacy Policy URL

Provide a link to the app's Privacy Policy so that it is presented to the user in the consent dialog.

[!NOTE]
If you don't define a link to your application's policy, the user will follow the link to Clever Ads Solutions policy.

Include Ads Solution

Clever Ads Solutions provide ready-made solutions for you to choose from.

  • An Optimal Ads Solutions contains a number of stable partner networks that are recommended for use in most applications.
  • A Families Ads Solutions designed for applications tagged at a children's audience.

[!WARNING]
Some ad networks require you to do Additional integration steps: Meta AudienceNetwork

Advanced Integration

Advanced integration makes it possible to choose any variations of mediation networks. Feel free not to use ready-made solutions, and choose which mediated ad networks you want to integrate by checking the boxes in Mediation/Advanced section of settings window.

[!WARNING]
Access to the monetization of the beta ad sources is closed.
If you would like to monetize by one of these ad sources, please contact your account manager.

Cross-promotion

Cross-promotion is an app marketing strategy in which app developers promote one of their titles on another one of their titles. Cross promoting is especially effective for developers with large portfolios of games as a means to move users across titles and use the opportunity to scale each of their apps. This is most commonly used by hyper-casual publishers who have relatively low retention, and use cross promotion to keep users within their app portfolio.

Start your cross promotion campaign with CAS here.

[!NOTE]
CrossPromotion can be installed/removed using Mediation/Advanced section.

🔗 Done! What’s Next?