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

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

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

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

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

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

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

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

Требования

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

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

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

Шаг 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 в интерфейсе Менеджера рекламы

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

Войдите в аккаунт Менеджера рекламы.

Откройте раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности.

Укажите уникальное название группы доходности, задайте Статус Активный, выберите Формат объявлений и задайте Тип инвентаря Мобильное приложение. В разделе Таргетинг > Инвентарь выберите рекламный блок в разделе Инвентарь и Мобильное приложение, в который вы хотите добавить медиацию.

Затем нажмите кнопку Добавить партнера по группе доходности.

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

Выберите ironSource Ads в качестве рекламной сети, введите уникальное название и включите медиацию.

Включите Автоматический сбор данных и введите Секретный ключ и Маркер обновления, полученные в предыдущем разделе.

После того как вы выберете партнера по группе доходности, укажите Медиация с использованием Mobile SDK в качестве типа интеграции, iOS в качестве платформы и Активно в качестве статуса. Введите ключ приложения и идентификатор экземпляра, полученные в предыдущем разделе. Затем введите стандартную цену за тысячу показов.

Нажмите Сохранить внизу страницы.

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

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

Шаг 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. Проверьте реализацию

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

Зарегистрируйте тестовое устройство в Менеджере рекламы и включите тестовый режим в интерфейсе ironSource Ads.

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

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

Коды ошибок

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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