Эта страница переведена с помощью Cloud Translation API.

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

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

В этом руководстве показано, как использовать 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.

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

В 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). Вы несете ответственность за проверку того, что согласие передается каждому источнику рекламы в вашей цепочке посредничества. Google не может автоматически передавать выбор согласия пользователя таким сетям.

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

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

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

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

Быстрый

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

Замените usPrivacyString на строку с информацией о конфиденциальности, используемую в США.

Objective-C

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

Замените 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	Отсутствует токен приложения.
102	Пользователь — ребёнок.
103	Не удаётся инициализировать Verve HyBid SDK.
104	Неверные настройки рекламы.
105	Неподдерживаемый размер баннера.
106	Полноэкранная реклама не готова к показу.
115	Отсутствует идентификатор рекламного блока. Не удаётся загрузить объявление.
116	Объявление не готово. Невозможно отобразить объявление.