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

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

Поддерживаемые интеграции и форматы рекламы

Интеграция
Торги 1
Водопад
Форматы
Баннер 2
межстраничный
Вознагражден

1 Интеграция ставок находится в стадии бета-тестирования.

Баннеры поддерживаются только для водопадной медиации. В настоящее время ставки не поддерживают рекламные баннеры.

Требования

  • Юнити 4 или выше
  • Последняя версия Google Mobile Ads SDK [для ставок]: подключаемый модуль посредничества Google Mobile Ads для Vungle 3.8.2 или более поздней версии (рекомендуется последняя версия)
  • Для развертывания на Android
    • Android API уровня 21 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 10.0 или выше
    • [Для торгов]: адаптер Vungle 6.11.0.1 или выше (рекомендуется последняя версия)
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробнее см. в разделе Начало работы .

Ограничения

  • Vungle не поддерживает загрузку нескольких объявлений с использованием одного и того же идентификатора размещения.
    • Адаптер Vungle изящно отклоняет второй запрос, если другой запрос для этого размещения загружается или ожидает отображения.
  • Vungle поддерживает загрузку только одного рекламного баннера за раз.
    • Адаптер Vungle корректно отклоняет последующие запросы баннеров, если рекламный баннер уже загружен.

Шаг 1. Настройте Vungle

Зарегистрируйтесь или войдите в свою учетную запись Vungle.

Добавьте свое приложение на панель управления приложениями Vungle , нажав кнопку «Добавить приложение» .

Заполните форму, указав все необходимые данные.

Андроид

iOS

После создания приложения выберите его на панели управления приложениями Vungle .

Андроид

iOS

Обратите внимание на идентификатор приложения .

Андроид

iOS

Добавить новые места размещения

Чтобы создать новое место размещения для использования с посредничеством AdMob, перейдите на панель инструментов Vungle Placements , нажмите кнопку «Добавить место размещения» и выберите свое приложение из раскрывающегося списка.

Подробная информация о добавлении новых мест размещения приведена ниже:

Выберите Баннер , введите желаемое название места размещения и заполните оставшуюся часть формы. [Только водопад] Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Баннер 300x250

Выберите MREC , введите желаемое название места размещения и заполните оставшуюся часть формы. [Только водопад] Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

межстраничный

Выберите Interstitial , введите желаемое название места размещения и заполните оставшуюся часть формы. [Только водопад] Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Вознагражден

Выберите Rewarded , введите желаемое название места размещения и заполните оставшуюся часть формы. [Только водопад] Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.

Укажите, как монетизировать свой инвентарь

Торги

В разделе «Монетизация» установите переключатель «Ставки в приложении» в положение « Включено» и нажмите кнопку «Продолжить» .

Водопад

Никаких дополнительных действий не требуется.

Запишите Reference ID и нажмите «Звучит хорошо» .

Баннер 300x250

межстраничный

Вознагражден

Найдите свой ключ API отчетов

Торги

Этот шаг не требуется для интеграции ставок.

Водопад

В дополнение к идентификатору приложения и эталонному идентификатору вам также потребуется ключ Vungle Reporting API для настройки идентификатора рекламного блока AdMob. Перейдите на панель мониторинга Vungle Reports и нажмите кнопку Reporting API Key , чтобы просмотреть свой Reporting API Key .

Шаг 2. Настройте рекламный блок AdMob

Вам нужно добавить Vungle в конфигурацию агрегатора для ваших рекламных блоков AdMob. Сначала войдите в свой аккаунт AdMob .

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

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

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

Андроид

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

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

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

iOS

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

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

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

Добавьте Vungle в качестве источника рекламы

Торги

В карточке «Ставки» в разделе «Источники рекламы» выберите «Добавить источник рекламы» . Затем выберите Vungle .

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

Наконец, нажмите Сохранить .

Водопад

На карточке «Источники рекламы» выберите «Добавить рекламную сеть» . Выберите Vungle и включите переключатель Оптимизировать . В поле Reporting API Key введите ключ Reporting API , полученный в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для Vungle. Затем введите значение eCPM для Vungle и нажмите «Продолжить» .

