Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как интегрировать ironSource Ads с медиацией

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

В этом руководстве рассказывается, как с помощью Google Mobile Ads SDK загружать и показывать объявления из ironSource Ads, используя медиацию AdMob и каскадную интеграцию. Вы узнаете, как добавить ironSource Ads в конфигурацию медиации рекламного блока, настроить оптимизацию источника объявлений и интегрировать рекламный SDK и адаптер ironSource Ads в приложение для iOS.

Поддерживаемые интеграции и форматы объявлений

Адаптер медиации для ironSource Ads поддерживает следующие возможности:

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Межстраничное объявление с вознаграждением	¹
Стандартное

¹ Этот формат поддерживается только при интеграции каскада.

Требования

Прежде чем продолжить, убедитесь, что:

Целевая версия iOS для развертывания – 13.0 или более поздняя.
[Для назначения ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер IronSource версии 8.5.0.0.1 или более поздней (рекомендуется последняя версия).

Последняя версия Google Mobile Ads SDK.
Настройте медиацию AdMob.

Шаг 1. Задайте настройки в интерфейсе ironSource Ads

Зарегистрируйтесь и войдите в аккаунт ironSource Ads.

Добавить приложение

Чтобы добавить новое приложение, перейдите в раздел Объявления > Приложения и нажмите Добавить приложение.

Заполните форму и нажмите Добавить приложение.

Запишите ключ приложения, выберите форматы объявлений, которые поддерживает ваше приложение, и нажмите Продолжить.

Создание экземпляра

Затем настройте экземпляр для добавленного приложения.

Перейдите в раздел Объявления > Настройка > Экземпляры. Выберите приложение и нажмите Create instance (Создать экземпляр).

Ставки

Заполните форму и в разделе Цены выберите Назначение ставок. Нажмите Сохранить и закрыть.

Запишите идентификатор экземпляра.

Водопад

Заполните форму и нажмите Сохранить и закрыть.

Запишите идентификатор экземпляра.

Как найти ключ Reporting API

Ставки

Для интеграции с назначением ставок этот шаг не требуется.

Водопад

Нажмите на вкладку API на странице My Account (Мой аккаунт) и запишите секретный ключ и токен обновления.

Обновите файл app-ads.txt

Решение Authorized Sellers for Apps (app-ads.txt), разработанное IAB Tech Lab, позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, настройте файл app-ads.txt для приложения.

Чтобы реализовать файл app-ads.txt для ironSource, ознакомьтесь со статьей Авторизованные реселлеры ironSource.

Включить тестовый режим

Чтобы включить тестовые объявления ironSource Ads, следуйте инструкциям в руководстве по тестированию интеграции.

Шаг 2. Настройте спрос на рекламу от ironSource Ads в интерфейсе AdMob

Как настроить медиацию для рекламного блока

Вам нужно добавить Рекламу в ironSource в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Перейдите на вкладку Медиация. Если вы хотите изменить существующую группу медиации, нажмите на ее название и перейдите к разделу Добавьте ironSource Ads в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат объявления и платформу, а затем нажмите Продолжить.

Укажите название группы медиации и выберите местоположения для таргетинга. Затем установите для группы медиации статус Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими рекламными блоками AdMob. Затем нажмите Готово.

Выбранные рекламные блоки появятся на карточке:

Как добавить ironSource Ads в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и выберите Добавить источник объявлений. Затем выберите Реклама в ironSource.

Нажмите Как подписать партнерское соглашение и установите партнерскую связь с назначением ставок с ironSource Ads.

Нажмите Подтвердить и согласиться, а затем – Продолжить.

Если у вас уже есть сопоставление для ironSource Ads, вы можете выбрать его. В противном случае нажмите Добавить сопоставление.

Затем введите ключ приложения и идентификатор экземпляра, полученные в предыдущем разделе. Затем нажмите Готово.

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите ironSource Ads и сдвиньте переключатель Оптимизировать вправо. Чтобы настроить оптимизацию источника объявлений для ironSource Ads, введите секретный ключ и токен обновления, полученные в предыдущем разделе. Затем укажите эффективную цену за тысячу показов для ironSource Ads и нажмите Продолжить.

Примечание. Чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов в сети медиации, требуется несколько дней. Пока статус оптимизации источника объявлений – PENDING, вам нужно вручную задать значение эффективной цены за тысячу показов для сети. После этого источник объявлений начнет автоматически обновлять эффективную цену за тысячу показов от вашего имени.

Добавьте ironSource Mobile в список рекламных партнеров, соблюдающих GDPR и законы штатов США

Чтобы добавить ironSource Mobile в список рекламных партнеров, на которых распространяются европейские регламенты и законы штатов США, выполните инструкции из статей Настройки, обеспечивающие соблюдение европейских регламентов и Настройки, обеспечивающие соблюдение законов штатов США.

Шаг 3. Импортируйте рекламный SDK и адаптер ironSource Ads

Используйте Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 8.10.0.0.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне найдите следующий URL пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-ironsource.git
```
В разделе Правило зависимости выберите Ветвь.
В текстовом поле введите main.

Через CocoaPods

Добавьте в Podfile проекта следующую строку:
```
pod 'GoogleMobileAdsMediationIronSource'
```
В командной строке выполните следующую команду:
```
pod install --repo-update
```

Интеграция вручную

Скачайте последнюю версию ironSource Ads iOS SDK и свяжите IronSource.framework со своим проектом.
Скачайте последнюю версию адаптера ironSource Ads по ссылке для скачивания в журнале изменений и добавьте файл IronSourceAdapter.framework в проект.

Шаг 4. Задайте настройки конфиденциальности в ironSource Ads SDK

Согласие пользователей из ЕС и GDPR

Чтобы соблюдать правила Google в отношении согласия пользователей из ЕС, вы должны предоставлять определенную информацию пользователям из Европейской экономической зоны (ЕЭЗ), Великобритании и Швейцарии и получать их согласие на использование файлов cookie или других средств локального хранения данных, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эти правила отражают требования, изложенные в Директиве ЕС о конфиденциальности и электронных средствах связи и Генеральном регламенте ЕС о защите персональных данных (GDPR). Вы должны убедиться, что согласие передается каждому источнику объявлений в цепочке медиации.

Начиная с версии 7.7.0 SDK ironSource автоматически считывает согласие по GDPR, заданное платформами для запросов согласия, которые поддерживают спецификацию Google Additional Consent, включая UMP SDK. Подробную информацию вы найдете в статье Поддержка Google UMP и CMP, поддерживающих режим дополнительного согласия Google.

Законы штатов США о конфиденциальности

Законы штатов США о конфиденциальности требуют предоставлять пользователям право запретить "продажу" их "личной информации" (эти термины определены в тексте закона). Компания, подпадающая под действие закона, обязана разместить на главной странице "продавца" ссылку с текстом "Запретить продажу личных данных". В руководстве по соблюдению законов штатов США о конфиденциальности рассказывается, как включить ограничение обработки данных для показа рекламы Google. Однако Google не может применить эту настройку ко всем рекламным сетям в вашей цепочке медиации. Поэтому вам необходимо определить, какие рекламные сети в вашей цепочке медиации могут участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.

В SDK версии 6.14.0 ironSource Ads добавила API для поддержки требований CCPA. В примере кода ниже показано, как передать эту информацию о согласии в ironSource Ads SDK. Эти параметры необходимо задать до инициализации Google Mobile Ads SDK, чтобы они были правильно переданы в ironSource Ads SDK.

Swift

// For Swift integration, you need to import the ironSource SDK in your Bridging Header.
// For more details, see https://developers.is.com/ironsource-mobile/ios/ironsource-ios-sdk-integration-swift/
IronSourceAds.setMetaDataWithKey("do_not_sell", value: "YES")IronSourceMediationSwiftSnippets.swift

Objective-C

[IronSourceAds setMetaDataWithKey:@"do_not_sell" value:@"YES"];IronSourceMediationObjectiveCSnippets.m

Дополнительную информацию и значения, которые можно указать в методе, вы найдете в документации ironSource Ads по расширенным настройкам в соответствии с нормативными требованиями.

Шаг 5. Добавьте необходимый код

Как реализовать SKAdNetwork

Добавьте идентификаторы SKAdNetwork в файл Info.plist проекта, следуя инструкциям ironSource.

Шаг 6. Проверьте реализацию

Как включить тестовые объявления

Обязательно зарегистрируйте тестовое устройство в AdMob и включите тестовый режим в интерфейсе ironSource Ads.

Проверьте тестовые объявления

Чтобы проверить, получаете ли вы тестовые объявления от ironSource Ads, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений ironSource Ads (назначение ставок) и ironSource Ads (каскад).

Коды ошибок

Если адаптер не получает объявление от ironSource Ads, вы можете проверить основную ошибку в ответе на запрос объявления, используя

GADResponseInfo.adNetworkInfoArray в следующих классах:

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Ниже приведены коды и сообщения, которые адаптер ironSource Ads выдает, когда не удается загрузить объявление.

Код ошибки	Причина
101	Параметры сервера объявлений ironSource, настроенные в интерфейсе AdMob, отсутствуют или недействительны.
102	Адаптер ironSource Ads не поддерживает запрашиваемый формат объявления.
103	Объявление ironSource уже загружено для этой конфигурации сети.
104	Запрошенный размер баннера не поддерживается ironSource Ads.
105	Сети ironSource Ads не удалось показать объявление.
508-1037	Ошибки рекламного SDK ironSource. Подробная информация приведена в документации.