Skip to content

Include iOS

d.eshenko edited this page Feb 10, 2023 · 21 revisions

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


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

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

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

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?