В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из DT Exchange с помощью медиации , а также каскадной интеграции. В нем рассказывается, как добавить DT Exchange в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер DT Exchange в Flutter приложение.
Поддерживаемые интеграции и форматы объявлений
Ad Manager Адаптер-посредник для 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 в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства поАндроид .
iOS
Инструкции см. в шаге 2 руководства поiOS .
Добавлять Fyber в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить DT Exchange (монетизация Fyber) в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте SDK и адаптер DT Exchange.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиDT Exchange SDK и адаптер в файле pubspec.yaml вашего пакета:
dependencies:
gma_mediation_dtexchange: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляDT Exchange , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиDT Exchange SDK и адаптер в файле pubspec.yaml вашего пакета:
dependencies:
gma_mediation_dtexchange: ^1.0.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, настроенные в Ad Manager Пользовательский интерфейс отсутствует/недействителен. |
| 103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange. |
| 105 | DT Exchange SDK загрузил объявление, но вернул неожиданный контроллер. |
| 106 | Объявление не готово к показу. |
| 200-399 | DT Exchange SDK возвратил ошибку. См. код для более подробной информации. |
iOS
| Код ошибки | Причина |
|---|---|
| 0-10 | DT Exchange SDK возвратил ошибку. Более подробную информацию смотрите в документации . |
| 101 | Параметры сервера DT Exchange, настроенные в Ad Manager Пользовательский интерфейс отсутствует/недействителен. |
| 102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange. |
| 103 | Не удалось показать объявление, поскольку объект объявления уже использовался. |
| 104 | Не удалось показать объявления DT Exchange, поскольку объявление не готово. |
| 105 | DT Exchange SDK возвратил ошибку инициализации. |
Журнал изменений адаптера DT Exchange Flutter Mediation
Следующая версия
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.
1.1.0
- Подтверждена совместимость с адаптером DT Exchange Android версии 8.3.0.0.
- Подтверждена совместимость с адаптером DT Exchange iOS версии 8.3.1.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером DT Exchange Android версии 8.2.7.0.
- Подтверждена совместимость с адаптером DT Exchange iOS версии 8.2.8.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.