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

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

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

Адаптер-посредник Unity для DT Exchange обладает следующими возможностями:

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

Требования

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

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

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

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

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

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

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

Андроид

iOS

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

Настраивать

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

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

На странице управления приложениями обратите внимание на идентификатор приложения рядом с вашим приложением.

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

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

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

Нажмите на свое имя пользователя в левом меню и выберите Профиль пользователя .

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

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

Обновите файл 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

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

Андроид

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

iOS

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

Добавьте DT Exchange в список рекламных партнеров, соответствующих GDPR и государственным нормам США.

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

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

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI , вы можете установить плагин-посредник Google Mobile Ads DT Exchange для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.dtexchange

OpenUPM

В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .

На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com
  • Область(ы): com.google

Подробности OpenUPM

Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.

Реестры Unity

Выберите пакет посредничества Google Mobile Ads DTExchange и нажмите «Установить» .

Установить из OpenUPM

Пакет Unity

Загрузите последнюю версию плагина медиации Google Mobile Ads для DT Exchange по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsDTExchangeMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsDTExchangeMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Сила Решения

Шаг 4: Реализуйте настройки конфиденциальности в DT Exchange SDK

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

В этом разделе показано, как включить или отключить персонализированную рекламу для DT Exchange.

Плагин медиации Google Mobile Ads для DT Exchange версии 1.1.0 добавил класс Fyber с методами SetGDPRRequired() и SetGDPRConsentString() , что позволяет вручную передавать информацию о согласии в DT Exchange. Следующий пример кода демонстрирует, как передать эти параметры адаптеру DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

Дополнительную информацию и значения, которые можно предоставить в этом методе, можно найти в статье DT Exchange о GDPR .

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

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

Плагин медиации Google Mobile Ads для DT Exchange версии 3.1.1 добавил класс Fyber с методом SetCCPAString() , позволяющим вручную передавать информацию о согласии в DT Exchange. Следующий пример кода демонстрирует, как передать эти параметры адаптеру DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

Дополнительную информацию и значения, которые можно предоставить в этом методе, можно найти в статье CCPA Open Source на сайте DT Exchange.

Шаг 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 Объявление не готово к показу.
107 Контекст не является экземпляром деятельности.
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 Unity Mediation

Версия 3.3.11

Версия 3.3.10

Версия 3.3.9

Версия 3.3.8

Версия 3.3.7

Версия 3.3.6

Версия 3.3.5

Версия 3.3.4

Версия 3.3.3

Версия 3.3.2

Версия 3.3.1

Версия 3.3.0

Версия 3.2.1

Версия 3.2.0

Версия 3.1.12

Версия 3.1.11

Версия 3.1.10

Версия 3.1.8

Версия 3.1.7

Версия 3.1.6

Версия 3.1.5

Версия 3.1.4

Версия 3.1.3

Версия 3.1.2

Версия 3.1.1

Версия 3.1.0

Версия 3.0.2

Версия 3.0.1

Версия 3.0.0

Версия 2.0.0

Версия 1.6.1

Версия 1.6.0

Версия 1.5.2

Версия 1.5.1

Версия 1.5.0

Версия 1.4.0

Версия 1.3.0

Версия 1.2.3

Версия 1.2.2

Версия 1.2.1

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0