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

Интеграция DT Exchange с посредничеством

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

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

Адаптер-посредник Ad Manager для 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 полученный в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

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

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

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить Fyber в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:fyber:8.2.7.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")

Посетите страницу ресурсов GDPR DT Exchange и их руководство по внедрению 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. Проверьте свою реализацию

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

Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager.

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

Чтобы убедиться, что вы получаете тестовые объявления от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)

var adrequest = 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-посредника