Skip to main content

iOS Integration

This page guides you through the process of downloading, importing, and configuring the Yodo1 MAS SDK for iOS.

Prerequisites​

To integrate the Yodo1 MAS SDK on iOS, you need to meet the following requirements:

  • iOS 13.0 or above
  • Xcode 15.2 or above
  • CocoaPods 1.10.0 or above

Installation​

Create Podfile​

If you don't have it already, you need to create the Podfile in the project root directory.

Update Podfile​

Open the Podfile and add the following code to the application's target:

Standard Edition​

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/Yodo1Games/MAS-Spec.git'

pod 'Yodo1MasFull', '4.14.2'

use_frameworks! :linkage => :static

Custom Ad Networks​

tip

Please contact support for advice on which ad networks are safe to remove without impacting performance. AppLovin, Google AdMob, and ToBid are required and cannot be removed.

To add or remove ad networks you can include and exclude the following pod definitions in PodFile:

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/Yodo1Games/MAS-Spec.git'

# AppLovin
pod 'Yodo1MasMediationApplovin/Core', '4.14.2'
pod 'Yodo1MasMediationApplovin/AdMob', '4.14.2'

# BidMachine
pod 'Yodo1MasMediationBidMachine/Core', '4.14.2'
pod 'Yodo1MasMediationBidMachine/AppLovin', '4.14.2'

# Bigo Ads
pod 'Yodo1MasMediationBigo/Core', '4.14.2'
pod 'Yodo1MasMediationBigo/AppLovin', '4.14.2'

# CSJ
pod 'Yodo1MasMediationCSJ/Core', '4.14.2'
pod 'Yodo1MasMediationCSJ/ToBid', '4.14.2'

# DT Exchange(Fyber)
pod 'Yodo1MasMediationFyber/Core', '4.14.2'
pod 'Yodo1MasMediationFyber/AppLovin', '4.14.2'
pod 'Yodo1MasMediationFyber/AdMob', '4.14.2'

# Google AdMob
pod 'Yodo1MasMediationAdMob/Core', '4.14.2'
pod 'Yodo1MasMediationAdMob/AppLovin', '4.14.2'

# ironSource
pod 'Yodo1MasMediationIronSource/Core', '4.14.2'
pod 'Yodo1MasMediationIronSource/AppLovin', '4.14.2'
pod 'Yodo1MasMediationIronSource/AdMob', '4.14.2'

# InMobi
pod 'Yodo1MasMediationInMobi/Core', '4.14.2'
pod 'Yodo1MasMediationInMobi/AppLovin', '4.14.2'
pod 'Yodo1MasMediationInMobi/AdMob', '4.14.2'

# Liftoff Monetize(Vungle)
pod 'Yodo1MasMediationVungle/Core', '4.14.2'
pod 'Yodo1MasMediationVungle/AppLovin', '4.14.2'
pod 'Yodo1MasMediationVungle/AdMob', '4.14.2'

# Meta Audience Network(Facebook)
pod 'Yodo1MasMediationFacebook/Core', '4.14.2'
pod 'Yodo1MasMediationFacebook/AppLovin', '4.14.2'
pod 'Yodo1MasMediationFacebook/AdMob', '4.14.2'

# Mintegral
pod 'Yodo1MasMediationMintegral/Core', '4.14.2'
pod 'Yodo1MasMediationMintegral/AdMob', '4.14.2'
pod 'Yodo1MasMediationMintegral/AppLovin', '4.14.2'
pod 'Yodo1MasMediationMintegral/ToBid', '4.14.2'

# Moloco
pod 'Yodo1MasMediationMoloco/Core', '4.14.2'
pod 'Yodo1MasMediationMoloco/AppLovin', '4.14.2'

# Pangle
pod 'Yodo1MasMediationPangle/Core', '4.14.2'
pod 'Yodo1MasMediationPangle/AppLovin', '4.14.2'
pod 'Yodo1MasMediationPangle/AdMob', '4.14.2'

# ToBid
pod 'Yodo1MasMediationToBid/Core', '4.14.2'

# Tencent
pod 'Yodo1MasMediationTencent/Core', '4.14.2'
pod 'Yodo1MasMediationTencent/ToBid', '4.14.2'

# TradPlus
pod 'Yodo1MasMediationTradPlus/Core', '4.14.2'

