Интегрируйте DT Exchange с медиацией

Примечание. Fyber Marketplace теперь называется DT Exchange.

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

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

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

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

Требования

• Android API уровня 21 или выше

• Последняя версия Google Mobile Ads SDK

• Пройдите руководство по началу работы с медиацией

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

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

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

Нажмите кнопку «Добавить приложение», чтобы добавить свое приложение.

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

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

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

Откройте левую панель навигации, наведя на нее указатель мыши. Затем нажмите «Приложения» в меню слева.

На странице «Управление приложениями» запишите идентификатор приложения рядом с вашим приложением.

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

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

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

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

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

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

Войдите в свою учетную запись Менеджера рекламы .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» .

Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря « Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.

Затем нажмите кнопку «Добавить партнера по доходности» .

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

ВыбиратьDT Exchange В качестве рекламной сети введите уникальное имя и включите посредничество .

Включите Автоматический сбор данных и введитеPublisher ID, Consumer Secret and Consumer Keyполученное в предыдущем разделе.

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции .Android как Платформа и Активный как Статус . ВведитеApplication ID and Placement ID полученное в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Важно : Application ID должен быть связан с целевым приложением, как вDT Exchange Пользовательский интерфейс.

Когда закончите, нажмите «Сохранить» внизу страницы.

Примечание. Автоматическому сбору данных требуется несколько дней, прежде чем можно будет точно рассчитать значение динамической цены за тысячу показов для сети медиации. Как только эффективная цена за тысячу показов будет рассчитана, она будет автоматически обновлена ​​от вашего имени.

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

Важно! Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС, GDPR, CPRA и платформы обмена сообщениями пользователей. Подробности см. в разделе Управление доступом пользователей к вашей учетной записи .

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

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

Примечание. Невозможность интеграции совместимых версий DT Exchange и Google Mobile Ads SDK может привести к проблемам при сборке.

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:fyber:8.3.3.0")
}

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

• Загрузите последнюю версию DT Exchange SDK для Android и добавьте в свой проект следующие файлы:
  • ia-mraid-kit-release-xyzaar
  • ia-sdk-core-release-xyzaar
  • ia-video-kit-release-xyzaar
• Перейдите к артефактам адаптера DT Exchange в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера DT Exchange и добавьте его в свой проект.

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

Согласие ЕС и GDPR

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

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

Ява

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Котлин

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

Посетите страницу ресурсов DT Exchange по GDPR и узнайте ихРуководство по внедрению GDPRдля получения более подробной информации и значений, которые могут быть предоставлены в методе.

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

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

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

Ява

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Котлин

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

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

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

Для интеграции DT Exchange не требуется никакого дополнительного кода.

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

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

Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.

Важно! Отключите тестовый режим для Менеджера рекламы и DT Exchange перед выпуском приложения.

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

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

Дополнительные шаги

Сетевые параметры

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

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

Вот пример кода, показывающий, как задать эти параметры запроса объявления:

Ява

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();

Котлин

var 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()

Коды ошибок

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

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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

Журнал изменений адаптера DT Exchange для Android-посредника

Версия 8.3.3.0

• Проверенная совместимость с DT Exchange SDK 8.3.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.5.0.
• DT Exchange SDK версии 8.3.3.

Версия 8.3.2.0

• Проверенная совместимость с DT Exchange SDK 8.3.2.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.4.0.
• DT Exchange SDK версии 8.3.2.

Версия 8.3.1.0

• Проверенная совместимость с DT Exchange SDK 8.3.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.3.0.
• DT Exchange SDK версии 8.3.1.

Версия 8.3.0.0

• Добавлена ​​поддержка передачи версии Google Mobile Ads SDK в DT Exchange SDK.
• Проверенная совместимость с DT Exchange SDK 8.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.2.0.
• DT Exchange SDK версии 8.3.0.

Версия 8.2.7.0

• Проверенная совместимость с DT Exchange SDK 8.2.7.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.0.0.
• DT Exchange SDK версии 8.2.7.

Версия 8.2.6.1

• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 23.0.0.
• Проверенная совместимость с DT Exchange SDK 8.2.6.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.0.0.
• DT Exchange SDK версии 8.2.6.

Версия 8.2.6.0

• Проверенная совместимость с DT Exchange SDK 8.2.6.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.6.0.
• DT Exchange SDK версии 8.2.6.

Версия 8.2.5.0

• Проверенная совместимость с DT Exchange SDK 8.2.5.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.5.0.
• DT Exchange SDK версии 8.2.5.

Версия 8.2.4.0

• Проверенная совместимость с DT Exchange SDK 8.2.4.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.3.0.
• DT Exchange SDK версии 8.2.4.

Версия 8.2.3.0

• Обновлен адаптер для использования нового класса VersionInfo .
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 22.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.0.0.
• DT Exchange SDK версии 8.2.3.

Версия 8.2.2.1

• Добавлена ​​поддержка передачи ключа muteVideo в дополнительном медиаторе для отключения межстраничных объявлений.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.5.0.
• DT Exchange SDK версии 8.2.2.

Версия 8.2.2.0

• Проверенная совместимость с DT Exchange SDK 8.2.2.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.5.0.
• DT Exchange SDK версии 8.2.2.

