Эта страница переведена с помощью Cloud Translation API.

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

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

This guide shows you how to use GMA Next-Gen SDK to load and display ads from Liftoff Monetize using AdMob 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 an Android app.

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

Адаптер для посредничества в Liftoff Monetize обладает следующими возможностями:

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

Требования

Android API уровня 24 или выше

[Для размещения ставок]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему размещения ставок, используйте адаптер Liftoff Monetize версии 7.3.0.0 или выше ( рекомендуется последняя версия ).

Новейшая версия GMA Next-Gen SDK .
Пройдите руководство по началу процесса медиации.

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

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

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

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

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

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

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

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

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

Приложение открыто

Select Interstitial and enter a Placement Name . Then, select Yes for Skippable 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 Banner , 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 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 Interstitial , 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 Rewarded , 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 Rewarded . Enter a Placement Name , enable Skippable 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 AdMob 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, set up an app-ads.txt file for your app .

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

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

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

Вам необходимо добавить Liftoff Monetize в конфигурацию медиации для вашего рекламного блока.

First, sign in to your AdMob account . Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add Liftoff Monetize as an ad source .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

Присвойте вашей группе посредничества название и выберите регионы для таргетирования. Затем установите статус группы посредничества на «Включено» и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте Liftoff Monetize в качестве источника рекламы.

Торги

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите «Монетизировать Liftoff» .

Нажмите «Как подписать партнерское соглашение и заключить партнерское соглашение с Liftoff Monetize».

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

Если у вас уже есть сопоставление для Liftoff Monetize, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .

Далее введите идентификатор приложения и идентификатор ссылки на место прохождения практики, полученные в предыдущем разделе. Затем нажмите «Готово» .

Водопад

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Select Liftoff Monetize and enable the Optimize switch. Enter the Reporting API Key obtained in the previous section to set up ad source optimization for Liftoff Monetize. Then enter an eCPM value for Liftoff Monetize and click Continue .

Note : Ad source optimization takes a few days to gather enough data to accurately calculate eCPM for a mediation network. In the meantime, the ad source optimization status is PENDING , so you must manually set an eCPM value for the network. Once the eCPM can be calculated, the ad source automatically starts updating the eCPM on your behalf.

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

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

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

Интеграция с Android Studio (рекомендуется)

В файл build.gradle.kts на уровне приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии SDK и адаптера Vungle:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.22.0-beta04")
    implementation("com.google.ads.mediation:vungle:7.6.2.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

Ручная интеграция

Загрузите последнюю версию Vungle Android SDK , распакуйте файлы .aar и JAR в папку libs и добавьте их в свой проект.
Перейдите к артефактам адаптера Liftoff Monetize в репозитории Maven Google. Выберите последнюю версию, загрузите файл .aar адаптера Vungle и добавьте его в свой проект.

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

Согласие ЕС и GDPR

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

Starting in Vungle SDK version 7.4.1, 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 .

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

Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.

Liftoff Monetize includes an API that lets you pass consent to the Vungle SDK. The following sample code shows how to pass this 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 GMA Next-Gen SDK .

Java

VunglePrivacySettings.setCCPAStatus(true);LiftoffMonetizeMediationSnippets.java

Котлин

VunglePrivacySettings.setCCPAStatus(true)LiftoffMonetizeMediationSnippets.kt

Более подробную информацию о реализации CCPA и значениях, которые можно указать в методе, см. в разделе «Реализация CCPA».

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

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

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

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

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

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

To verify that you are receiving test ads from Liftoff Monetize, enable single ad source testing in ad inspector using the Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) ad source(s).

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

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

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

userId: Строка, представляющая идентификатор пользователя, получающего вознаграждение от Liftoff Monetize.
adOrientation: Целое число, определяющее ориентацию отображения для полноэкранных рекламных объявлений.

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

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        .build();LiftoffMonetizeMediationSnippets.java

Котлин

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    .build()LiftoffMonetizeMediationSnippets.kt

Отображение нативной рекламы

Адаптер Liftoff Monetize возвращает нативную рекламу в виде объектов NativeAd . Он заполняет следующие поля описания нативной рекламы для объекта NativeAd .

Поле	Ресурсы всегда включены в адаптер Liftoff Monetize.
Заголовок
Изображение	1
Просмотр медиафайлов
Тело
значок приложения
Призыв к действию
Звездный рейтинг
Магазин
Цена

^1. Адаптер Liftoff Monetize не предоставляет прямого доступа к основному графическому ресурсу для своих нативных объявлений. Вместо этого адаптер заполняет MediaView видео или изображением.

коды ошибок

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

Формат	Название класса
Приложение открыто (торги)	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
Нативный (Торги)	com.google.ads.mediation.vungle.VungleMediationAdapter
Родной (Водопад)	com.google.ads.mediation.vungle.VungleMediationAdapter

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

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

Для получения информации об ошибках, возникающих в Vungle SDK, обратитесь к разделу «Коды ошибок: Vungle SDK для iOS и Android» .