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

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

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

Выберите платформу: Android (бета-версия)

Android iOS Unity Flutter

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

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

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

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

^1. Интеграция системы назначения ставок находится в закрытой бета-версии. Для получения доступа свяжитесь со своим менеджером по работе с клиентами.

^2. Формат рекламы с вознаграждением для системы назначения ставок в iOS находится в стадии альфа-тестирования.

Требования

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

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

Шаг 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 по умолчанию . Нажмите « Сохранить» .

Примечание: Автоматический сбор данных занимает несколько дней, прежде чем система сможет точно рассчитать значение динамического CPM для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.9.0")
    implementation("com.google.ads.mediation:fyber:8.4.1.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 вручную, рекомендуется вызывать этот код перед запросом рекламы через SDK Google Mobile Ads.

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	Контекст не является экземпляром действия.
200-399	DT SDK вернул ошибку. Подробности см. в коде .