Эта страница переведена с помощью Cloud Translation API.

Интегрируйте IronSource с Mediation

Выберите платформу: Android

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

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный	¹
Родной

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

Требования

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

Новейший Google Mobile Ads SDK .
Пройдите руководство по началу процесса медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе ironSource Ads.

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

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

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

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

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

Создайте экземпляр

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

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

Торги

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

Обратите внимание на идентификатор экземпляра .

Водопад

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

Take note of the Instance ID .

Найдите свой ключ API для создания отчетов.

Торги

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

Водопад

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

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

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

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

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

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

Шаг 2: Настройте требования ironSource Ads в пользовательском интерфейсе Ad Manager.

Настройте параметры медиации для вашего рекламного блока.

Войдите в свой аккаунт в Ad Manager .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» .

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

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

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

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

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

После выбора партнера Yield выберите тип интеграции «Mobile SDK Mediation» , платформу «iOS» и статус «Active» . Введите ключ приложения и идентификатор экземпляра, полученные в предыдущем разделе. Затем введите значение CPM по умолчанию .

После завершения нажмите кнопку «Сохранить» внизу страницы.

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

Чтобы добавить ironSource Mobile в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований.

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

Используйте менеджер пакетов Swift.

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

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

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

Используйте CocoaPods

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

Ручная интеграция

Загрузите последнюю версию iOS SDK для рекламы ironSource и подключите IronSource.framework к своему проекту.
Загрузите последнюю версию адаптера ironSource Ads по ссылке для скачивания в Changelog и подключите файл IronSourceAdapter.framework к вашему проекту.

Шаг 4: Внедрите настройки конфиденциальности в SDK рекламы ironSource.

Согласие ЕС и GDPR

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

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

Законы штатов США о защите частной жизни

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

In SDK version 6.14.0, ironSource Ads added an API to support CCPA regulations. The following sample code shows how to pass this consent information to the ironSource Ads SDK. These options must be set before you initialize Google Mobile Ads SDK to ensure they get forwarded properly to the ironSource Ads SDK.

Быстрый

// 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: Протестируйте свою реализацию.

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

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

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

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

коды ошибок

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

GADResponseInfo.adNetworkInfoArray относится к следующим классам:

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

Список изменений адаптера IronSource для медиации iOS