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

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

This guide shows you how to use Google Mobile Ads SDK 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 Flutter app.

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

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

Требования

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

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

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

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

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

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

Баннер 300x250

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

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

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

Награжден

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

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

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

Родной

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

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

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

Баннер 300x250

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

Награжден

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

Родной

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

Торги

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

Водопад

Помимо идентификатора приложения (App ID) и идентификатора ссылки (Reference ID ), вам также понадобится ключ 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 и выберите раздел «Приложения» .

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

Интеграция через pub.dev

Добавьте следующую зависимость с последними версиями SDK и адаптера Liftoff Monetize в файл pubspec.yaml вашего пакета:

dependencies:
  gma_mediation_liftoffmonetize: ^1.4.2

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

Download the latest version of Google Mobile Ads mediation plugin for Liftoff Monetize , extract the downloaded file, and add the extracted plugin folder (and its contents) to your Flutter project. Then, reference the plugin in your pubspec.yaml file by adding the following dependency:

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

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

Starting in Liftoff Monetize Flutter plugin version 1.1.0, 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 .

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

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

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

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

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

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

Android

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

iOS

Интеграция SKAdNetwork

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

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

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

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

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

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

коды ошибок

Если адаптер не получает объявление от 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 Flutter Mediation

Версия 1.4.2 (в разработке)

  • Обновлена ​​минимальная версия Flutter до 3.35.1.
  • Обновлено для поддержки плагина Google Mobile Ads Flutter версии 7.0.0.

Версия 1.4.1

Версия 1.4.0

Версия 1.3.0

Версия 1.2.3

Версия 1.2.2

Версия 1.2.1

Версия 1.2.0

Версия 1.1.1

Версия 1.1.0

Версия 1.0.0