В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Liftoff Monetize с помощью медиации , включая интеграцию ставок и водопада. В нем рассказывается, как добавить Liftoff Monetize в конфигурацию медиации рекламного блока, а также как интегрировать Vungle SDK и адаптер вUnity приложение.
Поддерживаемые интеграции и форматы объявлений
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Приложение открыто | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | 2 |
1 Интеграция назначения ставок находится на стадии открытого бета-тестирования.
2 Межстраничное объявление с вознаграждением требует помощи в настройке. Свяжитесь со своим менеджером по работе с клиентами по адресу Liftoff Monetize или monetize@liftoff.io
.
Требования
- Последняя версия Google Mobile Ads SDK
- Юнити 4 или выше
- (Для ставок): Плагин посредничества Google Mobile Ads для Liftoff Monetize 3.8.2 или более поздней версии ( рекомендуется последняя версия ).
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Unity проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Liftoff Monetize.
Зарегистрируйтесь или войдите в свою учетную запись Liftoff Monetize.
Добавьте свое приложение на панель управления Liftoff Monetize, нажав кнопку «Добавить приложение» .
Заполните форму, указав все необходимые данные.
Андроид
iOS
После создания приложения выберите его на панели управления Liftoff Monetize Applications .
Андроид
iOS
Обратите внимание на идентификатор приложения .
Андроид
iOS
Добавить новые места размещения
Чтобы создать новое место размещения, которое будет использоваться с медиацией Ad Manager, перейдите на панель мониторинга Liftoff Monetize Placements , нажмите кнопку «Добавить место размещения» и выберите свое приложение из раскрывающегося списка.
Подробности о добавлении новых мест размещения приведены ниже:
Баннер
Выберите «Баннер» , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Баннер 300х250
Выберите MREC , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Межстраничный
Выберите «Межстраничное объявление» , введите «Название места размещения» и заполните оставшуюся часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Награжден
Выберите «С вознаграждением» , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Межстраничное объявление с вознаграждением
Выберите «Награда» . Введите название места размещения , включите возможность пропуска и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Родной
Выберите «Нативный» , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Запишите идентификационный номер и нажмите « Звучит хорошо» .
Баннер
Баннер 300х250
Межстраничный
Награжден
Межстраничное объявление с вознаграждением
Родной
Найдите свой ключ API отчетности
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Помимо идентификатора приложения и эталонного идентификатора , вам также понадобится ключ API отчетности Liftoff Monetize Reporting, чтобы настроить идентификатор рекламного блокаAd Manager . Перейдите на панель мониторинга отчетов Liftoff Monetize и нажмите кнопку «Ключ API отчетов» , чтобы просмотреть свой ключ API отчетов .
Включите тестовый режим
Чтобы включить тестовые объявления, перейдите на панель управления Liftoff Monetize и выберите «Приложения» .
Выберите свое приложение, для которого вы хотите включить тестовые объявления, в разделе «Идентификатор места размещения» вашего приложения. Тестовые объявления можно включить, выбрав «Тестовый режим» , чтобы показывать тестовые объявления только в разделе «Статус» .
Андроид
iOS
Шаг 2. Настройте спрос на монетизацию Liftoff в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавлять Liftoff в соответствии с GDPR и списком рекламных партнеров США.
Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить Liftoff в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .
Шаг 3. Импортируйте Vungle SDK и адаптер Liftoff Monetize.
Загрузите последнюю версию плагина-посредника Google Mobile Ads для Liftoff Monetize по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsVungleMediation.unitypackage
из ZIP-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsVungleMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Ресурсы» > «Resolver служб Play» > «Android Resolver» > «Принудительное разрешение» . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Реализуйте настройки конфиденциальности в SDK Liftoff Monetize.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для Liftoff Monetize включает методы для передачи информации о согласии в Vungle SDK. В следующем примере кода показано, как передать информацию о согласии в Vungle SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif
Дополнительные сведения и значения, которые можно указать в методе, см. в инструкциях по реализации, рекомендованных GDPR для Android и iOS .
Законы штата США о конфиденциальности
Законы о конфиденциальности штатов США требуют предоставить пользователям право отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для Liftoff Monetize включает методы для передачи информации о согласии в Vungle SDK. В следующем примере кода показано, как передать информацию о согласии в Vungle SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
Дополнительные сведения и значения, которые можно указать в методе, см. в инструкциях по реализации, рекомендованных CCPA для Android и iOS .
Шаг 5. Добавьте необходимый код.
Андроид
Никакого дополнительного кода не требуется. Интеграция Liftoff Monetize.
iOS
Интеграция со SKAdNetwork
Следуйте документации Liftoff Monetize, чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager и включили тестовый режим в пользовательском интерфейсе Liftoff Monetize .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отLiftoff Monetize, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от Liftoff Monetize, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
iOS
Формат | Имя класса |
---|---|
Баннер | GADMAdapterVungleМежстраничное объявление |
Межстраничный | GADMAdapterVungleМежстраничное объявление |
Награжден | GADMAdapterVungleRewardBasedВидеообъявление |
Вот коды и сопутствующие сообщения, выдаваемые адаптером Liftoff Monetize, когда объявление не загружается:
iOS
Код ошибки | Причина |
---|---|
1-100 | Vungle SDK вернул ошибку. См. код для более подробной информации. |
101 | Параметры сервера Liftoff Monetize, настроенные в Ad Manager Пользовательский интерфейс отсутствует/недействителен. |
102 | Объявление для этой конфигурации сети уже загружено. Vungle SDK не может загрузить второе объявление для того же идентификатора места размещения. |
103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Liftoff Monetize. |
104 | Vungle SDK не удалось отобразить рекламный баннер. |
105 | Vungle SDK поддерживает загрузку только одного рекламного баннера за раз, независимо от идентификатора места размещения. |
106 | Vungle SDK отправил обратный вызов, сообщив, что рекламу невозможно воспроизвести. |
Журнал изменений плагина Liftoff Monetize Unity Mediation
Версия 5.2.1
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает адаптер Liftoff Monetize Android версии 7.4.0.1 .
- Поддерживает адаптер Liftoff Monetize iOS версии 7.4.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 5.2.0
- Поддерживает адаптер Liftoff Monetize Android версии 7.4.0.0 .
- Поддерживает адаптер Liftoff Monetize iOS версии 7.4.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 5.1.1
- Поддерживает адаптер Liftoff Monetize Android версии 7.3.2.0 .
- Поддерживает адаптер Liftoff Monetize iOS версии 7.3.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 5.1.0
- Исправлено исключение
NullPointerException
, приводившее к сбою сборки при экспорте в качестве проекта Android. - Обновлены API конфиденциальности:
- Удалены методы
UpdateConsentStatus()
иUpdateCCPAStatus()
. - Удалены перечисления
VungleConsentStatus
иVungleCCPAStatus
. - Обновлен метод
SetGDPRStatus(bool)
наSetGDPRStatus(bool, String)
.
- Удалены методы
- Из класса
LiftoffMonetizeMediationExtras
удалены следующие методы:-
SetAllPlacements(String[])
-
SetSoundEnabled(bool)
-
- Поддерживает адаптер Liftoff Monetize Android версии 7.3.1.0 .
- Поддерживает адаптер Liftoff Monetize iOS версии 7.3.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 5.0.0
- Исправлено предупреждение о дублировании определения для
MediationExtras
. - Поддерживает адаптер Liftoff Monetize Android версии 7.1.0.0 .
- Поддерживает адаптер Liftoff Monetize iOS версии 7.2.1.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.7.0.
Версия 4.0.0
- Плагин-посредник Unity переименован с Vungle на Liftoff Monetize.
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/LiftoffMonetize/
. - Пространство имен адаптера изменено для использования
GoogleMobileAds.Mediation.LiftoffMonetize
. - В класс
LiftoffMonetize
добавлены следующие методы:-
SetGDPRStatus(bool)
-
SetGDPRMessageVersion(String)
-
SetCCPAStatus(bool)
-
- Поддерживает адаптер Liftoff Monetize Android версии 6.12.1.1 .
- Поддерживает адаптер Liftoff Monetize iOS версии 7.0.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.4.1.
Версия 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.