Интеграция SDK BIGO Ads с системой медиации.

Выберите платформу: AndroidНовый Android iOS Unity

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

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги 1
Водопад
Форматы
Приложение открыто
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный
Родной

1. Интеграция системы назначения ставок находится в закрытой бета-версии. Для получения доступа свяжитесь со своим менеджером по работе с клиентами.

Требования

  • Последняя версия Google Mobile Ads Unity Plugin
  • Unity 2019.4 или выше
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Целевая версия iOS для развертывания — 13.0 или выше.
  • Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Начало работы» .
  • Настройте посредничество AdMob.

Шаг 1: Настройка параметров в пользовательском интерфейсе BIGO Ads SDK.

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

Создайте приложение

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

Добавить приложение

Заполните оставшуюся часть формы и нажмите «Отправить» .

Новая форма заявки

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

Android

Идентификатор приложения Android

iOS

Идентификатор приложения iOS

Создать рекламный блок

После рассмотрения вашей заявки перейдите в таблицу рекламных мест и выберите кнопку «+ Добавить» .

Добавить рекламный блок

Выберите тип аукциона «Серверные ставки» , заполните остальную часть формы и нажмите «Отправить» .

Форма для создания нового рекламного места

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

Android

Идентификатор рекламного места Android

iOS

Идентификатор рекламного места iOS

Обновите файл app-ads.txt.

Файл 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.

Настройте параметры медиации для вашего рекламного блока.

Android

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

Чтобы добавить компанию BIGO TECHNOLOGY PTE LTD в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе AdMob, выполните действия, описанные в настройках европейского и американского нормативных актов .

Шаг 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.bigo

OpenUPM

В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .

На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM в качестве реестра с ограниченной областью действия, указав следующие данные:

  • Имя: OpenUPM
  • URL: https://package.openupm.com
  • Область применения: com.google

Подробности об OpenUPM

Затем перейдите в меню Window > Package Manager , чтобы открыть диспетчер пакетов Unity , и выберите My Registries из выпадающего меню.

Реестры единства

Выберите пакет Google Mobile Ads Bigo Mediation и нажмите « Установить» .

Установка из OpenUPM

Пакет Unity

Загрузите последнюю версию плагина медиации Google Mobile Ads для BIGO Ads SDK по ссылке для скачивания в списке изменений и извлеките файл GoogleMobileAdsBigoMediation.unitypackage из zip-архива.

В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный файл GoogleMobileAdsBigoMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите Import .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Силовое разрешение

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

Чтобы настроить параметры конфиденциальности для BIGO Ads SDK и соблюдать соответствующие правила защиты персональных данных, ознакомьтесь со следующими разделами.

В соответствии с Политикой 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: Протестируйте свою реализацию.

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob.

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