В этом руководстве показано, как использовать 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 полученный в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .
Когда закончите, нажмите «Сохранить» внизу страницы.
Добавлять 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.3.0")
implementation("com.google.ads.mediation:fyber:8.3.0.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. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство для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)
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.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.