Integrating Yandex mediation

Warning

Make sure to update your used Yandex mobile mediation adapters and adapters for third-party mediation networks to the latest version. Older versions may cause adapter integration errors that can prevent your ads from being served.

Yandex Mediation is a platform that automatically selects ads from a variety of networks using ML algorithms to maximize your revenue. All settings are turnkey, meaning there's no need to debug each network separately.

If you previously used the Mobile Ads SDK with only one Yandex network, you won't need to change anything in the code to switch to Yandex mediation. You only need to pre-configure the units in the web interface of external ad networks.

Preliminary setup

To prepare your app, follow the steps from the next sections.

App requirements

  • Use iOS 13 or higher.
  • Use Xcode 15 or higher.

Set up the application in your Yandex Advertising Network account

Here's how to register your app in the Yandex Advertising Network:

  1. Log in or register your account in the Yandex Advertising Network.
  2. Register your app in the Yandex Advertising Network.

Integration

There are two ways to enable mobile mediation:

  • Unified build (recommended): All available adapters are added automatically.
  • Adding adapters individually: Yandex SDK is installed separately, then specific adapters are added one by one using their respective packages.

You can enable all available adapters automatically using the YandexMobileAdsMediation shared mediation library. The library has been adapted to work with the CocoaPods dependency management system and supports a static integration method.

  1. Set up mediation in the Yandex Partner interface.

  2. Add the YandexMobileAdsMediation library to the Podfile.

    pod 'YandexMobileAdsMediation', '7.7.0'
    

    For each adapter, the latest compatible version is selected automatically.

  3. To your app's Info.plist file, add the GADApplicationIdentifier key with your AdMob ID (learn more about how to find out the AdMob ID).

    <key>GADApplicationIdentifier</key>
    <string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>
    

To add individual adapters, enable Yandex Ads SDK and relevant adapters by following the instructions:

  1. Set up mediation in the Yandex Partner interface.

  2. Add the YandexMobileAds library to the Podfile.

    pod 'YandexMobileAds', 'x.x.x' // Add the supported version
    
  3. Add the applicable adapters one by one using the appropriate libraries.

Note

To track app installations in mobile mediation, configure Info.plist. For more information, see SKAdNetwork support.