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

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

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

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

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

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

1 Bidding integration is in closed beta, reach out to your account manager to request access.

2 Rewarded ad format for iOS bidding is in alpha.

Требования

  • Последняя версия Google Mobile Ads SDK
  • Flutter 3.7.0 или выше
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
  • Завершить посредничество. Руководство по началу работы.

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

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

Sign up or log in to DT Exchange Console.

Click Add App .

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

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

Андроид

iOS

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

Настраивать

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

Hover over the left navigation bar to open it, then click App Management .

On the App Management page, take note of the App ID next to your app.

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

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

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

Click your username from the left menu and select User Profile .

Запишите идентификатор издателя , ключ потребителя и секрет потребителя , так как они понадобятся на следующем этапе.

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

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

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

To implement app-ads.txt for DT Exchange, Add DT to your app-ads.txt file .

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

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

Андроид

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

iOS

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

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

Следуйте инструкциям в настройках европейского законодательства и государственных нормативных актов США, чтобы добавить DT Exchange (Fyber Monetization) в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе Менеджера рекламы.

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

Интеграция через 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.2.0

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

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

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

Step 4: Implement privacy settings on DT SDK

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

Плагин медиации Google Mobile Ads для DT Exchange не поддерживает передачу информации о согласии в DT SDK.

Законы США о конфиденциальности

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

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

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

Андроид

No additional code is required for DT Exchange integration.

iOS

Интеграция SKAdNetwork

Следуйте документации DT Exchange , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

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

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

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

Коды ошибок

Если адаптеру не удается получить рекламу от DT Exchange, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo в следующем классе:

Андроид 

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS 

GADMediationAdapterFyber

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

Андроид

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

iOS

Код ошибки Причина
0-10 DT SDK вернул ошибку. Подробнее см. в документации .
101 Параметры сервера DT Exchange, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют или недействительны.
102 Запрошенный размер объявления не соответствует поддерживаемому размеру баннера DT Exchange.
103 Не удалось показать объявление, так как объект объявления уже используется.
104 Не удалось показать рекламу DT Exchange, так как объявление не готово.
105 DT SDK returned an initialization error.

Журнал изменений адаптера Flutter Mediation для DT Exchange

Версия 1.1.5

Версия 1.1.4

Версия 1.1.3

Версия 1.1.2

Версия 1.1.1

Версия 1.1.0

Версия 1.0.0