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

To comply with Google EU User Consent Policy , you must make certain disclosures to your users in the European Economic Area (EEA), the UK, and Switzerland, and obtain their consent for the use of cookies or other local storage where legally required, and for the collection, sharing, and use of personal data for ads personalization. This policy reflects the requirements of the EU ePrivacy Directive and the General Data Protection Regulation (GDPR). You are responsible for verifying consent is propagated to each ad source in your mediation chain. Google is unable to pass the user's consent choice to such networks automatically.

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

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

US states privacy laws require giving users the right to opt out of the "sale" of their "personal information" (as the law defines those terms), with the opt-out offered through a prominent "Do Not Sell My Personal Information" link on the "selling" party's homepage. The US states privacy laws compliance guide offers the ability to enable restricted data processing for Google ad serving, but Google is unable to apply this setting to each ad network in your mediation chain. Therefore, you must identify each ad network in your mediation chain that may participate in the sale of personal information and follow guidance from each of those networks to ensure compliance.

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	Контекст отсутствует.