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

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

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

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

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

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

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

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

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

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

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

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

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

Настройте параметры медиации для вашего рекламного блока.

Вам необходимо добавить Verve HyBid SDK в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас уже есть группа медиации, которую вы хотите изменить, щелкните по ее названию, чтобы отредактировать ее, и перейдите к разделу «Добавить Verve HyBid SDK в качестве источника рекламы» .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте Verve HyBid SDK в качестве источника рекламы.


В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите Verve HyBid SDK .

Нажмите «Как подписать партнерское соглашение и настроить партнерство для участия в тендерах с помощью Verve HyBid SDK».



Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .



Если у вас уже есть сопоставление для Verve HyBid SDK, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .



Далее введите идентификатор зоны (Zone ID) и токен приложения (AppToken) , полученные в предыдущем разделе. Затем нажмите «Готово» .

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

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

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

В файле 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.

В соответствии с Политикой 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);

Котлин

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

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

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

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

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

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

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления от 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 Контекст отсутствует.

Список изменений адаптера Verve для медиации на Android

Версия 3.9.1.0

  • Подтверждена совместимость с версией 3.9.1 SDK Verve HyBid.

Разработано и протестировано с помощью:

  • Версия Google Mobile Ads SDK: 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.3.1.
  • Версия Verve HyBid SDK: 3.9.1.

Версия 3.9.0.0

  • Фильтруйте запросы с возрастными ограничениями для Verve SDK, если для параметра new AgeRestrictedTreatment установлено значение CHILD .
  • Подтверждена совместимость с версией 3.9.0 SDK Verve HyBid.

Разработано и протестировано с помощью:

  • Версия Google Mobile Ads SDK: 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.2.1.
  • Версия SDK Verve HyBid: 3.9.0.

Версия 3.8.2.0

  • Подтверждена совместимость с версией 3.8.2 SDK Verve HyBid.

Разработано и протестировано с помощью:

  • Версия Google Mobile Ads SDK: 25.3.0.
  • Google Mobile Ads Next-Gen SDK версии 1.2.1.
  • Версия SDK Verve HyBid: 3.8.2.

Версия 3.8.1.1

  • Фильтрация кликабельных представлений позволяет отличать клики по информации о контенте от кликов по обычной рекламе в VerveNativeAd.

Разработано и протестировано с помощью:

  • Версия Google Mobile Ads SDK: 25.2.0.
  • Google Mobile Ads Next-Gen SDK версии 1.0.1.
  • Версия SDK Verve HyBid: 3.8.1.

Версия 3.8.1.0

  • Добавлено свойство для сборки адаптера с зависимостью от GMA Next-Gen SDK.
  • Подтверждена совместимость с версией 3.8.1 SDK Verve HyBid.

Разработано и протестировано с помощью:

  • Версия Google Mobile Ads SDK: 25.1.0.
  • Версия SDK Verve HyBid: 3.8.1.

Версия 3.7.1.1

  • Удалена проверка размера баннера из адаптера Verve для устранения сбоев сбора сигнала.

Разработано и протестировано с помощью:

  • Версия Google Mobile Ads SDK: 25.0.0.
  • Версия Verve HyBid SDK 3.7.1.

Версия 3.7.1.0

  • Первый релиз.
  • Подтверждена совместимость с версией 3.7.1 SDK Verve HyBid.

Разработано и протестировано с помощью:

  • Версия Google Mobile Ads SDK: 24.8.0.
  • Версия Verve HyBid SDK 3.7.1.