В этом руководстве показано, как использовать 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.
Дополнительные шаги
Согласие ЕС и GDPR
В соответствии с Политикой 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
- Поддерживает адаптер Vungle Android версии 6.12.1.0 .
- Поддерживает адаптер Vungle iOS версии 6.12.1.1 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.4.0.
Версия 3.9.0
- Поддерживает адаптер Vungle Android версии 6.12.0.0 .
- Поддерживает адаптер Vungle iOS версии 6.12.0.0 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.2.0.
Версия 3.8.2
- Поддерживает адаптер Vungle Android версии 6.11.0.2 .
- Поддерживает адаптер Vungle iOS версии 6.11.0.1 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.1.0.
Версия 3.8.1
- Поддерживает адаптер Vungle Android версии 6.11.0.1 .
- Поддерживает адаптер Vungle iOS версии 6.11.0.0 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.0.2.
Версия 3.8.0
- Поддерживает адаптер Vungle Android версии 6.11.0.0 .
- Поддерживает адаптер Vungle iOS версии 6.11.0.0 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.0.0.
Версия 3.7.5
- Поддерживает адаптер Vungle Android версии 6.10.5.0 .
- Поддерживает адаптер Vungle iOS версии 6.10.6.1 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.0.0.
Версия 3.7.4
- Поддерживает адаптер Vungle Android версии 6.10.4.0 .
- Поддерживает адаптер Vungle iOS версии 6.10.6.1 .
- Создан и протестирован с помощью подключаемого модуля Google Mobile Ads Unity версии 7.0.0.
Версия 3.7.3
- Поддерживает адаптер Vungle Android версии 6.10.3.0 .
- Поддерживает адаптер Vungle iOS версии 6.10.5.1 .
Версия 3.7.2
- Поддерживает адаптер Vungle Android версии 6.10.2.1 .
- Поддерживает адаптер Vungle iOS версии 6.10.5.1 .
Версия 3.7.1
- Поддерживает адаптер Vungle Android версии 6.10.2.0 .
- Поддерживает адаптер Vungle iOS версии 6.10.4.0 .
Версия 3.7.0
- Поддерживает адаптер Vungle Android версии 6.10.2.0 .
- Поддерживает адаптер Vungle iOS версии 6.10.3.0 .
Версия 3.6.0
- Поддерживает адаптер Vungle Android версии 6.9.1.1 .
- Поддерживает адаптер Vungle iOS версии 6.9.2.0 .
Версия 3.5.1
- Поддерживает адаптер Vungle Android версии 6.8.1.0 .
- Поддерживает адаптер Vungle iOS версии 6.8.1.0 .
Версия 3.5.0
- Поддерживает адаптер Vungle Android версии 6.8.0.0 .
- Поддерживает адаптер Vungle iOS версии 6.8.0.0 .
Версия 3.4.1
- Поддерживает адаптер Vungle Android версии 6.7.1.0 .
- Поддерживает адаптер Vungle iOS версии 6.7.1.0 .
Версия 3.4.0
- Поддерживает адаптер Vungle Android версии 6.7.0.0 .
- Поддерживает адаптер Vungle iOS версии 6.7.0.0 .
Версия 3.3.1
-
vungle-extras-library.jar
переупакован вvungle-unity-android-library.aar
с использованием сборки.aar
для поддержки Unity 2020.- При обновлении до этой версии удалите
vungle-extras-library.jar
из своего проекта.
- При обновлении до этой версии удалите
- Поддерживает адаптер Vungle Android версии 6.5.3.0 .
- Поддерживает адаптер Vungle iOS версии 6.5.3.0 .
Версия 3.3.0
- Поддерживает адаптер Vungle Android версии 6.5.3.0 .
- Поддерживает адаптер Vungle iOS версии 6.5.3.0 .
Версия 3.2.0
- Поддерживает адаптер Vungle Android версии 6.4.11.1 .
- Поддерживает адаптер Vungle iOS версии 6.4.6.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.