Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

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

Интеграция SDK Verve HyBid с механизмом посредничества.

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

В этом руководстве показано, как использовать Google Mobile Ads SDK (Legacy) для загрузки и отображения объявлений из Verve HyBid SDK с помощью медиации, охватывающей интеграцию с системой назначения ставок. В нем рассматривается, как добавить Verve HyBid SDK в конфигурацию медиации рекламного блока, а также как интегрировать Verve HyBid SDK и адаптер в приложение для Android.

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

Адаптер медиации для Verve HyBid SDK обладает следующими возможностями:

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

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

Предварительные требования

Прежде чем продолжить, проверьте следующее:

Android API уровня 23 или более поздней версии.

Последняя версия Google Mobile Ads SDK (Legacy) .
Организуйте посредничество .

Шаг 1: Настройте параметры в пользовательском интерфейсе Verve HyBid SDK.

Для настройки параметров обратитесь в компанию Verve .

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

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

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

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

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

Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите Verve HyBid SDK и включите параметр «Включить интеграцию с приложением» .

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

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

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

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

Настройка системы торгов Verve HyBid SDK

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

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

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

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

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

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

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

Выберите компанию для получения Verve HyBid SDK.

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

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

Если вы настраиваете сопоставление рекламных блоков для межстраничной рекламы с вознаграждением в пользовательском интерфейсе Ad Manager, выберите формат «С вознаграждением» и используйте идентификатор размещения межстраничной рекламы с вознаграждением.

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

Добавьте Verve Group в список рекламных партнеров, соблюдающих GDPR и правила штатов США.

Чтобы добавить Verve Group в список рекламных партнеров, соответствующих европейским и американским государственным нормативным актам, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейского и американского законодательства .

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

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

В файле settings.gradle.kts на уровне проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

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

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

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

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

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

SDK Verve HyBid автоматически считывает согласия, установленные в соответствии с GDPR платформами управления согласиями, включая UMP SDK . Для получения дополнительной информации см. раздел «Соответствие GDPR TCF» .

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

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

SDK Verve HyBid поддерживает настройки конфиденциальности через специальный метод. Приведенный ниже пример кода передает эту информацию о согласии в SDK Verve HyBid. Если вы передаете информацию о согласии в SDK Verve HyBid вручную, мы рекомендуем вызвать этот пример перед запросом рекламы через Google Mobile Ads SDK (Legacy) .

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);VerveMediationSnippets.java

Котлин

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)VerveMediationSnippets.kt

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

Более подробную информацию см. в документации по соблюдению требований CCPA в отношении конфиденциальности Verve HyBid SDK.

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

Для интеграции с Verve HyBid SDK дополнительный код не требуется.

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

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

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

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

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

Для получения дополнительной информации о настройке следуйте документации Verve HyBid SDK .

коды ошибок

Если адаптер не получает объявление от Verve HyBid SDK, издатели могут проверить основную причину ошибки в ответе на объявление, используя ResponseInfo.getAdapterResponses() в следующих классах:

net.pubnative.lite.sdk
com.google.ads.mediation.verve

Вот коды и соответствующие сообщения, которые выдает адаптер Verve HyBid SDK при неудачной загрузке рекламы:

Код ошибки	Причина
от 100 до 103	SDK Verve HyBid вернул ошибку.
101	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому SDK Verve HyBid.
102	Отсутствует или пуст токен приложения.
103	Контекст отсутствует.