Интегрируйте DT Exchange с посредничеством

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

В этом руководстве показано, как использовать Google Mobile Ads Flutter Plugin для загрузки и отображения объявлений из DT Exchange с помощью медиации , включая интеграцию по принципу водопада. В нем рассматривается, как добавить DT Exchange в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер DT в приложение Flutter.

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

The Flutter mediation adapter for DT Exchange has the following capabilities:

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

1. Интеграция системы назначения ставок находится в закрытой бета-версии. Для получения доступа свяжитесь со своим менеджером по работе с клиентами.

2. Формат нативной рекламы находится в стадии бета-тестирования, обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.

Требования

  • Новейший Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 или выше
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Целевая версия iOS для развертывания — 13.0 или выше.
  • A working Flutter project configured with Google Mobile Ads Flutter Plugin . See Set up Google Mobile Ads Flutter Plugin for details.
  • Настройте медиацию AdMob .

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

Добавить новое приложение и место размещения рекламы.

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

Нажмите «Добавить приложение» .

Управление приложениями

Выберите платформу и места размещения, заполните остальную часть формы, а затем нажмите «Создать приложение» .

Android

iOS

Введите имена и выберите типы для ваших размещений. Затем нажмите «Сохранить размещение» .

Настраивать

Идентификатор приложения и идентификатор размещения

Чтобы открыть левую панель навигации, наведите на неё курсор, затем нажмите «Управление приложениями» .

На странице управления приложениями обратите внимание на идентификатор приложения (App ID) , расположенный рядом с вашим приложением.

Выберите приложение и перейдите на вкладку « Трудоустройство» . Запишите идентификатор трудоустройства .

Идентификатор размещения

Идентификатор издателя, ключ потребителя и секретный ключ потребителя

Щелкните по своему имени пользователя в меню слева и выберите «Профиль пользователя» .

Запишите идентификатор издателя (Publisher ID) , ключ потребителя (Consumer Key ) и секретный ключ потребителя (Consumer Secret) , поскольку они понадобятся на следующем шаге.

Профиль пользователя

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов рекламы в приложениях , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для своего приложения .

Для интеграции app-ads.txt с DT Exchange добавьте DT в файл app-ads.txt .

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

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

Android

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

iOS

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

Add DT Exchange to GDPR and US state regulations ad partners list

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

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

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

Add the following dependency with the latest versions of the DT Exchange SDK and adapter in your package's pubspec.yaml file:

dependencies:
  gma_mediation_dtexchange: ^1.3.3

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

Загрузите последнюю версию плагина медиации Google Mobile Ads для DT Exchange , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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

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

The Google Mobile Ads mediation plugin for DT Exchange does not support passing consent information to the DT SDK.

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

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

The Google Mobile Ads mediation plugin for DT Exchange does not support passing consent information to the DT SDK.

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

Android

No additional code is required for DT Exchange integration.

iOS

Интеграция SKAdNetwork

Follow DT Exchange's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob.

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

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

коды ошибок

If the adapter fails to receive an ad from DT Exchange, publishers can check the underlying error from the ad response using ResponseInfo under the following class:

Android 

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS 

GADMediationAdapterFyber

Вот коды и соответствующие сообщения, которые выдает адаптер DT Exchange, когда реклама не загружается:

Android

Код ошибки Причина
101 Параметры сервера DT Exchange, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
103 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange.
105 DT SDK загрузил рекламу, но вернул неожиданный контроллер.
106 Объявление пока не готово к показу.
107 Контекст не является экземпляром действия.
200-399 DT SDK вернул ошибку. Подробности см. в коде .

iOS

Код ошибки Причина
0-10 DT SDK returned an error. See documentation for more details.
101 Параметры сервера DT Exchange, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
102 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому DT Exchange.
103 Failed to show ad because ad object has already been used.
104 Failed to show DT Exchange ads due to ad not ready.
105 DT SDK вернул ошибку инициализации.

Список изменений адаптера Flutter Mediation для DT Exchange

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

  • Обновлена ​​минимальная версия Flutter до 3.38.1.
  • Updated to support Google Mobile Ads Flutter Plugin version 8.0.0

Версия 1.3.3

Версия 1.3.2

Версия 1.3.1

Версия 1.2.0

Версия 1.1.5

Версия 1.1.4

Версия 1.1.3

Версия 1.1.2

Версия 1.1.1

Версия 1.1.0

Версия 1.0.0