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

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

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

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

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

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

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

Требования

• Android API уровня 23 или выше

• Новейший Google Mobile Ads SDK

• Заполните руководство по началу медиации.

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

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

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

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

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

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

Важно: После создания новой заявки она будет помещена на рассмотрение . Заявку необходимо проверить, прежде чем вы сможете перейти к следующим шагам.

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

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

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

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

Обновите файл 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.

Войдите в свой аккаунт в Ad Manager .

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

Торги

Этот шаг не требуется для интеграции с системами торгов.

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Выберите BIGO Ads SDK в качестве рекламной сети , введите уникальное имя и включите медиацию .

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

Включить безопасный обмен сигналами

Торги

Перейдите в раздел Администрирование > Глобальные настройки . Перейдите на вкладку настроек учетной записи Ad Exchange , просмотрите и включите параметр «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите компанию BIGO TECHNOLOGY PTE LTD и включите опцию «Включить интеграцию с приложением» .

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка системы назначения ставок в BIGO Ads SDK

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

Выберите BIGO Ads SDK в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

Нажмите «Готово» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка сопоставления рекламных блоков

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Выберите компанию для использования SDK BIGO Ads.

Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Создать новое сопоставление рекламных блоков» .

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, тип инвентаря — «Мобильное приложение» , и ваше мобильное приложение . Затем введите идентификатор слота , полученный в предыдущем разделе.

Наконец, нажмите «Сохранить» .

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

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» . Выберите ваше мобильное приложение .

Прокрутите вниз и нажмите «Добавить партнера по доходности» .

Выберите компанию, которую вы создали для BIGO Ads SDK в предыдущем разделе. В качестве типа интеграции выберите «Посредничество мобильного SDK» , в качестве платформы — «Android» , а в качестве статуса — «Активный» .

Введите значение, полученное в предыдущем разделе, и значение CPM по умолчанию . Нажмите «Сохранить» .

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

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

Важно: Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС и GDPR, правил штатов США и платформы обмена сообщениями пользователей. Подробнее см. раздел «Управление доступом пользователей к вашей учетной записи» .

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

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

Примечание: Несоответствие версий BIGO Ads SDK и Google Mobile Ads SDK друг другу может привести к проблемам при сборке.

Интеграция с Android Studio (рекомендуется)

В файл gradle на уровне приложения добавьте следующие зависимости реализации:

Котлин

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.3.0")
    implementation("com.google.ads.mediation:bigo:5.9.0.0")
}

Классный

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:bigo:5.9.0.0'
}

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

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

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

Законы штатов США о защите частной жизни

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

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

Java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

Котлин

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

Для получения более подробной информации см. руководство по интеграции BIGO Ads SDK с CCPA .

Шаг 5: Добавьте необходимый код

Для интеграции с BIGO Ads SDK дополнительный код не требуется.

Шаг 6: Протестируйте свою реализацию.

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

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

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

Важно: перед выпуском приложения отключите тестовый режим для Ad Manager и BIGO Ads SDK.

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

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

Дополнительные шаги

Нативная реклама

Отображение рекламы

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

Поле	Все ресурсы всегда включены в адаптер BIGO Ads SDK.
Заголовок
Изображение
Тело
Икона
Призыв к действию
Звездный рейтинг
Магазин
Цена
Рекламодатель

коды ошибок

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

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

Вот коды и соответствующие сообщения, которые выдает адаптер BIGO Ads SDK при неудачной загрузке рекламы:

Код ошибки	Домен	Причина
101	com.google.mediation.bigoadapter	Отсутствует или пуст идентификатор слота Bigo.
1000-1100	Отправлено с помощью BIGO Ads SDK	BIGO Ads SDK вернул ошибку. Дополнительные сведения см. в документации BIGO Ads SDK .

Список изменений адаптера Bigo для медиации Android

Следующая версия

• Сопоставляет AgeRestrictedTreatment с API Bigo COPPA.

Версия 5.9.0.0

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

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

• Версия Google Mobile Ads SDK: 25.2.0.
• Google Mobile Ads Next-Gen SDK версии 1.0.1.
• Версия SDK Bigo Ads: 5.9.0.

Версия 5.8.0.0

• Добавлено свойство для сборки адаптера с зависимостью от GMA Next-Gen SDK.
• Подтверждена совместимость с Bigo Ads SDK 5.8.0.

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

• Версия Google Mobile Ads SDK: 25.1.0.
• Версия SDK Bigo Ads: 5.8.0.

Версия 5.7.1.0

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

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

• Версия Google Mobile Ads SDK: 25.0.0.
• Версия SDK Bigo Ads: 5.7.1.

Версия 5.7.0.0

• Добавлена ​​поддержка пересылки параметра tagForUnderAgeOfConsent из Google Mobile Ads SDK в Bigo Ads SDK.
• Подтверждена совместимость с Bigo Ads SDK 5.7.0.

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

• Версия Google Mobile Ads SDK: 24.9.0.
• Версия SDK Bigo Ads: 5.7.0.

Версия 5.5.2.0

• Добавлена ​​поддержка баннерной, межстраничной, рекламной и нативной рекламы.
• Подтверждена совместимость с Bigo Ads SDK 5.5.2.

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

• Версия Google Mobile Ads SDK: 24.9.0.
• Версия SDK Bigo Ads: 5.5.2.