Введите идентификатор приложения и идентификатор размещения , полученные в предыдущем разделе. Если вы используете версию 4.x или более раннюю версию Vungle SDK, поле Placement Reference ID можно оставить пустым.

Андроид

iOS

Объявления с вознаграждением

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

Если вы не переопределите вознаграждение, адаптер Vungle по умолчанию использует вознаграждение типа vungle со значением 1 . Vungle SDK не предоставляет конкретных значений вознаграждения за рекламу с вознаграждением.

Дополнительную информацию о настройке значений вознаграждения для рекламных блоков AdMob см. в разделе Создание рекламного блока .

Шаг 3. Импорт Vungle SDK и адаптера

Загрузите последнюю версию подключаемого модуля посредничества Google Mobile Ads для Vungle по ссылке для скачивания в журнале изменений и извлеките GoogleMobileAdsVungleMediation.unitypackage из ZIP-файла.

В редакторе проектов Unity выберите Assets > Import Package > Custom Package и найдите загруженный файл GoogleMobileAdsVungleMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .

Затем выберите Assets > Play Services Resolver > Android Resolver > Force Resolve . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Шаг 4: Требуется дополнительный код

Для интеграции с Vungle не требуется дополнительный код.

Шаг 5. Протестируйте свою реализацию

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

Выберите свое приложение, для которого вы хотите включить тестовую рекламу, в разделе «Идентификатор ссылки на место размещения» вашего приложения. Тестовые объявления можно включить, выбрав Тестовый режим для показа тестовых объявлений только в разделе Статус .

Андроид

iOS

Вот и все! Теперь у вас есть рабочая интеграция посредничества с Vungle.

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

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

В разделе ниже показано, как включить или отключить персонализированную рекламу для Vungle.

Плагин посредничества Google Mobile Ads для Vungle версии 3.9.2 включает метод Vungle.UpdateConsentStatus() , которому можно передать два возможных значения:

  • VungleConsentStatus.OPTED_IN
  • VungleConsentStatus.OPTED_OUT

В следующем примере кода показано, как передать информацию о согласии в Vungle SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Vungle;
// ...

Vungle.UpdateConsentStatus(VungleConsentStatus.OPTED_IN);

Дополнительные сведения см. в статьях GDPR и конфиденциальности Vungle.

Добавьте Vungle в список рекламных партнеров GDPR

Следуйте инструкциям в настройках GDPR , чтобы добавить Vungle в список рекламных партнеров GDPR в пользовательском интерфейсе AdMob.

CCPA

Калифорнийский закон о конфиденциальности потребителей (CCPA)требует предоставить жителям штата Калифорния право отказаться от «продажи» своей «личной информации» (как определяет закон). эти условия), при этом отказ от участия предлагается через заметную ссылку «Не продавать мою личную информацию» на домашней странице «продающей» стороны. Руководство по подготовке к CCPA предлагает возможность включить ограниченную обработку данных для показа объявлений Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке посредничества. Таким образом, вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей, чтобы обеспечить соответствие CCPA.

Плагин посредничества Google Mobile Ads для Vungle версии 3.9.2 включает метод Vungle.UpdateCCPAStatus() , которому можно передать два возможных значения:

  • VungleCCPAStatus.OPTED_IN
  • VungleCCPAStatus.OPTED_OUT

В следующем примере кода показано, как передать информацию о согласии в Vungle SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.Vungle;
// ...

Vungle.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);

Дополнительные сведения см. в статье о конфиденциальности Vungle.

Добавьте Vungle в список рекламных партнеров CCPA

Следуйте инструкциям в настройках CCPA , чтобы добавить Vungle в список рекламных партнеров CCPA в пользовательском интерфейсе AdMob.

Коды ошибок

Если адаптеру не удается получить рекламу от Vungle, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo в следующих классах:

iOS

Формат Имя класса
Баннер GADMAdapterVungleInterstitial
межстраничный GADMAdapterVungleInterstitial
Вознагражден GADMAdapterVungleRewardBasedVideoAd

Вот коды и сопутствующие сообщения, выдаваемые адаптером Vungle, когда объявление не загружается:

iOS

