Как интегрировать Verve HyBid SDK с назначением ставок

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

Поддерживаемые интеграции и форматы объявлений

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

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

Требования

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

• Целевая версия iOS – 13.0 или более поздняя.

• Последняя версия Google Mobile Ads SDK.

• Настройте медиацию.

Шаг 1. Задайте настройки в интерфейсе Verve HyBid SDK

Чтобы настроить конфигурацию, свяжитесь с Verve.

Шаг 2. Настройте спрос Verve HyBid SDK в интерфейсе Менеджера рекламы

Войдите в аккаунт Менеджера рекламы.

Включить передачу защищенных сигналов

Нажмите Администрирование > Глобальные настройки. Перейдите на вкладку Настройки аккаунта Ad Exchange и включите функцию Передача защищенных сигналов. Нажмите Save (Сохранить).

Как передавать защищенные сигналы в запросах ставок

Нажмите Инвентарь > Защищенные сигналы. В разделе Защищенные сигналы найдите Verve HyBid SDK и включите параметр Включить интеграцию с приложениями.

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

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Нажмите Выполнение > Настройки каналов спроса. На вкладке Настройки по умолчанию сдвиньте переключатель Разрешить передачу защищенных сигналов вправо для назначения ставок в SDK.

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

Как настроить назначение ставок в SDK Verve HyBid

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Нажмите Новая система назначения ставок.

В качестве системы назначения ставок выберите Verve Group.

Нажмите Продолжить, чтобы включить назначение ставок в SDK для этой системы назначения ставок.

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

Как настроить сопоставление рекламных блоков

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

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

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

Выберите Определенный рекламный блок. Выберите рекламный блок и формат, укажите Мобильное приложение в качестве типа инвентаря и выберите мобильное приложение. Затем введите идентификатор зоны и токен приложения, полученные в предыдущем разделе.

Если вы настраиваете сопоставление рекламных блоков для межстраничного объявления с вознаграждением в интерфейсе Менеджера рекламы, выберите формат С вознаграждением и укажите идентификатор места размещения для межстраничных объявлений с вознаграждением.

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

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

Следуйте инструкциям в статьях Настройки, обеспечивающие соблюдение европейских регламентов и Настройки, обеспечивающие соблюдение законов штатов США, чтобы добавить Verve Group в список рекламных партнеров, обеспечивающих соблюдение европейских регламентов и законов штатов США, в интерфейсе Менеджера рекламы.

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

Как использовать Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 3.8.0.0.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

2. В появившемся окне введите следующий URL пакета:

   https://github.com/googleads/googleads-mobile-ios-mediation-verve.git
   

3. В разделе Правило зависимостей выберите Ветвь.

4. В текстовом поле введите 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. Настройте параметры конфиденциальности в Verve SDK

Согласие пользователей из ЕС и GDPR

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

Verve HyBid SDK автоматически считывает согласие по GDPR, заданное платформами для запросов согласия, включая UMP SDK. Подробнее о соблюдении спецификации TCF в рамках GDPR…

Законы штатов США о конфиденциальности

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

SDK Verve HyBid поддерживает настройки конфиденциальности с помощью метода. Приведенный ниже пример кода передает эту информацию о согласии в Verve HyBid SDK. Если вы передаете информацию о согласии в Verve HyBid SDK вручную, рекомендуем вызвать пример до того, как вы запросите объявления через Google Mobile Ads SDK.

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)
VerveMediationSwiftSnippets.swift

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];
VerveMediationObjectiveCSnippets.m

Подробную информацию можно найти в документации по конфиденциальности Verve HyBid SDK в разделе CCPA Compliance (Соответствие закону CCPA).

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

Как реализовать SKAdNetwork

Следуйте инструкциям из документации по SDK Verve HyBid, чтобы добавить идентификаторы SKAdNetwork в файл Info.plist проекта.

Шаг 6. Проверьте реализацию

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

Убедитесь, что вы зарегистрировали тестовое устройство в Менеджере рекламы.

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

Чтобы проверить, получаете ли вы тестовые объявления из Verve HyBid SDK, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник объявлений Verve (Ставки).

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

Коды ошибок

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

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

Ниже приведены коды и сообщения, которые адаптер Verve HyBid SDK возвращает, когда не удается загрузить объявление:

Журнал изменений адаптера Verve для медиации iOS

Версия 3.9.3.0 (в процессе)

Версия 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

• Минимальная версия Google Mobile Ads SDK для 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, когда для нового параметра 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.