В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Liftoff Monetize с помощью медиации , включая интеграцию ставок и водопада. В нем рассказывается, как добавить Liftoff Monetize в конфигурацию медиации рекламного блока, а также как интегрировать Vungle SDK и адаптер в приложениеFlutter .
Поддерживаемые интеграции и форматы объявлений
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Приложение открыто | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | 2 |
1 Интеграция назначения ставок находится на стадии открытого бета-тестирования.
2. Межстраничное объявление с вознаграждением требует помощи в настройке. Свяжитесь со своим менеджером по работе с клиентами по адресу Liftoff Monetize или monetize@liftoff.io
.
Требования
- Последняя версия SDK Google Mobile Ads
- Flutter 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Flutter , настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Liftoff Monetize.
Зарегистрируйтесь или войдите в свою учетную запись Liftoff Monetize.
Добавьте свое приложение на панель управления Liftoff Monetize, нажав кнопку «Добавить приложение» .
Заполните форму, указав все необходимые данные.
Андроид
iOS
После создания приложения выберите его на панели управления Liftoff Monetize Applications .
Андроид
iOS
Обратите внимание на идентификатор приложения .
Андроид
iOS
Добавить новые места размещения
Чтобы создать новое место размещения, которое будет использоваться с медиацией Ad Manager, перейдите на панель мониторинга Liftoff Monetize Placements , нажмите кнопку «Добавить место размещения» и выберите свое приложение из раскрывающегося списка.
Подробности о добавлении новых мест размещения приведены ниже:
Баннер
Выберите «Баннер» , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Баннер 300х250
Выберите MREC , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Межстраничный
Выберите «Межстраничное объявление» , введите «Название места размещения» и заполните оставшуюся часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Награжден
Выберите «С вознаграждением» , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Межстраничное объявление с вознаграждением
Выберите «Награда» . Введите название места размещения , включите возможность пропуска и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Родной
Выберите «Нативный» , введите название места размещения и заполните остальную часть формы. [Только назначение ставок] В разделе «Монетизация » переведите переключатель «Назначение ставок в приложении» в положение «Включено» . Нажмите кнопку «Продолжить» внизу страницы, чтобы создать место размещения.
Запишите идентификационный номер и нажмите « Звучит хорошо» .
Баннер
Баннер 300х250
Межстраничный
Награжден
Межстраничное объявление с вознаграждением
Родной
Найдите свой ключ API отчетности
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Помимо идентификатора приложения и эталонного идентификатора , вам также понадобится ключ API отчетности Liftoff Monetize Reporting, чтобы настроить идентификатор рекламного блокаAd Manager . Перейдите на панель мониторинга отчетов Liftoff Monetize и нажмите кнопку «Ключ API отчетов» , чтобы просмотреть свой ключ API отчетов .
Включите тестовый режим
Чтобы включить тестовые объявления, перейдите на панель управления Liftoff Monetize и выберите «Приложения» .
Выберите свое приложение, для которого вы хотите включить тестовые объявления, в разделе «Идентификатор места размещения» вашего приложения. Тестовые объявления можно включить, выбрав «Тестовый режим» , чтобы показывать тестовые объявления только в разделе «Статус» .
Андроид
iOS
Шаг 2. Настройте спрос на монетизацию Liftoff в пользовательском интерфейсе Ad Manager .
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавить Liftoff в список рекламных партнеров GDPR и государственных нормативов США.
Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить Liftoff в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .
Шаг 3. Импортируйте Vungle SDK и адаптер Liftoff Monetize.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями SDKLiftoff Monetize и адаптера в файл pubspec.yaml
вашего пакета:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина-посредника Google Mobile Ads для Liftoff Monetize , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml
, добавив следующую зависимость:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
Шаг 4. Реализуйте настройки конфиденциальности в SDK Liftoff Monetize.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны обеспечить предоставление определенной информации и получение от пользователей в Европейской экономической зоне (ЕЭЗ) определенных разрешений на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для Liftoff Monetize включает метод GmaMediationLiftoffmonetize.setGDPRStatus()
. В следующем примере кода показано, как передать информацию о согласии в Vungle SDK. Если вы решите вызвать этот метод, рекомендуется вызвать его до запроса рекламы через Google Mobile Ads SDK.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
Дополнительные сведения и значения, которые можно указать в методе, см. в инструкциях по реализации, рекомендованных GDPR для Android и iOS .
Законы штата США о конфиденциальности
Законы о конфиденциальности в штатах США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе) с возможностью отказа предлагается через заметную ссылку «Не продавать мою личную информацию» на домашней странице «продающей» стороны. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для Liftoff Monetize включает метод GmaMediationLiftoffmonetize.setCCPAStatus()
. В следующем примере кода показано, как передать информацию о согласии в Vungle SDK. Если вы решите вызвать этот метод, рекомендуется вызвать его до запроса рекламы через Google Mobile Ads SDK.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
Дополнительные сведения и значения, которые можно указать в методе, см. в инструкциях по реализации, рекомендованных CCPA для Android и iOS .
Шаг 5. Добавьте необходимый код
Андроид
Никакого дополнительного кода не требуется. Интеграция Liftoff Monetize.
iOS
Интеграция со SKAdNetwork
Следуйте документации Liftoff Monetize, чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager и включили тестовый режим в пользовательском интерфейсе Liftoff Monetize .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отLiftoff Monetize, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от Liftoff Monetize, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
iOS
Формат | Имя класса |
---|---|
Баннер | GADMAdapterVungleМежстраничное объявление |
Межстраничный | GADMAdapterVungleМежстраничное объявление |
Награжден | GADMAdapterVungleRewardBasedВидеообъявление |
Вот коды и сопутствующие сообщения, выдаваемые адаптером Liftoff Monetize, когда объявление не загружается:
iOS
Код ошибки | Причина |
---|---|
1-100 | Vungle SDK вернул ошибку. Более подробную информацию смотрите в коде . |
101 | Параметры сервера Liftoff Monetize, настроенные в пользовательском интерфейсе Ad Manager отсутствуют/недействительны. |
102 | Объявление для этой конфигурации сети уже загружено. Vungle SDK не может загрузить второе объявление для того же идентификатора места размещения. |
103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Liftoff Monetize. |
104 | Vungle SDK не смог отобразить рекламный баннер. |
105 | Vungle SDK поддерживает загрузку только одного рекламного баннера за раз, независимо от идентификатора места размещения. |
106 | Vungle SDK отправил обратный вызов, сообщив, что рекламу невозможно воспроизвести. |
Журнал изменений адаптера Flutter Mediation Liftoff Monetize
Версия 1.0.0
- Изначальный выпуск.
- Проверенная совместимость с Android-адаптером Liftoff Monetize версии 7.3.1.0.
- Проверенная совместимость с iOS-адаптером LiftoffMonetize версии 7.3.2.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.