Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как интегрировать DT Exchange с медиацией

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

В этом руководстве рассказывается, как с помощью GMA Next-Gen SDK загружать и показывать объявления из DT Exchange с использованием медиации, в том числе каскадной интеграции. В этой статье рассказывается, как добавить DT Exchange в конфигурацию медиации рекламного блока и как интегрировать DT SDK и адаптер в приложение Android.

Поддерживаемые интеграции и форматы объявлений

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

Android API уровня 24 или более поздней версии.

Последняя версия GMA Next-Gen SDK.
Настройте медиацию.

Шаг 1. Настройте конфигурации в интерфейсе DT Exchange

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

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

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

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

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

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

Настройка

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

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

На странице App Management (Управление приложениями) запишите App ID (Идентификатор приложения) рядом с нужным приложением.

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

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

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

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

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

Как обновить файл app-ads.txt

Authorized Sellers for Apps (Авторизованные продавцы приложений), или app-ads.txt, – это инициатива IAB Tech Lab, которая позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы.

Чтобы реализовать app-ads.txt для DT Exchange, добавьте DT в файл app-ads.txt.

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

Войдите в аккаунт Менеджера рекламы.

Как добавить DT Exchange в раздел "Компании"

Ставки

Этот шаг не требуется для интеграции с системами назначения ставок.

Водопад

Нажмите Администрирование > Компании и выберите Новая компания на вкладке Все компании. Выберите Рекламная сеть.

Выберите DT SDK в качестве рекламной сети, введите уникальное название и включите медиацию. Включите Автоматический сбор данных и введите идентификатор издателя, секретный код клиента и ключ потребителя, полученные в предыдущем разделе.

Вводить имя пользователя или пароль не нужно. Когда все будет готово, нажмите Сохранить.

Как включить передачу защищенных сигналов

Ставки

Нажмите Администрирование > Глобальные настройки. Перейдите на вкладку Настройки аккаунта Ad Exchange, проверьте и включите передачу защищенных сигналов. Нажмите Сохранить.

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

Как передавать защищенные сигналы в запросах ставок

Ставки

Нажмите Инвентарь > Защищенные сигналы. В разделе Защищенные сигналы найдите DT Exchange (Fyber Monetization) и включите параметр Включить интеграцию с приложениями.

Нажмите Сохранить.

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Ставки

Нажмите Выполнение > Настройки каналов спроса. На вкладке Настройки по умолчанию включите параметр Разрешить передачу защищенных сигналов для назначения ставок на основе SDK.

Нажмите Сохранить.

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

Как настроить назначение ставок в DT Exchange

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Нажмите Новая система назначения ставок.

В качестве системы назначения ставок выберите DT Exchange.

Нажмите Продолжить, чтобы включить назначение ставок в SDK для этой системы назначения ставок.

Нажмите Готово.

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

Как настроить сопоставление рекламных блоков

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Выберите компанию для DT Exchange.

Перейдите на вкладку Сопоставление рекламных блоков и нажмите Новое сопоставление рекламных блоков.

Выберите Определенный рекламный блок. Выберите рекламный блок и формат, Мобильное приложение в качестве Типа инвентаря и нужное Мобильное приложение. Затем введите идентификатор приложения и идентификатор места размещения, полученные в предыдущем разделе.

Нажмите Сохранить.

Водопад

Откройте раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности. Выберите Инвентарь и Приложение.

Прокрутите страницу до раздела Партнеры по группе доходности и нажмите Добавить партнера по медиации.

Выберите компанию, которую вы создали для DT Exchange в предыдущем разделе. Выберите Медиация с использованием Mobile SDK в качестве типа интеграции, Android в качестве платформы и Активный в качестве статуса.

Введите идентификатор приложения и идентификатор места размещения, полученные в предыдущем разделе, а также значение цены за тысячу показов по умолчанию. Нажмите Сохранить.

Как добавить DT Exchange (Fyber Monetization) в список рекламных партнеров для соблюдения GDPR и законов штатов США

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

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

Интеграция с Android Studio (рекомендуется)

В файл gradle на уровне приложения добавьте следующие зависимости и конфигурации:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:fyber:8.4.7.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:fyber:8.4.7.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Настраиваемые вручную интеграции

Скачайте последнюю версию DT SDK для Android и добавьте fyber-marketplace-x.y.z.aar в свой проект.
Перейдите к артефактам адаптера DT Exchange в репозитории Google Maven. Выберите последнюю версию, скачайте файл .aar адаптера DT Exchange и добавьте его в проект.

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

Согласие пользователей из ЕС и GDPR

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

Адаптер DT Exchange для Android версии 8.3.0.0 и более поздних поддерживает передачу сигналов согласия по GDPR от платформ для запросов согласия, интегрированных со спецификацией Transparency and Consent Framework (TCF) от IAB, в DT Exchange SDK. Дополнительную информацию можно найти в разделе GDPR.

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

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

В DT Exchange есть API, который позволяет передавать согласие пользователей в SDK. В приведенном ниже образце кода показано, как вручную передать информацию о согласии в SDK DT. Если вы решите передавать информацию о согласии в DT SDK вручную, рекомендуем вызывать этот код до запроса объявлений через GMA Next-Gen SDK.

Java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

Kotlin

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

Замените US_PRIVACY_STRING строкой для соблюдения законов США в отношении конфиденциальности.

Подробнее о том, какие значения можно передавать с помощью этого метода, рассказывается в руководстве по реализации CCPA на сайте DT Exchange.

Шаг 5. Добавьте обязательный код

Загрузка объявления с контекстом активности

Передавайте контекст Activity при загрузке межстраничных объявлений. Без контекста активности загрузка объявлений невозможна.

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

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

Зарегистрируйте тестовое устройство в Менеджере рекламы.

Как проверить тестовые объявления

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

Необязательные действия

Параметры, относящиеся к определенной сети

Адаптер DT Exchange поддерживает дополнительные параметры запроса, которые можно передать адаптеру в виде пакета Android. Адаптер ищет в пакете следующие ключи:

Параметры и значения запроса
`InneractiveMediationDefs.KEY_AGE`	Целое число. Возраст пользователя.
`FyberMediationAdapter.KEY_MUTE_VIDEO`	Логическое значение. Как включить или отключить звук в видео

Ниже приведен пример кода, в котором заданы параметры запроса объявлений:

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter.class, extras).build();DTExchangeMediationSnippets.java

Kotlin

val extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request =
  AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras).build()DTExchangeMediationSnippets.kt

Коды ошибок

Если адаптер не получает объявление от DT Exchange, вы можете проверить основную ошибку в ответе на запрос объявления, используя ResponseInfo.getAdSourceResponses() в следующем классе:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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

История изменений адаптера медиации DT Exchange для Android