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

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

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

В этом руководстве показано, как использовать GMA Next-Gen SDK для загрузки и отображения рекламы из Verve HyBid SDK с помощью медиации , включая интеграцию с системой назначения ставок. В нем рассматривается, как добавить Verve HyBid SDK в конфигурацию медиации рекламного блока, а также как интегрировать Verve HyBid SDK и адаптер в приложение для Android.

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

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

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

¹ Bidding integration is in alpha. Reach out to your your account manager to request access.

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

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

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

Последняя версия GMA Next-Gen SDK .
Организуйте посредничество .

Step 1: Set up configurations in Verve HyBid SDK UI

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

Step 2: Set up Verve HyBid SDK demand in Ad Manager UI

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

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

Navigate to Admin > Global settings . Go to the Ad Exchange account settings tab and review and toggle on Secure signal sharing . Click Save .

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

Navigate to Inventory > Secure Signals . Under Secure signals , search for Verve HyBid SDK and toggle on Enable app integration .

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

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

Navigate to Delivery > Demand channel settings . In the Default settings tab, toggle on Allow secure signal sharing for SDK Bidding .

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

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

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

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

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

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

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

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

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

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

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

Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter Zone ID and AppToken obtained in the previous section.

If you are configuring ad unit mapping for a rewarded interstitial ad within the Ad Manager UI, choose the Rewarded format and use the rewarded interstitial placement ID.

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

Add Verve Group to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Verve Group to the European and US state regulations ad partners list in the Ad Manager UI.

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

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

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

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

Then, in your app-level build.gradle.kts file, add the following implementation dependencies and configurations. Use the latest versions of the Verve HyBid SDK and adapter:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0")
    implementation("com.google.ads.mediation:verve:3.9.2.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

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

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

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

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

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

SDK Verve HyBid поддерживает настройки конфиденциальности через специальный метод. Приведенный ниже пример кода передает эту информацию о согласии в SDK Verve HyBid. Если вы передаете информацию о согласии в SDK Verve HyBid вручную, мы рекомендуем вызвать этот пример перед запросом рекламы через GMA Next-Gen SDK .

Java

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

Котлин

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

Replace US_PRIVACY_STRING with your US privacy string.

For details, see Verve HyBid SDK privacy documentation on CCPA Compliance .

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

No additional code is required for Verve HyBid SDK integration.

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

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

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

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

To verify that you are receiving test ads from Verve HyBid SDK, enable single ad source testing in ad inspector using the Verve (Bidding) ad source(s).

Follow Verve HyBid SDK's documentation for additional configuration.

коды ошибок

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

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

Here are the codes and accompanying messages thrown by the Verve HyBid SDK adapter when an ad fails to load:

Код ошибки	Домен	Причина
101	The requested ad size does not match a Verve HyBid SDK supported banner size.
102	net.pubnative.lite.sdk	Ошибка Verve HyBid — Не удалось загрузить объявление.
103	com.google.ads.mediation.verve	Была предпринята попытка показать полноэкранную рекламу без рекламного блока.
104	com.google.ads.mediation.verve	MobileAds.getRequestConfiguration() indicates the user is a child. Verve will be dropped.