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

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

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

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

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

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

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

Требования

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

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

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

Шаг 1. Настройте конфигурации в интерфейсе Unity Ads

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

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

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

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

Нажмите Монетизация Unity Ads > Начать.

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

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

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

Ставки

Водопад

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

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

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

Нажмите Unity Ads Monetization > 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 (Настройки организации) и запишите Organization core ID (Основной идентификатор организации).

Как обновить файл 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 в интерфейсе AdMob

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

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

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

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

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

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

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

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

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

Ставки

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

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

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

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

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

Водопад

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

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

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

Как добавить Unity Ads в список рекламных партнеров для GDPR и законов штатов США в отношении конфиденциальности

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

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

Как использовать 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. Реализуйте настройки конфиденциальности в Unity Ads SDK

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

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

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

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

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

В версии 2.0.0 SDK Unity Ads добавили API для поддержки настроек конфиденциальности. В приведенном ниже образце кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите передавать информацию о согласии в 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 о соблюдении закона о конфиденциальности потребителей.

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

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

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

Шаг 5. Добавьте обязательный код

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

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

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

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	SDK UnityAds вернул ошибку. Подробная информация приведена в документации 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 вернул пустой токен для назначения ставок.