Как интегрировать BIGO Ads SDK с медиацией

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

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

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

Требования

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

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

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

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

Шаг 1. Задайте настройки в интерфейсе рекламного SDK BIGO Ads

Войдите в панель управления BIGO Ads.

Как создать приложение

Перейдите на вкладку Инвентарь и в таблице Приложения и сайты нажмите кнопку + Добавить.

Заполните остальные поля и нажмите Отправить.

Запишите идентификатор приложения.

Как создать рекламное место

После того как ваша заявка будет рассмотрена, перейдите к таблице Рекламные места и нажмите кнопку Добавить.

В поле Тип аукциона выберите Назначение ставок на сервере, заполните остальные поля формы и нажмите Отправить.

Запишите идентификатор рекламного места.

Как обновить файл app-ads.txt

Решение Authorized Sellers for Apps, или app-ads.txt, разработанное IAB Tech Lab, позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё не создали файл app-ads.txt для Менеджера рекламы, сделайте это.

Чтобы реализовать app-ads.txt для BIGO Ads SDK, перейдите на вкладку APP-ads.txt на панели управления и следуйте инструкциям на этой вкладке.

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

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

Добавьте BIGO Ads SDK в разделе "Компании"

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

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

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

Как настроить назначение ставок в BIGO Ads SDK

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

Добавление BIGO TECHNOLOGY PTE LTD в список рекламных партнеров, соблюдающих GDPR и законы штатов США в отношении конфиденциальности

Чтобы добавить Empathy Technology Pte.Ltd. (BIGO Ads) в список рекламных партнеров для европейских регламентов, а **BIGOAds** – в список рекламных партнеров для законов штатов США, следуйте инструкциям в разделах Настройки европейских регламентов и Настройки законов штатов США.

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

CocoaPods

• Добавьте в Podfile проекта следующую строку:

  pod 'GoogleMobileAdsMediationBigo'
  

• В командной строке выполните следующую команду:

  pod install --repo-update

Шаг 4. Задайте настройки конфиденциальности в рекламном SDK BIGO Ads

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

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

BIGO Ads SDK автоматически считывает согласие по GDPR, заданное платформами для управления согласием, в том числе UMP SDK. Дополнительную информацию можно найти в руководстве по интеграции BIGO Ads SDK, посвященном GDPR.

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

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

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

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

Дополнительную информацию можно найти в руководстве по интеграции рекламного SDK BIGO Ads, посвященном CCPA.

Шаг 5. Добавьте обязательный код

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

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

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

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

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

BIGO Ads предоставляет тестовые идентификаторы приложений и идентификаторы рекламных мест для iOS, чтобы упростить тестирование и интеграцию.

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

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

Необязательные шаги

Нативные объявления

Отображение объявлений

Адаптер BIGO Ads SDK возвращает нативные объявления в виде объектов GADNativeAd. Она заполняет следующие поля для GADNativeAd:

Коды ошибок

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

GADMediationAdapterBigo

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

Журнал изменений адаптера BIGO Ads iOS Mediation

Версия 6.1.0.0

• Подтверждена совместимость с рекламным SDK BIGO Ads версии 6.1.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.10.0.
• BIGO Ads SDK версии 6.1.0.

Версия 6.0.0.1

• Теперь адаптер сопоставляет запросы адаптивных баннеров с ближайшим поддерживаемым размером стандартного баннера.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.10.0.
• BIGO Ads SDK версии 6.0.0.

Версия 6.0.0.0

• Подтверждена совместимость с BIGO Ads SDK версии 6.0.0.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.9.0.
• BIGO Ads SDK версии 6.0.0.

Версия 5.3.0.0

• Подтверждена совместимость с BIGO Ads SDK версии 5.3.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.6.0.
• BIGO Ads SDK версии 5.3.0.

Версия 5.2.1.0

• Подтверждена совместимость с BIGO Ads SDK версии 5.2.1.
• Чтобы использовать новые API конфиденциальности, обновите минимальную зависимость Google Mobile Ads SDK до версии 13.3.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.4.0.
• BIGO Ads SDK версии 5.2.1.

Версия 5.2.0.0

• Подтверждена совместимость с рекламным SDK BIGO Ads версии 5.2.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.4.0.
• BIGO Ads SDK версии 5.2.0.

Версия 5.1.2.1

• Теперь адаптер передает флаг ageRestrictedTreatment Google Mobile Ads SDK в COPPA API BIGO Ads SDK.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.3.0.
• BIGO Ads SDK версии 5.1.2.

Версия 5.1.2.0

• Подтверждена совместимость с рекламным SDK BIGO Ads версии 5.1.2.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.2.0.
• BIGO Ads SDK версии 5.1.2.

Версия 5.1.1.0

• Подтверждена совместимость с BIGO Ads SDK версии 5.1.1.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.2.0.
• BIGO Ads SDK версии 5.1.1.

Версия 5.1.0.1

• Адаптер обновлен, чтобы предотвратить сбои запросов объявлений, когда баннер загружается с неподдерживаемым размером.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.1.0.
• BIGO Ads SDK версии 5.1.0.

Версия 5.1.0.0

• Подтверждена совместимость с BIGO Ads SDK версии 5.1.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.1.0.
• BIGO Ads SDK версии 5.1.0.

Версия 5.0.6.2

• Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.0.0.
• BIGO Ads SDK версии 5.0.6.

Версия 5.0.6.1

• Минимальная версия iOS для CocoaPods изменена на 13.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.0.0.
• BIGO Ads SDK версии 5.0.6.

Версия 5.0.6.0

• Первый выпуск!
• Добавлена поддержка назначения ставок для объявлений при запуске приложения, баннеров (включая MREC), межстраничных, нативных объявлений и объявлений с вознаграждением.
• Подтверждена совместимость с BIGO Ads SDK версии 5.0.6.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 12.14.0.
• BIGO Ads SDK версии 5.0.6.