This guide shows you how to use Google Mobile Ads SDK to load and display ads from Verve HyBid SDK using mediation covering bidding integrations. It covers how to add Verve HyBid SDK to an ad unit's mediation configuration, and how to integrate the Verve HyBid SDK and adapter into an iOS app.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации для Verve HyBid SDK обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | 1 |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Вознагражденный интерстициальный | |
| Награжден | |
| Родной | |
1. Интеграция системы назначения ставок находится в стадии альфа-тестирования. Свяжитесь со своим менеджером по работе с клиентами, чтобы запросить доступ.
Предварительные требования
Прежде чем продолжить, проверьте следующее:
- Целевая версия iOS — 13.0 или более поздняя.
Последняя версия Google Mobile Ads SDK .
Шаг 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.
Используйте менеджер пакетов Swift.
Прежде чем продолжить, у вас должна быть установлена минимальная поддерживаемая версия адаптера 3.8.0.0.
Чтобы добавить зависимость пакета в ваш проект, выполните следующие действия:
В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий URL-адрес пакета:
https://github.com/googleads/googleads-mobile-ios-mediation-verve.gitВ разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите
main.
Используйте CocoaPods
Добавьте следующую строку в файл Podfile вашего проекта:
pod 'GoogleMobileAdsMediationVerve'В командной строке выполните:
pod install --repo-update
Ручная интеграция
Загрузите последнюю версию Verve iOS SDK и подключите файл
VerveSDK.frameworkк своему проекту.Загрузите последнюю версию адаптера Verve по ссылке для скачивания в журнале изменений и подключите файл
VerveAdapter.frameworkк вашему проекту.Добавьте в свой проект следующие фреймворки:
-
AdSupport -
AVFoundation -
CoreGraphics -
CoreMedia -
CoreTelephony -
StoreKit -
SystemConfiguration -
UIKit -
WebKit -
libz.tbd
-
Шаг 4: Внедрите настройки конфиденциальности в SDK Verve.
Согласие ЕС и GDPR
В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передано каждому источнику рекламы в вашей цепочке медиации.
SDK Verve HyBid автоматически считывает согласия, установленные в соответствии с GDPR платформами управления согласиями, включая UMP SDK . Для получения дополнительной информации см. раздел «Соответствие GDPR TCF» .
Законы штатов США о защите частной жизни
Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.
Verve HyBid SDK supports privacy settings through a method. The following sample code passes this consent information to Verve HyBid SDK. If you pass consent information to Verve HyBid SDK manually, we recommend that you call the example before you request ads through Google Mobile Ads SDK .
Быстрый
Замените usPrivacyString на строку с информацией о конфиденциальности, используемую в США.
Objective-C
Замените kUSPrivacyString на строку с информацией о конфиденциальности, принятую в США.
Более подробную информацию см. в документации по соблюдению требований CCPA в отношении конфиденциальности Verve HyBid SDK.
Шаг 5: Добавьте необходимый код
Внедрить SKAdNetwork
Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации Verve HyBid SDK .
Шаг 6: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Verve HyBid SDK, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Verve (для торгов ).
Для получения дополнительной информации о настройке следуйте документации Verve HyBid SDK .
коды ошибок
Если адаптер не получает объявление от Verve HyBid SDK, издатели могут проверить основную причину ошибки в ответе на объявление, используя GADResponseInfo.adNetworkInfoArray из следующих классов:
GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve
Вот коды и соответствующие сообщения, которые выдает адаптер Verve HyBid SDK при неудачной загрузке рекламы:
| Код ошибки | Домен | Причина |
|---|---|---|
| от 100 до 106 | SDK Verve HyBid вернул ошибку. | |
| 101 | com.google.mediation.verve | В конфигурации сервера отсутствует необходимый токен приложения. |
| 102 | Пользователь — ребёнок. | |
| 103 | com.google.mediation.verve | Не удаётся инициализировать Verve HyBid SDK. |
| 104 | com.google.mediation.verve | Неверные настройки объявления для его загрузки. |
| 105 | com.google.mediation.verve | Неподдерживаемый размер баннера. |
| 106 | com.google.mediation.verve | Полноэкранная реклама не готова к показу. |
| 115 | com.google.mediation.verve | Отсутствует идентификатор рекламного блока. Не удаётся загрузить объявление. |
Список изменений адаптера Verve для медиации iOS
Версия 3.9.2.0
- Подтверждена совместимость с версией HyBid SDK 3.9.2.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.9.0.
- Версия HyBid SDK 3.9.2.
Версия 3.9.1.0
- Подтверждена совместимость с версией HyBid SDK 3.9.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.8.0.
- Версия HyBid SDK 3.9.1.
Версия 3.9.0.0
- Обновлена минимальная версия SDK Google Mobile Ads для iOS до
13.3, чтобы упростить процедуру и разрешить использование минорных версий. - Подтверждена совместимость с версией HyBid SDK 3.9.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.6.0.
- Версия HyBid SDK: 3.9.0.
Версия 3.8.1.1
- Фильтруйте запросы с возрастными ограничениями для Verve SDK, если для параметра new
ageRestrictedTreatmentустановлено значениеGADAgeRestrictedTreatmentChild.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.4.0.
- Версия HyBid SDK 3.8.1.
Версия 3.8.1.0
- Подтверждена совместимость с версией HyBid SDK 3.8.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.4.0.
- Версия HyBid SDK 3.8.1.
Версия 3.8.0.0
- Удалена проверка размера баннера из адаптера для устранения сбоев сбора сигнала и загрузки рекламы.
- Подтверждена совместимость с версией HyBid SDK 3.8.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.2.0.
- Версия HyBid SDK 3.8.0.
Версия 3.7.1.3
- Обновлена зависимость Google Mobile Ads SDK до версии 13.0.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.0.0.
- Версия HyBid SDK 3.7.1.
Версия 3.7.1.2
- Обновлена минимальная версия iOS для CocoaPods до
13.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.0.0.
- Версия HyBid SDK 3.7.1.
Версия 3.7.1.1
- Первый релиз!
- Поддерживает форматы баннерной рекламы с назначением ставок, межстраничной рекламы, рекламы с вознаграждением, межстраничной рекламы с вознаграждением и нативной рекламы.
- Подтверждена совместимость с версией HyBid SDK 3.7.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 12.13.0.
- Версия HyBid SDK 3.7.1.