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

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

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

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

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

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

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

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

Требования

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

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

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

Шаг 1. Настройте конфигурации в интерфейсе ironSource Ads

Зарегистрируйтесь и войдите в аккаунт Рекламы в ironSource.

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

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

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

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

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

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

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

Ставки

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

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

Водопад

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

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

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

Ставки

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

Водопад

На вкладке API на странице "Мой аккаунт" запишите секретный ключ и токен обновления.

Как обновить файл 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 Ads в конфигурацию медиации для рекламного блока.

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

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

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

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

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

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

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

Ставки

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

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

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

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

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

Водопад

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

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

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

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

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

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

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

Как использовать 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 по ссылке в разделе Changelog и добавьте ссылку IronSourceAdapter.framework в свой проект.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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