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

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

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

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

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

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

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

Требования

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

• Новейший GMA Next-Gen SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте BIGO Ads SDK в качестве источника рекламы.

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите BIGO Ads SDK .

Нажмите «Как заключить партнерское соглашение и настроить партнерство по размещению ставок с помощью BIGO Ads SDK».



Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .



Если у вас уже есть сопоставление для BIGO Ads SDK, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .



Далее введите идентификатор слота , полученный в предыдущем разделе. Затем нажмите «Готово» .

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

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

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

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

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

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

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

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

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1")
    implementation("com.google.ads.mediation:bigo:5.9.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Классный

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1'
    implementation 'com.google.ads.mediation:bigo:5.9.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Шаг 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. Вызовите этот метод перед запросом рекламы через GMA Next-Gen 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: Протестируйте свою реализацию.

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

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

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

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

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

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

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

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

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

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

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

коды ошибок

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

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.