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

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

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

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

Требования

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

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

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

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

Шаг 1. Настройте конфигурации в интерфейсе BIGO Ads SDK

Войдите на панель управления 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. Реализуйте настройки конфиденциальности в BIGO Ads SDK

Согласие пользователей из ЕС и 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

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

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

GADMediationAdapterBigo

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

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

Версия 6.1.0.0

• Проверена совместимость с BIGO Ads SDK версии 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

• Подтверждена совместимость с BIGO Ads SDK версии 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

• Подтверждена совместимость с BIGO Ads SDK версии 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

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

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

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