# Unity Ads
pod 'Yodo1MasMediationUnityAds/Core', '4.14.2'
pod 'Yodo1MasMediationUnityAds/AppLovin', '4.14.2'
pod 'Yodo1MasMediationUnityAds/AdMob', '4.14.2'

# YSO Network
pod 'Yodo1MasMediationYso/Core', '4.14.2'
pod 'Yodo1MasMediationYso/AppLovin', '4.14.2'

# Yodo1 Test Ads
pod 'Yodo1MasMediationYodo1', '4.14.2'

use_frameworks! :linkage => :static

Then execute the following command in terminal to install the pods:

pod install --repo-update
info

To ensure your build is compatible with artifacts that contain Swift, set Build Settings Always Embed Swift Standard Libraries to YES.

If you use Swift and build for iOS 12.2.0 or earlier, add /usr/lib/swift to Build Settings > Runpath Search Paths to prevent issues with libswiftCore.dylib.

Configure the SDK​

Set up AppLovin Key​

Add the AppLovin SDK key to your app's Info.plist:

<key>AppLovinSdkKey</key>
<string>xcGD2fy-GdmiZQapx_kUSy5SMKyLoXBk8RyB5u9MVv34KetGdbl4XrXvAUFy0Qg9scKyVTI0NM4i_yzdXih4XE</string>

App Transport Security Settings​

Add the following to your Info.plist to ensure uninterrupted ad delivery:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

App Tracking Transparency Settings​

For iOS 14+, add the following to request permission for tracking:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

Add AdMob ID​

Add your AdMob app ID to your app's Info.plist:

<key>GADApplicationIdentifier</key>
<string>Your MAS AdMob App ID</string>

Enable Google Ad Manager​

Add the following to your app's Info.plist:

<key>GADIsAdManagerApp</key>
<true/>

SKAdNetwork IDs​

For iOS 14+, add the required SKAdNetwork IDs to your Info.plist. View the full list of required IDs.

Initialize the SDK​

You need to add your Appkey manually in your project if you haven’t added your game’s store link in the MAS dashboard yet. You can find your app key in MAS dashboard.

Initialize the SDK using your app key:

import Yodo1MasCore

Yodo1Mas.sharedInstance().initMas(withAppKey: "YourAppKey") {
    // Initialization successful
} fail: { error in
    // Initialization failed
}

Configure COPPA​

Important
  • It's mandatory to use a privacy dialog to comply with App Store policies and avoid revenue loss
  • If you use MAS built-in privacy dialog, COPPA will be configured automatically
  • If you prefer using your own privacy dialog, you should check the user's age and set COPPA manually
  • You need to set COPPA before initializing MAS

The Children's Online Privacy Protection Act (COPPA) is an American legal framework that safeguards children's privacy. If your app is designed for children under 13 years of age, it must include COPPA compliance.

// For users under 13
Yodo1Mas.sharedInstance().isCOPPAAgeRestricted = true

// For users 13 and above
Yodo1Mas.sharedInstance().isCOPPAAgeRestricted = false

Configure GDPR​

Important
  • It's mandatory to use a privacy dialog to comply with App Store policies and avoid revenue loss
  • If you use MAS built-in privacy dialog, GDPR will be configured automatically
  • If you prefer using your own privacy dialog, you should check users' age and add an agreement link to get their consent
  • You need to set GDPR before initializing MAS

The General Data Protection Regulation (GDPR) applies to users in the European Union (EU) and European Economic Area (EEA). Users under 16 must opt out of data collection.

// For users who consent to data collection
Yodo1Mas.sharedInstance().isGDPRUserConsent = true

// For users who don't consent or are under 16
Yodo1Mas.sharedInstance().isGDPRUserConsent = false

Configure CCPA​

Important
  • It's mandatory to use a privacy dialog to comply with App Store policies and avoid revenue loss
  • If you use MAS built-in privacy dialog, CCPA will be configured automatically
  • If you prefer using your own privacy dialog, you should add an agreement link to get users' consent
  • You need to set CCPA before initializing MAS

The California Consumer Privacy Act (CCPA) is a legal framework that protects the privacy of California residents in the USA.

// For users who opt out of data collection
Yodo1Mas.sharedInstance().isCCPADoNotSell = true

// For users who have not opted out
Yodo1Mas.sharedInstance().isCCPADoNotSell = false

Video Guide​