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

Выберите платформу: Android (бета-версия)Новый Android iOS Unity Flutter

This guide shows you how to use Google Mobile Ads Unity Plugin to load and display ads from Liftoff Monetize using mediation , covering both bidding and waterfall integrations. It covers how to add Liftoff Monetize to an ad unit's mediation configuration, and how to integrate the Vungle SDK and adapter into a Unity app.

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

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

Требования

  • Latest Google Mobile Ads Unity Plugin
  • Unity 4 или выше
  • [Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы объявлений в процесс торгов, используйте плагин медиации Google Mobile Ads для AppLovin версии 5.1.0 или выше ( рекомендуется последняя версия ).
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Целевая версия iOS для развертывания — 12.0 или выше.
  • A working Unity project configured with Google Mobile Ads Unity Plugin . See Get Started for details.
  • Заполните руководство по началу медиации.

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

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

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

Баннер 300x250

Select MREC , enter a Placement Name and fill out the rest of the form. [Bidding only] Under Monetization , toggle the In-App Bidding switch to Enabled . Click the Continue button at the bottom of the page to create the placement.

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

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

Награжден

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

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

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

Родной

Select Native , enter a Placement Name and fill out the rest of the form. [Bidding only] Under Monetization , toggle the In-App Bidding switch to Enabled . Click the Continue button at the bottom of the page to create the placement.

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

Баннер 300x250

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

Награжден

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

Родной

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

Торги

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

Водопад

In addition to the App ID and the Reference ID , you'll also need your Liftoff Monetize Reporting API Key to set up your Ad Manager ad unit ID. Navigate to the Liftoff Monetize Reports dashboard and click the Reporting API Key button to view your Reporting API Key .

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

Authorized Sellers for Apps app-ads.txt is an IAB Tech Lab initiative that helps ensure your app ad inventory is only sold through channels you've identified as authorized. To prevent a significant loss in ad revenue, you'll need to implement an app-ads.txt file. If you haven't done so already, create an app-ads.txt file for Ad Manager .

To implement app-ads.txt for Liftoff Monetize, download and append Liftoff Monetize's app-ads.txt entries to your existing app-ads.txt file. For more information, see app-ads.txt .

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

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

Select your app for which you would like to enable test ads under the Placement Reference ID section of your app. Test ads can be enabled by selecting Test Mode to Show test ads only under the Status section.

Android

iOS

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

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

Android

For instructions, see step 2 in the guide for Android .

iOS

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

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

Follow the steps in European regulations settings and US state regulations settings to add Liftoff to the European and US state regulations ad partners list in the Ad Manager UI.

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

OpenUPM-CLI

If you have OpenUPM-CLI installed, you can install the Google Mobile Ads Liftoff Monetize Mediation Plugin for Unity to your project by running the following command from your project's root directory:

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

OpenUPM

In your Unity project editor, select Edit > Project Settings > Package Manager to open the Unity Package Manager Settings .

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

  • Имя: OpenUPM
  • URL: https://package.openupm.com
  • Scope(s): com.google

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

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

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

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

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

Пакет Unity

Download the latest version of Google Mobile Ads mediation plugin for Liftoff Monetize from the download link in the Changelog and extract the GoogleMobileAdsLiftoffMonetizeMediation.unitypackage from the zip file.

In your Unity project editor, select Assets > Import Package > Custom Package and find the GoogleMobileAdsLiftoffMonetizeMediation.unitypackage file you downloaded. Make sure that all the files are selected and click Import .

Импорт из Unity

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

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

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

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

Starting in Liftoff Monetize Unity plugin version 5.2.2, Liftoff Monetize automatically reads GDPR consent set by consent management platforms that support Google's Additional Consent specification , including the UMP SDK . For more information, see GDPR Recommended Implementation Instructions for Android and 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.

The Google Mobile Ads mediation plugin for Liftoff Monetize includes methods to pass consent information to the Vungle SDK. The following sample code shows how to pass consent information to the Vungle SDK. If you choose to call this method, it is recommended that you do so prior to requesting ads through Google Mobile Ads Unity Plugin .

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

LiftoffMonetize.SetCCPAStatus(true);

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

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

Android

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

iOS

Интеграция SKAdNetwork

Follow Liftoff Monetize's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

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

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

Make sure you register your test device for Ad Manager and enable test mode in Liftoff Monetize UI.

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

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

коды ошибок

If the adapter fails to receive an ad from Liftoff Monetize, publishers can check the underlying error from the ad response using ResponseInfo under the following classes:

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 requires an Activity context to request ads.
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.5.2 (в разработке)

Версия 5.5.1

#### Version 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 для обеспечения конфиденциальности:
    • Removed the UpdateConsentStatus() and UpdateCCPAStatus() methods.
    • Удалены перечисления VungleConsentStatus и VungleCCPAStatus .
    • Updated the SetGDPRStatus(bool) method to SetGDPRStatus(bool, String) .
  • Removed the following methods from the LiftoffMonetizeMediationExtras class:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Supports Liftoff Monetize Android adapter version 7.3.1.0 .
  • Supports Liftoff Monetize iOS adapter version 7.3.1.0 .
  • Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 9.1.0.

Версия 5.0.0

Версия 4.0.0

  • Переименованный плагин для медиации в Unity с Vungle на Liftoff Monetize.
  • Moved adapter content to GoogleMobileAds/Mediation/LiftoffMonetize/ .
  • Переработано пространство имен адаптера для использования GoogleMobileAds.Mediation.LiftoffMonetize .
  • В класс LiftoffMonetize добавлены следующие методы:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Поддерживает адаптер Liftoff Monetize для Android версии 6.12.1.1 .
  • Supports Liftoff Monetize iOS adapter version 7.0.1.0 .
  • Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 8.4.1.

Версия 3.9.2

  • Обновлен класс Vungle :
    • Добавлен метод UpdateCCPAStatus(VungleCCPAStatus) .
    • Removed the GetCurrentConsentStatus() method.
    • Removed the GetCurrentConsentMessageVersion() method.
  • Поддерживает адаптер Vungle для Android версии 6.12.1.0 .
  • Supports Vungle iOS adapter version 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

  • Перепакован файл vungle-extras-library.jar в vungle-unity-android-library.aar , используется сборка в формате .aar для поддержки Unity 2020.
    • When upgrading to this version, please remove vungle-extras-library.jar from your project.
  • Supports Vungle Android adapter version 6.5.3.0 .
  • Supports Vungle iOS adapter version 6.5.3.0 .

Версия 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.
  • Updated Vungle.UpdateConsentStatus() method to make the consentMessageVersion parameter optional. The value of consentMessageVersion is now ignored for iOS.
  • Deprecated Vungle.GetCurrentConsentMessageVersion() for iOS.

Версия 3.1.0

  • Поддерживает адаптер Android версии 6.3.17.0.
  • Поддерживает адаптер iOS версии 6.3.0.0.
  • Updated Vungle.UpdateConsentStatus() method to take an additional String parameter for the publiser-provided consent message version.
  • Added Vungle.GetCurrentConsentMessageVersion() method to get the publisher-provided consent message version.

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