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

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

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

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

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

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

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

Требования

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

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

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

Шаг 1. Задайте настройки в интерфейсе Unity Ads

Зарегистрируйтесь или войдите в Unity Ads.

Как создать проект

На панели управления Unity Ads перейдите в раздел Projects (Проекты) и нажмите New (Создать).

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

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) и нажмите Get started (Начать).

В окне New Project (Новый проект) выберите I will use Mediation (Я буду использовать медиацию) и Google AdMob в качестве Mediation Partner (Партнер по медиации), а затем нажмите Next (Далее).

Выберите вариант для настроек рекламы и нажмите Далее.

Выберите настройки места размещения и нажмите Далее.

Ставки

Водопад

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

Запишите идентификатор игры.

Создание рекламных блоков и мест размещения

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > Placements (Места размещения), выберите проект и нажмите Add ad unit (Добавить рекламный блок).

Укажите название рекламного блока, а затем выберите платформу и формат объявления.

Перейдите в раздел Монетизация > Места размещения и нажмите Добавить рекламный блок.

Укажите название рекламного блока, а затем выберите платформу и формат объявления.

В разделе Настройка выберите Каскад. В разделе Место размещения укажите название места размещения, геотеги и цель.

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

Нажмите Добавить рекламный блок, чтобы сохранить рекламный блок и место размещения.

Как найти ключ API для отчетов Unity Ads

Ставки

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

Водопад

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > API management (Управление API) и запишите ключ API из раздела Monetization Stats API Access (Доступ к API статистики монетизации).

Затем перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > Organization Settings (Настройки организации) и запишите основной идентификатор организации.

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

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

Чтобы реализовать app-ads.txt для Unity Ads, ознакомьтесь с инструкциями по первоначальной настройке файла app-ads.txt.

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

Тестовый режим можно включить на панели управления Unity Ads. Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > Testing (Тестирование).

Чтобы принудительно включить тестовый режим для приложения, нажмите кнопку редактирования рядом с надписью Apple App Store, активируйте параметр Переопределить тестовый режим клиента и выберите Принудительно включить тестовый режим (использовать тестовые объявления) для всех устройств.

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

Укажите сведения о тестовом устройстве и нажмите Сохранить.

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

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

Добавьте Unity Ads в разделе "Компании"

Ставки

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

Водопад

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

В качестве рекламной сети выберите Unity Ads, введите уникальное название и включите медиацию. Включите параметр Автоматический сбор данных и введите ключ API и основной идентификатор организации, полученные в предыдущем разделе.

Поля Имя пользователя и Пароль заполнять не нужно. Нажмите кнопку Сохранить.

Включить передачу защищенных сигналов

Ставки

Нажмите Администрирование > Глобальные настройки. Перейдите на вкладку Настройки аккаунта Ad Exchange и включите функцию Передача защищенных сигналов. Нажмите Save (Сохранить).

Водопад

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

Передавать защищенные сигналы в запросах ставок

Ставки

Нажмите Инвентарь > Защищенные сигналы. В разделе Защищенные сигналы найдите Unity Ads и сдвиньте вправо переключатель Включить интеграцию с приложениями.

Нажмите Сохранить.

Водопад

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

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Ставки

Нажмите Выполнение > Настройки каналов спроса. На вкладке Настройки по умолчанию сдвиньте переключатель Разрешить передачу защищенных сигналов вправо для параметра Назначение ставок в SDK.

Нажмите Сохранить.

Водопад

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

Как настроить назначение ставок в Unity Ads

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Нажмите Новая система назначения ставок.

В качестве системы назначения ставок выберите Unity Ads.

Нажмите Продолжить, чтобы включить назначение ставок в SDK для этой системы назначения ставок.

Нажмите Готово.

Водопад

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

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

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Выберите компанию для Unity Ads.

Перейдите на вкладку Сопоставление рекламных блоков и нажмите Новое сопоставление рекламных блоков.

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

Нажмите Сохранить.

Водопад

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

Прокрутите страницу до раздела Партнеры по группе доходности и нажмите Добавить партнера по медиации.

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

Укажите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе, а также цену за тысячу показов по умолчанию. Нажмите Сохранить.

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

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

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

Используйте Swift Package Manager

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

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

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

Через CocoaPods

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

Интеграция вручную

Скачайте последнюю версию Unity Ads SDK и свяжите UnityAds.framework со своим проектом.
Скачайте последнюю версию адаптера Unity Ads по ссылке в списке изменений и свяжите UnityAdapter.framework со своим проектом.

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

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

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

Адаптер Unity Ads для iOS версии 4.19.0.1 и более поздних поддерживает передачу сигналов согласия по GDPR от платформ для запросов согласия, интегрированных со спецификацией Transparency and Consent Framework (TCF) от IAB, в рекламный SDK Unity Ads. Подробнее о том, как настроить конфигурацию согласия, соответствующую или не соответствующую спецификации TCF…

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

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

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

Swift

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()UnityAdsMediationSwiftSnippets.swift

Objective-C

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];UnityAdsMediationObjectiveCSnippets.m

Дополнительную информацию и значения, которые можно указать в каждом методе, вы найдете в статье Unity Ads Consumer privacy act compliance (Соблюдение законов о защите конфиденциальности потребителей).

Как настроить обработку с учетом возраста

Адаптер медиации Unity Ads версии 4.16.6.0 и более поздних передает в Unity Ads настройку "Контент для детей" и настройку Пользователи, не достигшие минимального возраста.

Чтобы обрабатывать эти сигналы для каждого пользователя, в Unity Ads необходимо включить параметр Mixed Audience (Смешанная аудитория) на панели управления Unity Monetization. Подробнее о том, как указать, что игра предназначена для смешанной аудитории…

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

Как реализовать SKAdNetwork

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

Ошибки компиляции

Swift

Для интеграции Swift дополнительный код не требуется.

Objective-C

Для адаптера Unity Ads версии 4.4.0.0 или более поздней необходимо выполнить действия по интеграции, описанные в документации Unity.

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

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

Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы и включите тестовый режим в интерфейсе Unity Ads.

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

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

Коды ошибок

Если адаптер не получает объявление от Unity Ads, издатель может проверить причину ошибки в ответе на запрос объявления, используя GADResponseInfo.adNetworkInfoArray в следующих классах:

GADMAdapterUnity
GADMediationAdapterUnity

Ниже приведены коды и сообщения об ошибках, которые возвращает адаптер UnityAds, когда не удается загрузить объявление.

Код ошибки	Причина
0-9	UnityAds SDK вернул ошибку. Подробную информацию можно найти в документации Unity.
101	Параметры сервера UnityAds, настроенные в интерфейсе Менеджера рекламы, отсутствуют или недействительны.
102	Устройство не поддерживается UnityAds.
103	Показ UnityAds завершен с ошибкой `kUnityAdsFinishStateError`.
104	Объект объявления Unity имеет значение nil после вызова его инициализатора.
105	Не удалось показать объявление Unity Ads, так как оно не готово.
107	UnityAds вызвала обратный вызов об изменении места размещения с состоянием места размещения `kUnityAdsPlacementStateDisabled`.
108	Объявление уже загружено для этого места размещения. UnityAds SDK не поддерживает загрузку нескольких объявлений для одного места размещения.
109	Размер баннера, возвращенного UnityAds, не соответствует запрошенному.
110	UnityAds возвращает ошибку инициализации.
111	Неподдерживаемый формат объявления.
112	UnityAds возвращает пустой токен назначения ставок.