Интеграция Fyber Marketplace с посредничеством

Это руководство предназначено для издателей, которые хотят использовать 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

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

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками.

iOS

Сначала войдите в свой аккаунт AdMob . Далее перейдите на вкладку Медиация . Если у вас есть существующая группа медиации, которую вы хотите изменить, щелкните имя этой группы медиации, чтобы изменить ее, и перейдите к разделу Добавить Fyber Marketplace в качестве источника рекламы .

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

Вкладка агрегатора AdMob

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

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

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками 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.

Дополнительные шаги

В соответствии с Политикой 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

Версия 3.0.2

Версия 3.0.1

Версия 3.0.0

Версия 2.0.0

Версия 1.6.1

Версия 1.6.0

Версия 1.5.2

Версия 1.5.1

Версия 1.5.0

Версия 1.4.0

Версия 1.3.0

Версия 1.2.3

Версия 1.2.2

Версия 1.2.1

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0