В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Liftoff Monetize с помощью медиации , включая интеграцию как назначения ставок, так и водопада. В нем рассказывается, как добавить Liftoff Monetize в конфигурацию медиации рекламного блока, а также как интегрировать Vungle SDK и адаптер вFlutter приложение.
Поддерживаемые интеграции и форматы объявлений
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Приложение открыто | 1 , 2 |
Баннер | 1 |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | 1 |
Родной | 1 , 2 |
1 Интеграция ставок для этого формата находится на стадии открытого бета-тестирования.
2 Интеграция Waterfall для этого формата находится в стадии открытого бета-тестирования.
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Liftoff Monetize.
Шаг 2. Настройте спрос на монетизацию Liftoff в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавлять Liftoff в соответствии с GDPR и списком рекламных партнеров США.
Шаг 3. Импортируйте Vungle SDK и адаптер Liftoff Monetize.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиLiftoff Monetize SDK и адаптер в файле 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. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAdMob и включили тестовый режим в пользовательском интерфейсе Liftoff Monetize .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отLiftoff Monetize, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) .
Коды ошибок
Если адаптеру не удается получить рекламу от Liftoff Monetize, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
Формат | Имя класса |
---|---|
Открытие приложения (назначение ставок) | 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
Формат | Имя класса |
---|---|
Открытие приложения (назначение ставок) | GADMediationАдаптерVungle |
Приложение открыто (Водопад) | GADMediationАдаптерVungle |
Баннер (Торги) | GADMediationАдаптерVungle |
Баннер (Водопад) | GADMAdapterVungleМежстраничное объявление |
Межстраничное объявление (назначение ставок) | GADMediationАдаптерVungle |
Межстраничное объявление (Водопад) | GADMAdapterVungleМежстраничное объявление |
Вознаграждено (торги) | GADMediationАдаптерVungle |
Награжден (Водопад) | GADMAdapterVungleRewardBasedВидеообъявление |
Межстраничное объявление с вознаграждением (назначение ставок) | GADMediationАдаптерVungle |
Межстраничное объявление с вознаграждением (Водопад) | GADMediationАдаптерVungle |
Вот коды и сопутствующие сообщения, выдаваемые адаптером Liftoff Monetize, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
101 | Неверные параметры сервера (например, идентификатор приложения или идентификатор места размещения). |
102 | Запрошенный размер баннера не соответствует допустимому размеру объявления Liftoff Monetize. |
103 | Liftoff Monetize требует контекст Activity для запроса рекламы. |
104 | Vungle SDK не может загружать несколько объявлений для одного и того же идентификатора места размещения. |
105 | Не удалось инициализировать Vungle SDK. |
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 .
Журнал изменений адаптера Flutter Mediation Liftoff Monetize
Версия 1.1.0
- Проверенная совместимость с адаптером Android Liftoff Monetize версии 7.4.0.1.
- Проверенная совместимость с iOS-адаптером LiftoffMonetize версии 7.4.0.1.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
Версия 1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером Android Liftoff Monetize версии 7.3.1.0.
- Проверенная совместимость с адаптером LiftoffMonetize iOS версии 7.3.2.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.