Интеграция Медиации Яндекса

Важно

Обязательно обновите версии используемых адаптеров на актуальные (Мобильная медиация Яндекса и адаптеры для сторонних медиационных сетей). Иначе возможны ошибки неправильной интеграции адаптеров и реклама не будет показана.

Мобильная медиация — платформа, которая автоматически подбирает рекламу из множества сетей на основе алгоритмов ML. Это позволяет максимизировать доход. Все настройки работают «из коробки» — отлаживать каждую сеть отдельно не нужно.

Если вы раньше использовали Mobile Ads SDK только с одной сетью Яндекса, то для перехода на Медиацию не придется ничего менять в коде. Предварительно нужно только настроить блоки в веб-интерфейсе внешних рекламных сетей.

Предварительная настройка

Чтобы подготовить приложение, выполните действия, описанные в следующих разделах.

Требования к приложению

  • Используйте iOS 15 и выше.
  • Используйте Xcode 16.4 и выше.

Настройте приложение в своем аккаунте в Рекламной сети Яндекса

Зарегистрируйте свое приложение как приложение Рекламной сети Яндекса:

  1. Войдите или зарегистрируйте аккаунт в Рекламной сети Яндекса.
  2. Зарегистрируйте свое приложение в Рекламной сети Яндекса.

Подключение

Настройте медиацию в интерфейсе Рекламной сети Яндекса. Затем выберите способ подключения.

Внимание

CocoaPods перестанет поддерживаться с 31 декабря 2026 года. Если вы используете CocoaPods, перенесите данные на Swift Package Manager (SPM) по инструкции ниже.

  1. В Xcode выберите File → Add Packages dependencies и укажите URL https://github.com/yandexmobile/yandex-ads-sdk-mediation-ios.

  2. Выберите совместимую версию пакета.

  3. Выберите продукты:

    • Единая сборка (рекомендуется) — YandexMobileAdsMediation. Основной SDK и входящие в сборку адаптеры подключаются автоматически, добавлять их отдельно не нужно.
    • Отдельные адаптеры — если нужны только некоторые рекламные сети, вместо YandexMobileAdsMediation выберите продукты нужных адаптеров.
  4. Добавьте выбранные продукты в таргет приложения.

  5. В Build Settings → Linking добавьте -ObjC в Other Linker Flags, сохранив существующие значения и $(inherited).

  6. В Link Binary With Libraries проверьте, что к таргету приложения подключены выбранные продукты.

Добавьте зависимости в Podfile, выбрав состав медиации:

pod 'YandexMobileAdsMediation', '8.7.0'

Основной SDK и адаптеры подключаются автоматически. Для каждого адаптера выбирается последняя совместимая версия.

Добавьте основной SDK и оставьте только зависимости нужных адаптеров:

pod 'YandexMobileAds', '8.7.0'

pod 'AppLovinYandexMobileAdsAdapters', '13.6.4.2'
pod 'BigoADSYandexMobileAdsAdapters', '6.1.0.0'
pod 'ChartboostYandexMobileAdsAdapters', '9.14.2.0'
pod 'DigitalTurbineYandexMobileAdsAdapters', '8.5.0.0'
pod 'GoogleYandexMobileAdsAdapters', '13.11.0.0'
pod 'InMobiYandexMobileAdsAdapters', '11.5.0.0'
pod 'IronSourceYandexMobileAdsAdapters', '9.7.0.0'
pod 'MintegralYandexMobileAdsAdapters', '8.1.7.0'
pod 'MolocoYandexMobileAdsAdapters', '4.9.0.1'
pod 'MyTargetYandexMobileAdsAdapters', '5.46.0.0'
pod 'PangleYandexMobileAdsAdapters', '8.2.0.0'
pod 'StartAppYandexMobileAdsAdapters', '4.15.0.0'
pod 'UnityAdsYandexMobileAdsAdapters', '4.21.0.0'
pod 'VungleYandexMobileAdsAdapters', '7.7.8.0'
pod 'zMaticooYandexMobileAdsAdapters', '1.5.6.7'
pod 'YandexMobileAdsMediationExtras', '8.6.0'

Выполните pod install в каталоге с Podfile и откройте файл .xcworkspace.

Google AdMob входит в единую сборку. Его также можно подключить отдельно через GoogleYandexMobileAdsAdapters. Если вы используете эту сеть, добавьте GADApplicationIdentifier в Info.plist приложения.

Укажите ваш AdMob ID:

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

Примечание

Если вам необходим трекинг установок приложений в Мобильной медиации, сконфигурируйте Info.plist. Подробнее в разделе Поддержка SKAdNetwork.

Переход с CocoaPods на Swift Package Manager

  1. Откройте файл Podfile.lock и запишите версии SDK и используемых адаптеров. Для медиации проверьте, что нужные адаптеры доступны в выбранной версии SPM-пакета.

  2. Удалите подключение SDK через CocoaPods:

    • Если другие pods остаются, удалите из Podfile зависимости Yandex Mobile Ads SDK, медиации и переносимых адаптеров. Выполните команду pod install и продолжайте работать с файлом .xcworkspace.
    • Если других pods нет, выполните команду pod deintegrate. Далее удалите Podfile и Podfile.lock, каталог Pods и созданный CocoaPods файл .xcworkspace. После этого откройте файл .xcodeproj и сохраните собственный workspace.
  3. В Xcode выберите File → Add Packages dependencies и укажите репозиторий:

    Далее выберите версию пакета, соответствующую прежней интеграции, и нажмите кнопку Add Package.

  4. Выберите продукты и добавьте их в таргет приложения:

    • Для основного SDK — YandexMobileAds и используемые дополнительные модули.
    • Для медиации — YandexMobileAdsMediation. При этом SDK и входящие в сборку адаптеры подключатся автоматически. Если нужны только некоторые сети, выберите продукты нужных адаптеров вместо полного продукта.
  5. В настройках таргета проверьте выбранные продукты в разделе Build Phases → Link Binary With Libraries. Затем в разделе Build Settings → Other Linker Flags добавьте -ObjC, сохраняя остальные значения и $(inherited).

  6. Соберите и запустите приложение. Далее проверьте интеграцию через Debug Panel, а затем — загрузку и показ рекламы на демоблоках.

  7. Сохраните изменения проекта и Package.resolved в системе контроля версий. Если CocoaPods полностью удален, уберите вызов pod install из CI и замените сборку .xcworkspace на .xcodeproj.