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

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

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

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

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

Интеграция
Торги	¹
Водопад
Форматы
Баннер	²
Межстраничный
Награжден
Межстраничное объявление с вознаграждением	²
Родной

¹ Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.

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

Требования

Цель развертывания iOS 12.0 или выше

Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией

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

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

Чтобы добавить свое приложение на панель управления IronSource Ads, нажмите кнопку « Новое приложение» .

Введите данные приложения

Выберите Live App , войдите в Apple Store вашего приложения и нажмите «Импортировать информацию о приложении» .

Если ваше приложение недоступно, выберите «Приложение не доступно» в магазине приложений и укажите временное имя для вашего приложения. Выберите свою платформу .

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

Запишите свой новый ключ приложения , который отображается после добавления приложения. Это значение понадобится вам для настройки идентификатора рекламного блока Менеджера рекламы. Выберите форматы рекламы, которые поддерживает ваше приложение. Затем нажмите Продолжить .

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

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

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

Введите необходимые данные и нажмите «Сохранить и закрыть» .

После создания экземпляра идентификатор экземпляра отображается в поле «Идентификатор экземпляра» .

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

Помимо ключа приложения и идентификатора экземпляра , вам также понадобится секретный ключ IronSource Ads и токен обновления, чтобы настроить идентификатор рекламного блока Менеджера рекламы.

Перейдите в раздел «Моя учетная запись» на панели издателя IronSource Ads, затем перейдите на вкладку API . Запишите свой секретный ключ и токен обновления .

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

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

Шаг 2. Настройте спрос на рекламу IronSource в Ad Manager пользовательский интерфейс

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

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

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

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

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

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

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

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

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

Когда закончите, нажмите «Сохранить» внизу страницы.

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

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

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

Использование CocoaPods (рекомендуется)

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

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

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

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

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

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

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

Быстрый

// For Swift integration, you need to import the ironSource Ads SDK in your Bridging Header.
// For more details, see https://developers.is.com/ironsource-mobile/ios/ironsource-ios-sdk-integration-swift/
// ...

IronSource.setConsent(true)

Цель-C

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

[IronSource setConsent:YES];

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

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

Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), причем отказ предлагается через заметную ссылку «Не продавать мою личную информацию». на домашней странице «продающей» стороны. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы 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")

Цель-C

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

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

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

Интеграция со SKAdNetwork

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

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

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

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

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

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

Коды ошибок

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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