Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

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

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

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

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

Зарегистрируйтесь и войдите в свою учетную запись ironSource Ads.

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

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

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

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

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

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

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

Торги

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

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

Водопад

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

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

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

Торги

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

Водопад

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

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

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

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

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

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

Шаг 2: Настройте спрос на ironSource Ads в пользовательском интерфейсе Менеджера рекламы

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

Войдите в свою учетную запись Менеджера рекламы .

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

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

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

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

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

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

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

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

Добавьте ironSource Mobile в список рекламных партнеров GDPR и государственных нормативных актов США.

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

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

Использование 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). Вы несёте ответственность за проверку распространения согласия на каждый источник рекламы в вашей цепочке посредников. Google не может автоматически передавать согласие пользователя таким сетям.

Начиная с ironSource SDK версии 7.7.0, ironSource автоматически считывает согласие GDPR, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая 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.

Быстрый

// 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/
// ...

IronSource.setMetaDataWithKey("do_not_sell", value: "YES")

Objective-C

#import <IronSource/IronSource.h>
// ...

[IronSource setMetaDataWithKey:@"do_not_sell" value:@"YES"];

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

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

Интеграция SKAdNetwork

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

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

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

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

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

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

Коды ошибок

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

Журнал изменений адаптера-посредника IronSource для iOS