В этом руководстве показано, как использовать Google Mobile Ads Unity Plugin для загрузки и отображения рекламы из BIGO Ads SDK с помощью медиации , включая интеграцию с системой назначения ставок. В нем рассматривается, как добавить BIGO Ads SDK в конфигурацию медиации рекламного блока и как интегрировать BIGO Ads SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации Ad Manager для SDK BIGO Ads обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | 1 |
| Водопад | |
| Форматы | |
| Приложение открыто | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
1. Интеграция системы назначения ставок находится в закрытой бета-версии. Для получения доступа свяжитесь со своим менеджером по работе с клиентами.
Требования
- Последняя версия Google Mobile Ads Unity Plugin
- Unity 2019.4 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Целевая версия iOS для развертывания — 13.3 или выше.
- Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Начало работы» .
- Настройка посредничества в менеджере рекламы
Шаг 1: Настройка параметров в пользовательском интерфейсе BIGO Ads SDK.
Войдите в свою панель управления BIGO Ads.
Создайте приложение
Перейдите на вкладку «Инвентарь» и в таблице «Приложения и сайты» выберите кнопку «+ Добавить» .
Заполните оставшуюся часть формы и нажмите «Отправить» .
Запишите свой идентификатор приложения .
Android
iOS
Создать рекламный блок
После рассмотрения вашей заявки перейдите в таблицу рекламных мест и выберите кнопку «+ Добавить» .
Выберите тип аукциона «Серверные ставки» , заполните остальную часть формы и нажмите «Отправить» .
Запишите идентификатор слота .
Android
iOS
Обновите файл app-ads.txt.
Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .
Для интеграции app-ads.txt с BIGO Ads SDK перейдите на вкладку APP-ads.txt в панели управления и следуйте инструкциям, расположенным на этой вкладке.
Шаг 2: Настройте запрос BIGO Ads SDK в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте компанию BIGO TECHNOLOGY PTE LTD в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.
Чтобы добавить компанию BIGO TECHNOLOGY PTE LTD в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейского и американского нормативных актов .
Шаг 3: Импортируйте SDK и адаптер BIGO Ads.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads BIGO Ads SDK Mediation Plugin for Unity в свой проект, выполнив следующую команду из корневого каталога проекта:
openupm add com.google.ads.mobile.mediation.bigoOpenUPM
В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .
На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM в качестве реестра с ограниченной областью действия, указав следующие данные:
- Имя:
OpenUPM - URL:
https://package.openupm.com - Область применения:
com.google
Затем перейдите в меню Window > Package Manager , чтобы открыть диспетчер пакетов Unity , и выберите My Registries из выпадающего меню.
Выберите пакет Google Mobile Ads Bigo Mediation и нажмите « Установить» .
Пакет Unity
Загрузите последнюю версию плагина медиации Google Mobile Ads для BIGO Ads SDK по ссылке для скачивания в списке изменений и извлеките файл GoogleMobileAdsBigoMediation.unitypackage из zip-архива.
В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный файл GoogleMobileAdsBigoMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите Import .
Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.
Шаг 4: Внедрите настройки конфиденциальности в SDK BIGO Ads.
Чтобы настроить параметры конфиденциальности для BIGO Ads SDK и соблюдать соответствующие правила защиты персональных данных, ознакомьтесь со следующими разделами.
Согласие ЕС и GDPR
В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передается каждому источнику рекламы в вашей цепочке посредничества. Google не может автоматически передавать выбор согласия пользователя таким сетям.
BIGO Ads SDK автоматически считывает согласия, установленные в соответствии с GDPR платформами управления согласиями, включая UMP SDK . Для получения дополнительной информации см. руководство по GDPR для Android и iOS в BIGO Ads SDK.
Законы штатов США о защите частной жизни
Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.
Приведенный ниже пример кода показывает, как передать флаг согласия в SDK BIGO Ads. Вызовите этот метод перед запросом рекламы через Google Mobile Ads Unity Plugin .
using GoogleMobileAds.Mediation.Bigo.Api;
// ...
Bigo.SetCcpaConsent(true);
Шаг 5: Добавьте необходимый код
Android
Для интеграции с BIGO Ads SDK дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации BIGO Ads SDK .
Шаг 6: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
BIGO Ads предоставляет тестовые идентификаторы приложений и идентификаторы рекламных мест для Android и iOS , что помогает в тестировании и интеграции.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от BIGO Ads SDK, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений BIGO Ads SDK (для торгов ).
коды ошибок
Если адаптер не получает объявление от BIGO Ads SDK, вы можете проверить основную причину ошибки в ответе на объявление, используя класс ResponseInfo из следующих разделов:
Android
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
iOS
GADMediationAdapterBigo
Коды ошибок и сопутствующие сообщения генерируются адаптером BIGO Ads SDK в случае неудачной загрузки рекламы:
Android
| Код ошибки | Домен | Причина |
|---|---|---|
| 101 | com.google.mediation.bigoadapter | Отсутствует или пуст идентификатор слота Bigo. |
| 1000-1100 | Отправлено с помощью BIGO Ads SDK | BIGO Ads SDK вернул ошибку. Дополнительные сведения см. в документации BIGO Ads SDK . |
iOS
| Код ошибки | Домен | Причина |
|---|---|---|
| 101 | com.google.ads.mediation.bigo | В конфигурации сервера отсутствует необходимый идентификатор приложения. |
| 102 | com.google.ads.mediation.bigo | Неверные настройки рекламы. |
| 103 | com.google.ads.mediation.bigo | Неудачная презентация рекламы. |
| 104 | com.google.ads.mediation.bigo | Неподдерживаемый размер баннера. |
| 105 | com.google.ads.mediation.bigo | Bigo успешно загрузил баннерную рекламу, но просмотр объявления отсутствует. |
| 1000-1100 | Отправлено с помощью BIGO Ads SDK | BIGO Ads SDK вернул ошибку. Дополнительные сведения см. в документации BIGO Ads SDK . |
Список изменений в плагине Unity Mediation для BIGO Ads SDK
Версия 1.0.0
- Первый релиз!
- Поддерживает адаптер BIGO Ads SDK для Android версии 5.8.0.0 .
- Поддерживает адаптер BIGO Ads SDK для iOS версии 5.1.2.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.