В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из DT Exchange с помощью медиации , а также каскадной интеграции. В нем рассказывается, как добавить DT Exchange в конфигурацию посредничества рекламного блока, а также как интегрировать SDK и адаптер DT Exchange в приложение Flutter.
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник Flutter для DT Exchange имеет следующие возможности:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничный | |
| Награжден | |
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Flutter, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе DT Exchange.
Добавить новое приложение и место размещения рекламы
Зарегистрируйтесь или войдите в консоль DT Exchange.
Нажмите кнопку «Добавить приложение» , чтобы добавить свое приложение.
Выберите платформу , заполните оставшуюся часть формы и нажмите «Добавить места размещения» .
Андроид
iOS
Введите имя нового места размещения в поле « Назовите свое место размещения» и выберите нужный тип места размещения из раскрывающегося списка. Наконец, нажмите «Сохранить размещение» .
Идентификатор приложения и идентификатор места размещения
Откройте левую панель навигации, наведя на нее указатель мыши. Затем нажмите «Приложения» в меню слева.
На странице «Управление приложениями» запишите идентификатор приложения рядом с вашим приложением.
Выберите свое приложение, перейдите на вкладку «Места размещения» и нажмите значок копирования рядом с названием места размещения . Обратите внимание на идентификатор места размещения .
Идентификатор издателя, ключ потребителя и секрет потребителя
Нажмите на свое имя пользователя в меню слева и выберите «Профиль пользователя» .
Запишите идентификатор издателя , ключ потребителя и секрет потребителя , поскольку они понадобятся на следующем шаге.
Шаг 2. Настройте спрос DT Exchange в интерфейсе AdMob.
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте DT Exchange в список рекламных партнеров GDPR и государственных нормативов США
Следуйте инструкциям в настройках европейских правил и настройках правил штата США , чтобы добавить DT Exchange (монетизация по оптоволокну) в список рекламных партнеров, регулирующих правила европейских и американских штатов, в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте SDK и адаптер DT Exchange.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями DT Exchange SDK и адаптера в файл pubspec.yaml вашего пакета:
dependencies:
gma_mediation_dtexchange: ^1.1.0
Ручная интеграция
Загрузите последнюю версию плагина-посредника Google Mobile Ads для DT Exchange , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
Шаг 4. Реализуйте настройки конфиденциальности в DT Exchange SDK
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для DT Exchange не поддерживает передачу информации о согласии в DT Exchange SDK.
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США потребовать предоставить пользователям право отказаться от «продажи» их «личной информации» (согласно определению этих терминов в законе), причем отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на домашней странице «продающей» стороны. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для DT Exchange не поддерживает передачу информации о согласии в DT Exchange SDK.
Шаг 5. Добавьте необходимый код.
Андроид
Для интеграции DT Exchange не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации DT Exchange , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в AdMob.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от DT Exchange, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений DT Exchange (Waterfall ).
Коды ошибок
Если адаптеру не удается получить объявление от DT Exchange, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo в следующем классе:
Андроид
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Вот коды и сопутствующие сообщения, выдаваемые адаптером DT Exchange, когда объявление не загружается:
Андроид
| Код ошибки | Причина |
|---|---|
| 101 | Параметры сервера DT Exchange, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны. |
| 103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange. |
| 105 | DT Exchange SDK загрузил объявление, но вернул неожиданный контроллер. |
| 106 | Объявление не готово к показу. |
| 200-399 | DT Exchange SDK возвратил ошибку. См. код для более подробной информации. |
iOS
| Код ошибки | Причина |
|---|---|
| 0-10 | DT Exchange SDK возвратил ошибку. Более подробную информацию смотрите в документации . |
| 101 | Параметры сервера DT Exchange, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны. |
| 102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange. |
| 103 | Не удалось показать объявление, поскольку объект объявления уже использовался. |
| 104 | Не удалось показать объявления DT Exchange, поскольку объявление не готово. |
| 105 | DT Exchange SDK возвратил ошибку инициализации. |
Журнал изменений адаптера DT Exchange Flutter Mediation
Следующая версия
- Плагин iOS теперь представляет собой статический фреймворк.
- Проверенная совместимость с адаптером DT Exchange Android версии 8.3.5.0.
- Подтверждена совместимость с адаптером DT Exchange iOS версии 8.3.4.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.3.1.
1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером DT Exchange Android версии 8.2.7.0.
- Подтверждена совместимость с адаптером DT Exchange iOS версии 8.2.8.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.