В этом руководстве показано, как использовать Google Mobile Ads Unity Plugin для загрузки и отображения объявлений из BidMachine с помощью AdMob Mediation , включая интеграцию с системой назначения ставок. В нем рассказывается о том, как добавить BidMachine в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер BidMachine в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер AdMob для медиации в BidMachine обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | 1 |
| Форматы | |
| Приложение открыто | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
1. Интеграция с Waterfall находится в закрытой бета-версии. Свяжитесь со своим менеджером по работе с клиентами, чтобы запросить доступ.
Предварительные требования
Прежде чем продолжить, проверьте следующее:
- Последняя версия Google Mobile Ads Unity Plugin .
- Версия редактора Unity: 2019.4 или более поздняя.
- Для развертывания на Android
- Android API уровня 24 или более поздней версии.
- Для развертывания на iOS
- Целевая версия iOS — 13.0 или более поздняя.
- Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Начало работы» .
- Настройте медиацию AdMob .
Шаг 1: Настройка параметров в пользовательском интерфейсе BidMachine.
Войдите в панель управления своей учетной записи BidMachine.
Создать новые вакансии
Перейдите на вкладку «Источники» и в таблице «Источники» выберите кнопку «Редактировать» .

Вам будет показан список всех ваших мест стажировки. Чтобы создать новое место стажировки, нажмите кнопку «Добавить место стажировки» в диалоговом окне.

Выберите «Торги» в качестве типа размещения . Заполните форму и нажмите «Сохранить» .
Android

iOS

Наконец, обратите внимание на идентификатор места размещения (Placement ID) .
Android

iOS

Обновите файл app-ads.txt.
Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов рекламы в приложениях , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для своего приложения .
Чтобы добавить файл app-ads.txt в BidMachine, перейдите на вкладку app-ads.txt в панели управления . Затем скопируйте список и добавьте его в файл app-ads.txt вашего сайта.
Шаг 2: Настройте параметры BidMachine в пользовательском интерфейсе AdMob.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте BidMachine в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.
Чтобы добавить BidMachine в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе AdMob, выполните действия, описанные в настройках европейских и американских нормативных требований .
Шаг 3: Импортируйте SDK и адаптер BidMachine.
Для интеграции с BidMachine дополнительный код не требуется.iOS
Интеграция SKAdNetwork
Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте инструкциям в документации BidMachine по поддержке SKAdNetwork .
Шаг 6: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob.
Чтобы включить тестовый режим в BidMachine, следуйте инструкциям в документации BidMachine для Android и iOS .
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от BidMachine, включите тестирование по одному источнику объявлений в инспекторе объявлений, используя источник(и ) объявлений BidMachine (торги ).
коды ошибок
Если адаптер не получает объявление от BidMachine, издатели могут проверить основную причину ошибки в ответе на объявление, используя ResponseInfo из следующих классов:
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
Вот коды и соответствующие сообщения, которые выдает адаптер BidMachine, когда объявление не загружается:
Android
| Код ошибки | Домен | Причина |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | Получен недействительный или пустой идентификатор размещения. |
| 101 | com.google.ads.mediation.bidmachine | Ошибка при сборе сигнала: конфигурация данных сигнала не найдена. |
| 102 | com.google.ads.mediation.bidmachine | В процессе сбора сигнала получен недопустимый формат объявления. |
| 103 | com.google.ads.mediation.bidmachine | Запрошенный размер объявления не удалось сопоставить с bidmachine.BannerSize |
| 104 | com.google.ads.mediation.bidmachine | Запрос на размещение объявления в BidMachine истек. |
| 105 | com.google.ads.mediation.bidmachine | Полноэкранная реклама не может быть показана. |
| 106 | com.google.ads.mediation.bidmachine | BidMachine SDK вернул функцию обратного вызова onAdLoaded() с null данными объявления. |
iOS
| Код ошибки | Домен | Причина |
|---|---|---|
| 101 | com.google.mediation.bidmachine | В конфигурации сервера отсутствует обязательный идентификатор издателя. |
| 102 | com.google.mediation.bidmachine | Запрос на сбор сигналов для торгов не удался, поскольку параметры RTB не содержат формат объявления или указанный формат не поддерживается. |
| 103 | com.google.mediation.bidmachine | Неверные настройки объявления для его загрузки. |
| 104 | com.google.mediation.bidmachine | BidMachine SDK вернул небаннерное объявление в метод делегата BidMachineAdProtocol didLoadAd баннерного объявления. Такого никогда не должно происходить. |
| 105 | com.google.mediation.bidmachine | Полноэкранная реклама не готова к показу. |
| 106 | com.google.mediation.bidmachine | SDK Bid Machine вернул не нативное объявление в метод делегата BidMachineAdProtocol didLoadAd нативного объявления. Такого никогда не должно происходить. |
| 107 | com.google.mediation.bidmachine | Не удалось загрузить один из источников изображений для нативной рекламы. |
| 108 | com.google.mediation.bidmachine | BidMachine не поддерживает этот размер баннерной рекламы. |
Список изменений плагина BidMachine Unity Mediation
Версия 1.5.0
- Поддерживает адаптер BidMachine для Android версии 3.8.0.0 .
- Поддерживает адаптер BidMachine для iOS версии 3.8.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.5.0.
Версия 1.4.2
- Поддерживает адаптер BidMachine для Android версии 3.7.1.1 .
- Поддерживает адаптер BidMachine для iOS версии 3.7.1.0.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.1.0.
Версия 1.4.1
- Поддерживает адаптер BidMachine для Android версии 3.7.0.0 .
- Поддерживает адаптер BidMachine для iOS версии 3.7.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.1.0.
Версия 1.4.0
- Поддерживает адаптер BidMachine для Android версии 3.7.0.0 .
- Поддерживает адаптер BidMachine для iOS версии 3.7.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.1.0.
Версия 1.3.0
- Поддерживает адаптер BidMachine для Android версии 3.7.0.0 .
- Поддерживает адаптер BidMachine для iOS версии 3.6.1.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.1.0.
Версия 1.2.1
- Поддерживает адаптер BidMachine для Android версии 3.6.1.0 .
- Поддерживает адаптер BidMachine для iOS версии 3.6.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.
Версия 1.2.0
- Поддерживает адаптер BidMachine для Android версии 3.6.1.0 .
- Поддерживает адаптер BidMachine для iOS версии 3.6.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.
Версия 1.1.0
- Поддерживает адаптер BidMachine для Android версии 3.5.1.2 .
- Поддерживает адаптер BidMachine для iOS версии 3.6.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.
Версия 1.0.2
- Поддерживает адаптер BidMachine для Android версии 3.5.1.2 .
- Поддерживает адаптер BidMachine для iOS версии 3.5.1.2 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.
Версия 1.0.1
- Поддерживает адаптер BidMachine для Android версии 3.5.1.1 .
- Поддерживает адаптер BidMachine для iOS версии 3.5.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.7.0.
Версия 1.0.0
- Первый релиз!
- Поддерживает адаптер BidMachine для Android версии 3.5.1.0 .
- Поддерживает адаптер BidMachine для iOS версии 3.5.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.6.0.