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

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

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

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

Требования

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

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

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

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

Шаг 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 в интерфейсе AdMob

Как настроить медиацию для рекламного блока

Вам нужно добавить BIGO Ads SDK в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Затем перейдите на вкладку Медиация. Если у вас уже есть группа медиации, которую вы хотите изменить, нажмите на ее название и перейдите к разделу Как добавить SDK BIGO Ads в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат и платформу объявления и нажмите Продолжить.

Укажите название группы медиации и выберите целевые местоположения. Затем установите для группы медиации статус Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово.

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить 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. Проверьте реализацию

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

Зарегистрируйте тестовое устройство в AdMob.

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.