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

Выберите платформу: Android iOS Unity Flutter Android (Legacy)

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

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

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

Предварительные требования

Прежде чем продолжить, проверьте следующее:

  • Последняя версия Google Mobile Ads Unity Plugin .
  • Версия редактора Unity — 4 или более поздняя.
  • [Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы объявлений в процесс торгов, используйте плагин медиации Google Mobile Ads для Liftoff Monetize версии 5.1.0 или более поздней ( рекомендуется последняя версия ).
  • Для развертывания на Android
    • Android API уровня 23 или более поздней версии.
  • Для развертывания на iOS
    • Целевая версия iOS — 13.0 или более поздняя.
  • Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Unity Plugin .
  • Организуйте посредничество .

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

Зарегистрируйтесь или войдите в свой аккаунт Liftoff Monetize.

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

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

Баннер 300x250

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

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

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

Награжден

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

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

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

Родной

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

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

Баннер 300x250

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

Награжден

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

Родной

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

Торги

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

Водопад

Помимо идентификатора приложения (App ID) и идентификатора ссылки (Reference ID ), вам также понадобится ключ API для отчетов Liftoff Monetize, чтобы настроить идентификатор рекламного блока в Ad Manager. Перейдите на панель управления отчетами Liftoff Monetize и нажмите кнопку «Ключ API для отчетов», чтобы просмотреть свой ключ API для отчетов .

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

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

Для интеграции файла app-ads.txt с Liftoff Monetize загрузите и добавьте записи из файла app-ads.txt Liftoff Monetize в существующий файл app-ads.txt . Для получения дополнительной информации см. app-ads.txt .

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

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

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

Android

iOS

Шаг 2: Настройте запрос на монетизацию Liftoff в пользовательском интерфейсе Ad Manager.

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

Android

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

iOS

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

Добавьте Liftoff в список рекламных партнеров, соблюдающих GDPR и правила штатов США.

Чтобы добавить Liftoff в список рекламных партнеров, соответствующих европейским и американским государственным нормативным актам, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных актов.

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

OpenUPM-CLI

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

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

OpenUPM

В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .

На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM в качестве реестра с ограниченной областью действия, указав следующие данные:

  • Имя: OpenUPM
  • URL: https://package.openupm.com
  • Область применения: com.google

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

Затем перейдите в меню Window > Package Manager , чтобы открыть диспетчер пакетов Unity , и выберите My Registries из выпадающего меню.

Реестры единства

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

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

Пакет Unity

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

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

Импорт из Unity

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

Силовое разрешение

Шаг 4: Внедрите настройки конфиденциальности в SDK Liftoff Monetize.

To comply with the Google EU User Consent Policy , you must make certain disclosures to your users in the European Economic Area (EEA), the UK, and Switzerland, and obtain their consent for the use of cookies or other local storage where legally required, and for the collection, sharing, and use of personal data for ads personalization. This policy reflects the requirements of the EU ePrivacy Directive and the General Data Protection Regulation (GDPR). You are responsible for verifying that consent is propagated to each ad source in your mediation chain.

Начиная с версии плагина Liftoff Monetize Unity 5.2.2, Liftoff Monetize автоматически считывает согласия GDPR, установленные платформами управления согласиями, поддерживающими спецификацию Google Additional Consent , включая UMP SDK . Для получения дополнительной информации см. Рекомендации по внедрению GDPR для Android и iOS .

Законы штатов США о защите частной жизни

US states privacy laws require giving users the right to opt out of the "sale" of their "personal information" (as the law defines those terms), with the opt-out offered through a prominent "Do Not Sell My Personal Information" link on the "selling" party's homepage. The US states privacy laws compliance guide offers the ability to enable restricted data processing for Google ad serving, but Google is unable to apply this setting to each ad network in your mediation chain. Therefore, you must identify each ad network in your mediation chain that may participate in the sale of personal information and follow guidance from each of those networks to ensure compliance.

Плагин медиации Google Mobile Ads для Liftoff Monetize включает методы для передачи информации о согласии в SDK Liftoff Monetize. Приведенный ниже пример кода демонстрирует передачу информации о согласии в SDK Liftoff Monetize. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads Unity Plugin .

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

Для получения более подробной информации и значений, которые можно указать в методе, см. рекомендуемые CCPA инструкции по реализации для Android и iOS .

Шаг 5: Добавьте необходимый код

Android

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

iOS

Интеграция SKAdNetwork

Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации Liftoff Monetize .

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

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

Убедитесь, что ваше тестовое устройство зарегистрировано в Ad Manager и включен тестовый режим в пользовательском интерфейсе Liftoff Monetize.

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

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

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

Параметры, специфичные для сети

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

SetBackButtonImmediatelyEnabled(bool)
Логическое значение для включения или выключения кнопки «Назад» при немедленном открытии рекламы в приложении. Установите значение true , чтобы включить кнопку «Назад», в противном случае false . По умолчанию — false . Дополнительную информацию об интеграции рекламы в приложения см. в документации Liftoff Monetize.

В следующем примере кода создается запрос на показ рекламы, который устанавливает следующие параметры:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

var adRequest = new AdRequest();
var liftoffExtras = new LiftoffMonetizeMediationExtras();
liftoffExtras.SetBackButtonImmediatelyEnabled(true);
adRequest.MediationExtras.Add(liftoffExtras);

коды ошибок

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

Android

Формат Название класса
Приложение открыто (торги) 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, когда реклама не загружается:

Android

Код ошибки Причина
101 Неверные параметры сервера (например, идентификатор приложения или идентификатор размещения).
102 Запрошенный размер баннера не соответствует допустимому размеру объявления Liftoff Monetize.
103 Для запроса рекламы Liftoff Monetize требуется контекст Activity .
104 SDK Vungle не может загружать несколько объявлений для одного и того же идентификатора размещения.
105 Не удалось инициализировать SDK Vungle.
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» .

Список изменений плагина Liftoff Monetize Unity Mediation

Версия 5.7.8

Версия 5.7.7

Версия 5.7.6

Версия 5.7.5

Версия 5.7.4

Версия 5.7.3

Версия 5.7.2

  • Добавлена SetBackButtonImmediatelyEnabled(bool) в LiftoffMonetizeMediationExtras . Установите значение true , чтобы кнопка «Назад» включалась немедленно при открытии рекламы в приложении. Эта функция доступна только для Android.
  • Поддерживает адаптер Liftoff Monetize для Android версии 7.7.2.0 .
  • Поддерживает адаптер Liftoff Monetize для iOS версии 7.7.1.0 .
  • Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.

Версия 5.7.1

Версия 5.7.0

Версия 5.6.0

Версия 5.5.3

Версия 5.5.2

Версия 5.5.1

Версия 5.5.0

Версия 5.4.1

Версия 5.4.0

Версия 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)
  • Поддерживает адаптер Liftoff Monetize для Android версии 7.3.1.0 .
  • Поддерживает адаптер Liftoff Monetize для iOS версии 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)
  • Поддерживает адаптер Liftoff Monetize для Android версии 6.12.1.1 .
  • Поддерживает адаптер Liftoff Monetize для iOS версии 7.0.1.0 .
  • Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 8.4.1.

Версия 3.9.2

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

  • Плагин обновлен для поддержки нового 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() устанавливает статус согласия, который будет записан в SDK Vungle.
    • Метод 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.