Эта страница переведена с помощью Cloud Translation API.

Интегрируйте 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 в качестве рекламной сети , введите уникальное имя и включите посредничество .

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

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

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

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

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

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

Интеграция с 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 не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей, чтобы обеспечить соблюдение требований.

Ява

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 (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 возвратил ошибку. См. код для более подробной информации.