Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

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

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK.
Завершите руководство по началу работы с посредничеством.

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

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

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

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

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

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

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

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

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

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

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

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

Выберите 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 и выберите Приложения .

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

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

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

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

Сначала войдите в свой аккаунт AdMob . Затем перейдите на вкладку «Медиация» . Если у вас есть группа медиации, которую вы хотите изменить, нажмите на её название, чтобы отредактировать её, и перейдите к разделу «Добавить Liftoff Monetize в качестве источника рекламы» .

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

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

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

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

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

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

Торги

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

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

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

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

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

Водопад

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

Выберите Liftoff Monetize и включите переключатель «Оптимизация» . Введите ключ API отчётности, полученный в предыдущем разделе, чтобы настроить оптимизацию источника объявлений для Liftoff Monetize. Затем введите значение eCPM для Liftoff Monetize и нажмите «Продолжить» .

Примечание : Оптимизация источника объявлений может занять несколько дней, чтобы собрать достаточно данных для точного расчёта eCPM для медиационной сети. В настоящее время оптимизация источника объявлений имеет статус PENDING , поэтому вам необходимо вручную задать значение eCPM для сети. После того, как eCPM будет рассчитан, источник объявлений автоматически начнёт обновлять eCPM от вашего имени.

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.7.0")
    implementation("com.google.ads.mediation:vungle:7.6.0.0")
}

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

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

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

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

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

Начиная с версии Vungle SDK 7.4.1, Liftoff Monetize автоматически считывает согласие GDPR, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая UMP SDK . Подробнее см. в разделе «Рекомендуемые инструкции по внедрению GDPR» .

Законы США о конфиденциальности

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

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

Ява

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

Котлин

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

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

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

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

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

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

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

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

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

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

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

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

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

Вот пример кода, как создать запрос объявления, который задает эти параметры:

Ява

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();

Котлин

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

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

Рендеринг нативной рекламы

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

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

¹ Адаптер Liftoff Monetize не предоставляет прямого доступа к основному изображению для нативной рекламы. Вместо этого адаптер заполняет MediaView видео или изображением.

Коды ошибок

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

Формат	Имя класса
Открытие приложения (торги)	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	Vungle SDK не может загружать несколько объявлений для одного и того же идентификатора размещения.
105	com.google.ads.mediation.vungle	Не удалось инициализировать Vungle SDK.
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 .