Это руководство предназначено для издателей, которые хотят использовать Google Mobile Ads SDK для загрузки и отображения рекламы из Fyber Marketplace через посредничество . В нем рассказывается, как добавить Fyber Marketplace в конфигурацию посредничества рекламного блока и как интегрировать SDK и адаптер Fyber Marketplace в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер агрегатора AdMob для Fyber Marketplace имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
межстраничный | |
Вознагражден |
Требования
- Юнити 4 или выше
- Последняя версия Google Mobile Ads SDK
- Для развертывания на Android
- Android API уровня 19 или выше
- Для развертывания на iOS
- Цель развертывания iOS 10.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробнее см. в разделе Начало работы .
Шаг 1. Настройте рынок Fyber.
Добавить новое приложение и место размещения рекламы
Зарегистрируйтесь или войдите в Fyber Console.
Нажмите кнопку « Добавить приложение », чтобы добавить свое приложение.
Выберите платформу в разделе « Платформа », заполните оставшуюся часть формы и нажмите « Добавить места размещения » .
Андроид
iOS
Введите название нового места размещения в поле « Назовите свое место размещения» и выберите нужный тип места размещения из раскрывающегося списка. Наконец, нажмите Сохранить размещение .
Идентификатор приложения и идентификатор места размещения
Откройте левую панель навигации, наведя на нее указатель мыши. Затем нажмите « Приложения» в меню слева.
На странице управления приложениями обратите внимание на идентификатор приложения рядом с вашим приложением.
Выберите свое приложение, перейдите на вкладку « Места размещения » и нажмите значок копирования рядом с « Название места размещения» . Обратите внимание на идентификатор места размещения .
Идентификатор издателя, ключ потребителя и секрет потребителя
Нажмите на свое имя пользователя в меню слева и выберите « Профиль пользователя ».
Обратите внимание на Publisher ID , Consumer Key и Consumer Secret , так как они понадобятся на следующем шаге.
Шаг 2. Настройте параметры агрегатора для рекламного блока AdMob.
Вам нужно добавить Fyber Marketplace в конфигурацию посредничества для вашего рекламного блока.
Если вы развертываете приложение Unity как для Android, так и для iOS, вам понадобятся два рекламных блока AdMob, по одному для каждой платформы.
Андроид
Сначала войдите в свой аккаунт AdMob . Далее перейдите на вкладку Медиация . Если у вас есть существующая группа посредничества, которую вы хотите изменить, щелкните имя этой группы посредничества, чтобы изменить его, и перейдите к разделу Добавить Fyber Marketplace в качестве источника рекламы .
Чтобы создать новую группу медиации, выберите «Создать группу медиации» .
Укажите формат объявления и платформу, затем нажмите «Продолжить » .
Дайте вашей группе медиации имя и выберите местоположения для таргетинга. Затем установите для группы медиации статус « Включено » и нажмите « Добавить рекламные блоки » .
Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово .
Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками.
iOS
Сначала войдите в свой аккаунт AdMob . Далее перейдите на вкладку Медиация . Если у вас есть существующая группа медиации, которую вы хотите изменить, щелкните имя этой группы медиации, чтобы изменить ее, и перейдите к разделу Добавить Fyber Marketplace в качестве источника рекламы .
Чтобы создать новую группу медиации, выберите «Создать группу медиации» .
Укажите формат объявления и платформу, затем нажмите «Продолжить » .
Дайте вашей группе медиации имя и выберите местоположения для таргетинга. Затем установите для группы медиации статус « Включено » и нажмите « Добавить рекламные блоки » .
Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово .
Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками.
Добавьте Fyber Marketplace в качестве источника рекламы
На карточке водопада выберите Добавить источник рекламы .
Выберите Fyber Marketplace , и вы должны перейти к Добавить источник рекламы: Fyber Marketplace.
Включите переключатель Оптимизация . Затем введите идентификатор издателя , ключ потребителя и секрет потребителя , полученные в предыдущем разделе. Просмотрите и установите флажок Авторизация , чтобы настроить оптимизацию источника рекламы для Fyber Marketplace. Введите значение эффективной цены за тысячу показов для Fyber Marketplace и нажмите « Продолжить » .
Введите идентификатор приложения и идентификатор размещения , полученные на предыдущем шаге, и нажмите « Готово ».
Андроид
iOS
Использование объявлений с вознаграждением
В настройках рекламного блока с вознаграждением укажите значения суммы и типа вознаграждения. Чтобы предоставить пользователю одинаковое вознаграждение независимо от того, какая рекламная сеть обслуживается, установите флажок Применить ко всем сетям в группах агрегатора.
Если вы не примените этот параметр, адаптер Fyber Marketplace вернет вознаграждение, указанное на панели инструментов Fyber Marketplace при создании места размещения.
Дополнительную информацию о настройке значений вознаграждения для рекламных блоков AdMob см. в разделе Создание рекламного блока .
Шаг 3. Импортируйте SDK и адаптер Fyber Marketplace
Загрузите последнюю версию подключаемого модуля посредничества Google Mobile Ads для Fyber Marketplace по ссылке для скачивания в журнале изменений и извлеките GoogleMobileAdsFyberMediation.unitypackage
из ZIP-файла.
В редакторе проектов Unity выберите Assets > Import Package > Custom Package и найдите загруженный файл GoogleMobileAdsFyberMediation.unitypackage
. Убедитесь, что выбраны все файлы, и нажмите « Импорт» .
Затем выберите Assets > Play Services Resolver > Android Resolver > Force Resolve . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Дополнительные шаги
Согласие ЕС и GDPR
В соответствии с Политикой Google в отношении согласия пользователей из ЕС вы должны обеспечить раскрытие определенной информации и получение согласия пользователей в Европейской экономической зоне (ЕЭЗ) в отношении использования идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС по электронной конфиденциальности и Общего регламента по защите данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей посреднической цепочке, которая может собирать, получать или использовать личные данные, и предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать согласие пользователя в такие сети.
В разделе ниже показано, как включить или отключить персонализированную рекламу для Fyber Marketplace.
Плагин посредничества Google Mobile Ads для Fyber Marketplace версии 1.1.0 добавил класс Fyber
с SetGDPRRequired()
и SetGDPRConsentString()
, что позволяет вам вручную передавать информацию о согласии в Fyber Marketplace. В следующем примере кода показано, как передать эти параметры адаптеру Fyber Marketplace:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGdprConsentString");
Дополнительную информацию см. в статье GDPR на Fyber Marketplace.
Добавьте Fyber в список рекламных партнеров GDPR
Следуйте инструкциям в настройках GDPR, чтобы добавить Fyber в список рекламных партнеров GDPR в пользовательском интерфейсе AdMob.
Коды ошибок
Если адаптеру не удается получить рекламу из Fyber Marketplace, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo
в следующем классе:
Андроид
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Вот коды и сопутствующие сообщения, выдаваемые адаптером Fyber Marketplace, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
101 | Параметры сервера Fyber, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны. |
103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Fyber. |
105 | Fyber SDK загрузил рекламу, но вернул непредвиденный контроллер. |
106 | Объявление не готово к показу. |
200-399 | Fyber SDK вернул ошибку. См. код для более подробной информации. |
iOS
Код ошибки | Причина |
---|---|
0-10 | SDK Fyber Marketplace вернул ошибку. См. документацию для более подробной информации. |
101 | Параметры сервера Fyber Marketplace, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны. |
102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Fyber Marketplace. |
103 | Не удалось показать объявление, поскольку объект объявления уже использовался. |
104 | Не удалось показать рекламу Fyber Marketplace, поскольку реклама не готова. |
105 | SDK Fyber Marketplace вернул ошибку инициализации. |
Список изменений плагина Fyber Unity Mediation
Версия 3.1.0
- Поддерживает адаптер Fyber Android версии 8.2.0.0 .
- Поддерживает адаптер Fyber iOS версии 8.1.5.0 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.2.0.
Версия 3.0.2
- Поддерживает адаптер Fyber Android версии 8.1.3.1 .
- Поддерживает адаптер Fyber iOS версии 8.1.5.0 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.0.2.
Версия 3.0.1
- Поддерживает адаптер Fyber Android версии 8.1.3.0 .
- Поддерживает адаптер Fyber iOS версии 8.1.4.0 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.0.0.
Версия 3.0.0
- Поддерживает адаптер Fyber Android версии 8.1.2.0 .
- Поддерживает адаптер Fyber iOS версии 8.1.2.0 .
Версия 2.0.0
- Поддерживает адаптер Fyber Android версии 7.8.4.1 .
- Поддерживает адаптер Fyber iOS версии 8.0.0.0 .
Версия 1.6.1
- Поддерживает адаптер Fyber Android версии 7.8.3.0 .
- Поддерживает адаптер Fyber iOS версии 7.8.6.0 .
Версия 1.6.0
- Поддерживает адаптер Fyber Android версии 7.8.2.0 .
- Поддерживает адаптер Fyber iOS версии 7.8.5.0 .
Версия 1.5.2
- Поддерживает адаптер Fyber Android версии 7.7.4.0 .
- Поддерживает адаптер Fyber iOS версии 7.7.3.0 .
Версия 1.5.1
- Поддерживает адаптер Fyber Android версии 7.7.2.0 .
- Поддерживает адаптер Fyber iOS версии 7.7.2.0 .
Версия 1.5.0
- Поддерживает адаптер Fyber Android версии 7.7.1.0 .
- Поддерживает адаптер Fyber iOS версии 7.7.1.0 .
Версия 1.4.0
- Поддерживает адаптер Fyber Android версии 7.7.0.0 .
- Поддерживает адаптер Fyber iOS версии 7.6.4.0 .
Версия 1.3.0
- Поддерживает адаптер Fyber Android версии 7.6.0.0 .
- Поддерживает адаптер Fyber iOS версии 7.6.0.0 .
Версия 1.2.3
- Поддерживает адаптер Fyber Android версии 7.5.4.0 .
- Поддерживает адаптер Fyber iOS версии 7.5.6.0 .
Версия 1.2.2
- Поддерживает адаптер Fyber Android версии 7.5.3.0 .
- Поддерживает адаптер Fyber iOS версии 7.5.4.0 .
Версия 1.2.1
- Поддерживает адаптер Fyber Android версии 7.5.2.0 .
- Поддерживает адаптер Fyber iOS версии 7.5.3.0 .
Версия 1.2.0
- Поддерживает адаптер Fyber Android версии 7.5.0.0 .
- Поддерживает адаптер Fyber iOS версии 7.5.1.0 .
Версия 1.1.0
- В класс
Fyber
добавлены следующие методы для поддержки требований GDPR:-
SetGDPRConsent()
-
SetGDPRConsentString()
-
ClearGDPRConsentData()
-
- Поддерживает адаптер Fyber Android версии 7.3.4.0 .
- Поддерживает адаптер Fyber iOS версии 7.5.0.0 .
Версия 1.0.0
- Первый выпуск!
- Поддерживает адаптер Fyber Android версии 7.3.4.0 .
- Поддерживает адаптер Fyber iOS версии 7.4.0.0 .