Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

Интегрируйте DT Exchange с посредничеством

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

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

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

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

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

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

Настраивать

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

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

На странице управления приложениями обратите внимание на идентификатор приложения рядом с вашим приложением.

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

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

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

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

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

Профиль пользователя

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

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

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

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

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

Вам необходимо добавить DT Exchange в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свой аккаунт AdMob . Затем перейдите на вкладку «Медиация» . Если у вас есть группа медиации, которую вы хотите изменить, нажмите на её название, чтобы отредактировать её, и перейдите к разделу «Добавить DT Exchange в качестве источника рекламы» .

Чтобы создать новую группу посредничества, выберите Создать группу посредничества .

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

Дайте название группе медиации и выберите местоположения для таргетинга. Затем установите для группы медиации статус « Включено» и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавить DT Exchange в качестве источника рекламы

На карточке «Водопад» в разделе «Источники рекламы» выберите «Добавить источник рекламы» .

Выберите DT Exchange и включите переключатель «Оптимизировать» . Введите идентификатор издателя , секретный код потребителя и ключ потребителя, полученные в предыдущем разделе, чтобы настроить оптимизацию источника объявлений для DT Exchange. Затем введите значение eCPM для DT Exchange и нажмите «Продолжить» .

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

Затем введите идентификатор приложения и идентификатор размещения, полученные в предыдущем разделе. Нажмите «Готово» .

Примечание : Оптимизация источника объявлений может занять несколько дней, чтобы собрать достаточно данных для точного расчёта eCPM для медиационной сети. В настоящее время оптимизация источника объявлений имеет статус PENDING , поэтому вам необходимо вручную задать значение eCPM для сети. После того, как eCPM будет рассчитан, источник объявлений автоматически начнёт обновлять eCPM от вашего имени.

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

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

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

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

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

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

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

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

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

Законы США о конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как этот термин определен в законе). Отказ осуществляется через заметную ссылку «Не продавайте мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о конфиденциальности предлагает возможность включить ограниченную обработку данных для показа рекламы 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.

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

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

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

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

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

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

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

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

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

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

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

Параметры и значения запроса
`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, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны.
103	Запрошенный размер объявления не соответствует поддерживаемому размеру баннера DT Exchange.
105	DT Exchange SDK загрузил рекламу, но вернул неожиданный контроллер.
106	Объявление не готово к показу.
107	Контекст не является экземпляром деятельности.
200-399	DT Exchange SDK вернул ошибку. Подробнее см. в коде .

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