Интегрируйте Liftoff Monetize с медиацией

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

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

Интеграция
Торги
Водопад
Форматы
Открыть приложение
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный

Требования

  • Последняя версия Google Mobile Ads SDK
  • Unity 4 или выше
  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте плагин посредничества Google Mobile Ads для AppLovin 5.1.0 или выше ( рекомендуется последняя версия ).
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Unity, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
  • Завершить посредничество . Руководство по началу работы.

Шаг 1: Настройте конфигурации в пользовательском интерфейсе Liftoff Monetize

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

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

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

Андроид

iOS

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

Андроид

iOS

Запишите идентификатор приложения .

Андроид

iOS

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

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

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

Открыть приложение

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

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

Баннер 300x250

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

Интерстициальный

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

Награжден

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

Вознагражденный интерстициальный

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

Родной

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

Запишите идентификатор ссылки и нажмите «Звучит хорошо» .

Открыть приложение

Баннер 300x250

Интерстициальный

Награжден

Вознагражденный интерстициальный

Родной

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

Торги

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

Водопад

Помимо идентификатора приложения и идентификатора ссылки , вам также понадобится ключ API отчётности Liftoff Monetize для настройки идентификатора рекламного блока AdMob. Перейдите на панель управления отчётами Liftoff Monetize и нажмите кнопку «Ключ API отчётности», чтобы просмотреть свой ключ API отчётности .

Обновите файл app-ads.txt

Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt . Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .

Чтобы реализовать app-ads.txt для Liftoff Monetize, скачайте и добавьте записи из файла app-ads.txt Liftoff Monetize в существующий файл app-ads.txt . Подробнее см. в файле app-ads.txt .

Включить тестовый режим

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

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

Андроид

iOS

Шаг 2: Настройте спрос Liftoff Monetize в пользовательском интерфейсе AdMob

Настройте параметры медиации для вашего рекламного блока

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

Добавьте Liftoff в список рекламных партнеров GDPR и государственных органов США

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

Шаг 3: Импортируйте Vungle SDK и адаптер Liftoff Monetize

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI , вы можете установить плагин-посредник Google Mobile Ads Liftoff Monetize для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.liftoffmonetize

OpenUPM

В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .

На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com
  • Область(ы): com.google

Подробности OpenUPM

Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.

Реестры Unity

Выберите пакет посредничества Google Mobile Ads LiftoffMonetize и нажмите «Установить» .

Установить из OpenUPM

Пакет Unity

Загрузите последнюю версию плагина медиации Google Mobile Ads для Liftoff Monetize по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsLiftoffMonetizeMediation.unitypackage из zip-файла.

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

Импорт из Unity

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

Сила Решения

Шаг 4: Реализуйте настройки конфиденциальности в Vungle SDK

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

Начиная с версии плагина Liftoff Monetize для Unity 5.2.2, Liftoff Monetize автоматически считывает согласие GDPR, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая UMP SDK . Подробнее см. в рекомендуемых инструкциях по внедрению 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: Проверьте свою реализацию

Включить тестовые объявления

Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе Liftoff Monetize.

Проверьте тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от Liftoff Monetize, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Liftoff Monetize (Bidding) и Liftoff Monetize (Waterfall ).

Коды ошибок

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

Андроид

Формат Имя класса
Открытие приложения (торги) com.google.ads.mediation.vungle.VungleMediationAdapter
Открытие приложения (Водопад) com.google.ads.mediation.vungle.VungleMediationAdapter
Баннер (Торги) com.google.ads.mediation.vungle.VungleMediationAdapter
Баннер (Водопад) com.vungle.mediation.VungleInterstitialAdapter
Интерстициальный (торги) com.google.ads.mediation.vungle.VungleMediationAdapter
Интерстициальный (Водопад) com.vungle.mediation.VungleInterstitialAdapter
Награжден (торги) com.google.ads.mediation.vungle.VungleMediationAdapter
Награда (Водопад) com.vungle.mediation.VungleAdapter
Вознагражденная межстраничная реклама (торги) com.google.ads.mediation.vungle.VungleMediationAdapter
Награда за межстраничный контент (водопад) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