Код ошибки Причина
1-100 Vungle SDK возвратил ошибку. См. документацию для более подробной информации.
101 Параметры сервера Vungle, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
102 Объявление уже загружено для этой конфигурации сети. Vungle SDK не может загрузить второе объявление для того же идентификатора места размещения.
103 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Vungle.
104 Vungle SDK не смог отобразить рекламный баннер.
105 Vungle SDK поддерживает загрузку только одного рекламного баннера за раз, независимо от идентификатора места размещения.
106 Vungle SDK отправил обратный вызов, указав, что реклама не воспроизводится.

Журнал изменений подключаемого модуля Vungle Unity Mediation

Следующая версия

  • Содержимое адаптера перемещено в GoogleMobileAds/Mediation/Vungle/ .
  • Рефакторинг пространства имен адаптера для использования GoogleMobileAds.Mediation.Vungle .

Версия 3.9.2

  • Обновлен класс Vungle :
    • Добавлен метод UpdateCCPAStatus(VungleCCPAStatus) .
    • Удален метод GetCurrentConsentStatus() .
    • Удален метод GetCurrentConsentMessageVersion() .
  • Поддерживает адаптер Vungle Android версии 6.12.1.0 .
  • Поддерживает адаптер Vungle iOS версии 6.12.2.0 .
  • Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.4.1.

Версия 3.9.1

Версия 3.9.0

Версия 3.8.2

Версия 3.8.1

Версия 3.8.0

Версия 3.7.5

Версия 3.7.4

Версия 3.7.3

Версия 3.7.2

Версия 3.7.1

Версия 3.7.0

Версия 3.6.0

Версия 3.5.1

Версия 3.5.0

Версия 3.4.1

Версия 3.4.0

Версия 3.3.1

Версия 3.3.0

Версия 3.2.0

Версия 3.1.4

  • Поддерживает адаптер Android версии 6.3.24.1.
  • Поддерживает адаптер iOS версии 6.3.2.3.

Версия 3.1.3

  • Поддерживает адаптер Android версии 6.3.24.1.
  • Поддерживает адаптер iOS версии 6.3.2.2.

Версия 3.1.2

  • Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
  • Поддерживает адаптер Android версии 6.3.24.1.
  • Поддерживает адаптер iOS версии 6.3.2.1.

Версия 3.1.1

  • Поддерживает адаптер Android версии 6.3.24.0.
  • Поддерживает адаптер iOS версии 6.3.2.0.
  • Обновлен метод Vungle.UpdateConsentStatus() , чтобы сделать параметр consentMessageVersion необязательным. Значение consentMessageVersion теперь игнорируется для iOS.
  • Устарело Vungle.GetCurrentConsentMessageVersion() для iOS.

Версия 3.1.0

  • Поддерживает адаптер Android версии 6.3.17.0.
  • Поддерживает адаптер iOS версии 6.3.0.0.
  • Обновлен метод Vungle.UpdateConsentStatus() , который принимает дополнительный параметр String для версии сообщения о согласии, предоставленной издателем.
  • Добавлен метод Vungle.GetCurrentConsentMessageVersion() для получения версии сообщения о согласии, предоставленной издателем.

Версия 3.0.1

  • Поддерживает адаптер Android версии 6.2.5.1.
  • Поддерживает адаптер iOS версии 6.2.0.3.

Версия 3.0.0

  • Поддерживает адаптер Android версии 6.2.5.0.
  • Поддерживает адаптер iOS версии 6.2.0.2.
  • Добавлены следующие методы:
    • Vungle.UpdateConsentStatus() для установки статуса согласия, который будет записан в Vungle SDK.
    • Vungle.GetCurrentConsentStatus() для получения текущего статуса согласия пользователя.

Версия 2.0.0

  • Поддерживает адаптер Android версии 5.3.2.1.
  • Поддерживает адаптер iOS версии 6.2.0.0.

Версия 1.1.0

  • Поддерживает адаптер Android версии 5.3.2.1.
  • Поддерживает адаптер iOS версии 5.4.0.0.

Версия 1.0.0

  • Первый выпуск!
  • Поддерживает адаптер Android версии 5.3.0.0.
  • Поддерживает адаптер iOS версии 5.3.0.0.