Интегрируйте SDK Verve HyBid с системой торгов.

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

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

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

^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.

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

1. В Xcode перейдите в меню Файл > Добавить зависимости пакета... .

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

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

To comply with the Google EU User Consent Policy , you must make certain disclosures to your users in the European Economic Area (EEA), the UK, and Switzerland, and obtain their consent for the use of cookies or other local storage where legally required, and for the collection, sharing, and use of personal data for ads personalization. This policy reflects the requirements of the EU ePrivacy Directive and the General Data Protection Regulation (GDPR). You are responsible for verifying that consent is propagated to each ad source in your mediation chain.

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

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

US states privacy laws require giving users the right to opt out of the "sale" of their "personal information" (as the law defines those terms), with the opt-out offered through a prominent "Do Not Sell My Personal Information" link on the "selling" party's homepage. The US states privacy laws compliance guide offers the ability to enable restricted data processing for Google ad serving, but Google is unable to apply this setting to each ad network in your mediation chain. Therefore, you must identify each ad network in your mediation chain that may participate in the sale of personal information and follow guidance from each of those networks to ensure compliance.

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

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

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

Более подробную информацию см. в документации по соблюдению требований 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 при неудачной загрузке рекламы:

Список изменений адаптера 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.