Include iOS

⚡ Before you start
Make sure you have correctly Configuring SDK.

• Install Cocoapods
• Add User Tracking usage description
• Link frameworks statically
• Track Location Enabled
• Application pause on background
• SKAdNetwork
• iOS 15 Global SKAdNetwork Reporting
• Mute Other Audio Sources

---

The Clever Ads Solutions Unity plugin is distributed with the EDM4U library. This library is intended for use by any Unity plugin that requires access to iOS CocoaPods. It provides Unity plugins the ability to declare dependencies, which are then automatically resolved and copied into your Unity project.

Install Cocoapods

iOS dependencies are identified using Cocoapods. CocoaPods resolve is run as a post build process step.
Make sure that Cocoapods is installed: In the Unity editor, select: Assets > External Dependency Manager > iOS Resolver > Install Cocoapods

Important

Use the generated .xcworkspace instead of the standard Xcode project. An xcworkspace is generated that includes the required dependency libraries.

Add User Tracking usage description

To use the AppTrackingTransparency framework: Set up a NSUserTrackingUsageDescription to display a system-permission alert request for your app installed on end-user devices.
In Unity, use Assets > Clever Ads Solutions > iOS Settings menu to check:

• User Tracking Usage description

And fill table for every language yon want with the ISO-639-1 code in the first column and localized description in second column.
If you want to use the description in English only, remove the rest of the languages.

Link frameworks statically

In the Unity editor, open Assets > External Dependency Manager > iOS Resolver > Settings menu.

• Add use_frameworks!
• Link frameworks statically

The Unity External Dependency Manager will add use_frameworks! :linkage => :static to your Podfile.
Failing to do this step may result in undefined behavior of the plugin.

Track Location Enabled

The SDK are not collects location data automatically if the user allowed the app to track the location.
Check mark Track Location Enabled in Assets > CleverAdsSolutions > iOS Settings window to collects location data by default.
Or change the flag at any time using the following method:

CAS.MobileAds.settings.trackLocationEnabled = true;

Application pause on background

Indicates if the Unity app should be automatically paused when a full screen ad (Interstitial or Rewarded video ad) is displayed.
Enabled by default.
Change the flag at any time using the following method:

CAS.MobileAds.settings.iOSAppPauseOnBackground = false;

SKAdNetwork

SKAdNetwork is a privacy safe method provided by Apple for ad networks to track installs. Up until iOS 14, most ad network campaign attribution has been based on a user's IDFA, but on iOS 14 and beyond, IDFAs will be less usable as a way to attribute which users have installed based on which ads they have interacted with.

The CAS Unity Plugin automatically updates your app’s Info.plist with network-specific identifiers.

iOS 15 Global SKAdNetwork Reporting

Starting with iOS 15, Apple allows developers to send a copy of their SKAdNetwork install postbacks to an endpoint of their choice.
This feature is available to you in the CAS Unity plugin, starting with version 2.6.0. If you would like to enable this feature, you can do so in the Assets > CleverAdsSolution > iOS Settings by following these instructions:

• Set Attribution Report endpoint

Note

Read more about Configuring an Advertised App

Mute Other Audio Sources

⚠️ Known issue when the sounds is disabled in the application after closing advertising with enabled "Mute Other Audio Sources" option. We will continue to look for ways to solve the conflict. Please turn off the option Mute Other Audio Source in Edit > Project Settings > Player > iOS > Other Settings menu.

• Mute Other Audio Source

---

🔗 Done! What’s Next?

• Read about compliance with the Apple Kids Category.
• Make sure you are Include Android platform as well.