Формат Имя класса
Открытие приложения (торги) GADMediationAdapterVungle
Открытие приложения (Водопад) GADMediationAdapterVungle
Баннер (Торги) GADMediationAdapterVungle
Баннер (Водопад) GADMAdapterVungleInterstitial
Интерстициальный (торги) GADMediationAdapterVungle
Интерстициальный (Водопад) GADMAdapterVungleInterstitial
Награжден (торги) GADMediationAdapterVungle
Награда (Водопад) GADMAdapterVungleRewardBasedВидеообъявление
Вознагражденная межстраничная реклама (торги) GADMediationAdapterVungle
Награда за межстраничный контент (водопад) GADMediationAdapterVungle

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

Андроид

Код ошибки Причина
101 Неверные параметры сервера (например, идентификатор приложения или идентификатор размещения).
102 Запрошенный размер баннера не соответствует допустимому размеру рекламы Liftoff Monetize.
103 Для запроса рекламы Liftoff Monetize требуется контекст Activity .
104 Vungle SDK не может загружать несколько объявлений для одного и того же идентификатора размещения.
105 Не удалось инициализировать Vungle SDK.
106 Vungle SDK вернул успешный обратный вызов загрузки, но Banners.getBanner() или Vungle.getNativeAd() вернули null.
107 Vungle SDK не готов к воспроизведению рекламы.
108 Vungle SDK вернул недействительный токен торгов.

iOS

Код ошибки Причина
101 Неверные параметры сервера (например, идентификатор приложения или идентификатор размещения).
102 Объявление уже загружено для этой конфигурации сети. Vungle SDK не может загрузить второе объявление для того же идентификатора размещения.
103 Запрошенный размер объявления не соответствует поддерживаемому размеру баннера Liftoff Monetize.
104 Vungle SDK не смог отобразить рекламный баннер.
105 Vungle SDK поддерживает загрузку только одного баннера за раз, независимо от идентификатора места размещения.
106 Vungle SDK отправил ответный вызов, в котором говорилось, что рекламу невозможно воспроизвести.
107 Vungle SDK не готов к воспроизведению рекламы.

Информацию об ошибках, возникающих в Vungle SDK, см. в разделе Коды ошибок: Vungle SDK для iOS и Android .

Журнал изменений плагина Unity Mediation для монетизации Liftoff

Версия 5.3.5

Версия 5.3.4

Версия 5.3.3

  • Исправлена ​​ошибка, из-за которой при установке через OpenUPM плагин не мог корректно импортировать пакеты.

Версия 5.3.2

  • Исправлена ​​ошибка, из-за которой при установке через OpenUPM плагин не мог корректно импортировать пакеты.

Версия 5.3.1

Версия 5.3.0

Версия 5.2.6

Версия 5.2.5

Версия 5.2.4

Версия 5.2.3

Версия 5.2.2

Версия 5.2.1

Версия 5.2.0

Версия 5.1.1

Версия 5.1.0

  • Исправлено исключение NullPointerException , вызывавшее сбой сборки при экспорте в качестве проекта Android.
  • Обновлены API конфиденциальности:
    • Удалены методы UpdateConsentStatus() и UpdateCCPAStatus() .
    • Удалены перечисления VungleConsentStatus и VungleCCPAStatus .
    • Метод SetGDPRStatus(bool) обновлен до SetGDPRStatus(bool, String) .
  • Удалены следующие методы из класса LiftoffMonetizeMediationExtras :
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Поддерживает Android-адаптер Liftoff Monetize версии 7.3.1.0 .
  • Поддерживает iOS-адаптер Liftoff Monetize версии 7.3.1.0 .
  • Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.

Версия 5.0.0

Версия 4.0.0

  • Плагин-посредник Unity был переименован с Vungle в Liftoff Monetize.
  • Содержимое адаптера перемещено в GoogleMobileAds/Mediation/LiftoffMonetize/ .
  • Изменено пространство имен адаптера для использования GoogleMobileAds.Mediation.LiftoffMonetize .
  • В класс LiftoffMonetize добавлены следующие методы:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Поддерживает Android-адаптер Liftoff Monetize версии 6.12.1.1 .
  • Поддерживает iOS-адаптер Liftoff Monetize версии 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

Версия 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.