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

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

Выберите платформу: Android

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

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

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

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

Требования

Android API уровня 23 или выше
[Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему торгов, используйте адаптер DT Exchange версии 8.4.2.0 или выше ( рекомендуется последняя версия ).

Новейший Google Mobile Ads SDK .
Пройдите руководство по началу процесса медиации.

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

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

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

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

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

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

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

Настраивать

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

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

На странице управления приложениями обратите внимание на идентификатор приложения (App ID) , расположенный рядом с вашим приложением.

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

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

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

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

Запишите идентификатор издателя (Publisher ID) , ключ потребителя (Consumer Key ) и секретный ключ потребителя (Consumer Secret) , поскольку они понадобятся на следующем шаге.

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

Для интеграции app-ads.txt с DT Exchange добавьте DT в файл app-ads.txt .

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

Войдите в свой аккаунт в Ad Manager .

Добавить DT Exchange в список компаний

Торги

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

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

Включить безопасный обмен сигналами

Торги

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

Водопад

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

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

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

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

Водопад

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

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

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

Водопад

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

Настройка системы торгов DT Exchange

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

Выберите компанию DT Exchange в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

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

Водопад

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

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

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

Наконец, нажмите «Сохранить» .

Водопад

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

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

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

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

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

Чтобы добавить DT Exchange (монетизацию Fyber) в список рекламных партнеров , соответствующих европейским и американским государственным нормативным актам, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных актов .

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

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

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

Котлин

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

Классный

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:fyber:8.4.5.0'
}

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

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

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

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

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

Начиная с версии DT Exchange SDK 8.3.0, DT Exchange автоматически считывает согласия GDPR, установленные платформами управления согласиями, поддерживающими спецификацию Google Additional Consent . Для получения дополнительной информации см. руководство по внедрению GDPR в DT Exchange.

Законы штатов США о защите частной жизни

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

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

Java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

Котлин

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

Замените US_PRIVACY_STRING на строку конфиденциальности, соответствующую вашим правам в США.

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

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

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

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

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

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

Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.

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

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

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

Параметры, специфичные для сети

Адаптер 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

Котлин

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.getAdapterResponses() из следующего класса:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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

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