В этом руководстве показано, как использовать 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 или более поздней версии.
Последняя версия Google Mobile Ads SDK (Legacy) .
Шаг 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.
Интеграция с 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
Котлин
Замените 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.