Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как интегрировать Verve HyBid SDK с медиацией AdMob

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

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

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

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

Интеграция
Ставки	¹
Водопад
Форматы
Баннер
Межстраничное объявление
Межстраничное объявление с вознаграждением
Бонус предоставлен
Стандартное

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

Требования

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

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

Последняя версия Google Mobile Ads SDK.
Настройте медиацию AdMob.

Шаг 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, вы можете выбрать его. В противном случае нажмите Добавить сопоставление.

Затем введите идентификатор зоны и токен приложения, полученные в предыдущем разделе. Затем нажмите Готово.

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

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

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

Используйте Swift Package Manager

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

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

В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне найдите следующий 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. Настройте параметры конфиденциальности в Verve SDK

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

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

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

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

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

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

Swift

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

Замените usPrivacyString строкой US Privacy.

Objective-C

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

Замените kUSPrivacyString строкой US Privacy.

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

Код ошибки	Поместье	Причина
100–106	Verve HyBid SDK возвратил ошибку.
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	Отсутствует идентификатор рекламного блока. Не удалось загрузить объявление.