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

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

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

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

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

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

Требования

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

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

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

Шаг 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 Reporting для Unity Ads

Ставки

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

Водопад

Перейдите в раздел Unity Ads Monetization (Монетизация Unity Ads) > API management (Управление API) и найдите API Key (Ключ 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, активируйте параметр Переопределить тестовый режим клиента и выберите Принудительно включить тестовый режим (использовать тестовые объявления) для всех устройств.

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

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

Шаг 2. Настройте спрос на рекламу Unity Ads в интерфейсе AdMob

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

Добавьте Unity Ads в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Перейдите на вкладку Медиация. Если вы хотите изменить существующую группу медиации, нажмите на ее название и перейдите к разделу Добавьте Unity Ads в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

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

Укажите название группы медиации и выберите местоположения для таргетинга. Затем установите для статуса группы медиации значение Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими рекламными блоками AdMob. Затем нажмите Готово.

Выбранные рекламные блоки появятся на карточке:

Как добавить Unity Ads в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и выберите Добавить источник объявлений. Затем выберите Unity Ads.

Нажмите Как подписать партнерское соглашение и установите партнерскую связь с назначением ставок с Unity Ads.

Нажмите Подтвердить и согласиться, а затем – Продолжить.

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

Затем введите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе. Затем нажмите Готово.

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите Unity Ads и включите переключатель Оптимизировать. Чтобы настроить оптимизацию источника объявлений для Unity Ads, введите ключ API и основной идентификатор организации, полученные в предыдущем разделе. Затем введите значение эффективной цены за тысячу показов для Unity Ads и нажмите Продолжить.

Примечание. Чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов в сети медиации, требуется несколько дней. Пока оптимизация источника объявлений имеет статус PENDING, вам нужно вручную задать эффективную цену за тысячу показов для сети. Как только эффективная цена за тысячу показов будет рассчитана, источник объявлений начнет автоматически обновлять ее от вашего имени.

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

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

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

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

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

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

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

Коды ошибок

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

GADMAdapterUnity
GADMediationAdapterUnity

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

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