Версия 8.2.1.0

• Название адаптера переименовано в «DT Exchange».
• Проверенная совместимость с DT Exchange SDK 8.2.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.3.0.
• DT Exchange SDK версии 8.2.1.

Версия 8.2.0.0

• Проверенная совместимость с Fyber SDK 8.2.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.1.0.
• Fyber SDK версии 8.2.0.

Версия 8.1.5.0

• Проверенная совместимость с Fyber SDK 8.1.5.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.0.0.
• Fyber SDK версии 8.1.5.

Версия 8.1.4.0

• Проверенная совместимость с Fyber SDK 8.1.4.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.0.0.
• Fyber SDK версии 8.1.4.

Версия 8.1.3.1

• compileSdkVersion и targetSdkVersion обновлены до API 31.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.0.0.
• Минимально необходимый уровень Android API обновлен до 19.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.0.0.
• Fyber SDK версии 8.1.3.

Версия 8.1.3.0

• Проверенная совместимость с Fyber SDK 8.1.3.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.6.0.
• Fyber SDK версии 8.1.3.

Версия 8.1.2.0

• Проверенная совместимость с Fyber SDK 8.1.2.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.5.0.
• Fyber SDK версии 8.1.2.

Версия 8.1.0.0

• Проверенная совместимость с Fyber SDK 8.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.4.0.
• Fyber SDK версии 8.1.0.

Версия 7.8.4.1

• Исправлена ​​проблема, из-за которой адаптер не инициализировался, если в конфигурациях передачи имеется дубликат или несколько уникальных идентификаторов приложения.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.4.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.4.0.
• Fyber SDK версии 7.8.4.

Версия 7.8.4.0

• Проверенная совместимость с Fyber SDK 7.8.4.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.3.0.
• Исправлена ​​проблема с медийной рекламой с вознаграждением, из-за которой не вызывался onVideoComplete() .
• Fyber теперь требует контекст активности для показа рекламы.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.3.0.
• Fyber SDK версии 7.8.4.

Версия 7.8.3.0

• Проверенная совместимость с Fyber SDK 7.8.3.
• Добавлены стандартизированные коды ошибок и сообщения адаптера.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.1.0.
• Fyber SDK версии 7.8.3.

Версия 7.8.2.0

• Проверенная совместимость с Fyber SDK 7.8.2.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.0.0.
• Fyber SDK версии 7.8.2.

Версия 7.8.1.0

• Проверенная совместимость с Fyber SDK 7.8.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.7.0.
• Fyber SDK версии 7.8.1.

Версия 7.8.0.0

• Проверенная совместимость с Fyber SDK 7.8.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.7.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.7.0.
• Fyber SDK версии 7.8.0.

Версия 7.7.4.0

• Проверенная совместимость с Fyber SDK 7.7.4.
• Исправлена ​​проблема, из-за которой onUserEarnedReward() перенаправляется дважды для рекламы с вознаграждением.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.5.0.
• Fyber SDK версии 7.7.4.

Версия 7.7.3.0

• Проверенная совместимость с Fyber SDK 7.7.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.5.0.
• Fyber SDK версии 7.7.3.

Версия 7.7.2.0

• Проверенная совместимость с Fyber SDK 7.7.2.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.5.0.
• Fyber SDK версии 7.7.2.

Версия 7.7.1.0

• Проверенная совместимость с Fyber SDK 7.7.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.4.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.4.0.
• Fyber SDK версии 7.7.1.

Версия 7.7.0.0

• Проверенная совместимость с Fyber SDK 7.7.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.3.0.
• Fyber SDK версии 7.7.0.

Версия 7.6.1.0

• Проверенная совместимость с Fyber SDK 7.6.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.3.0.
• Fyber SDK версии 7.6.1.

Версия 7.6.0.0

• Проверенная совместимость с Fyber SDK 7.6.0.
• Обновлен адаптер для поддержки запросов встроенных адаптивных баннеров.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.3.0.
• Исправлена ​​ошибка, из-за которой методы onAdOpened()/onAdClosed() не вызывались для баннерной рекламы.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.3.0.
• Fyber SDK версии 7.6.0.

Версия 7.5.4.0

• Проверенная совместимость с Fyber SDK 7.5.4.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.1.0.
• Fyber SDK версии 7.5.4.

Версия 7.5.3.0

• Проверенная совместимость с Fyber SDK 7.5.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.0.1.
• Fyber SDK версии 7.5.3.

Версия 7.5.2.0

• Проверенная совместимость с Fyber SDK 7.5.2.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.0.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.0.1.
• Fyber SDK версии 7.5.2.

Версия 7.5.0.0

• Проверенная совместимость с Fyber SDK 7.5.0.
• Исправлен сбой NullPointerException во время загрузки рекламы Fyber.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 18.3.0.
• Fyber SDK версии 7.5.0.

Версия 7.4.1.0

• Проверенная совместимость с Fyber SDK 7.4.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 18.3.0.
• Fyber SDK версии 7.4.1.

Версия 7.3.4.0

• Первый выпуск!
• Поддерживает баннерную, межстраничную рекламу и рекламу с вознаграждением.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 18.2.0.
• Fyber SDK версии 7.3.4.