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

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

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

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

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

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

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

Требования

• Целевая версия iOS для развертывания — 13.3 или выше.

• Новейший 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» , в качестве платформы — «iOS» , а в качестве статуса — «Активный» .

Введите значение, полученное в предыдущем разделе, и значение 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 друг другу может привести к проблемам при сборке.

CocoaPods

• Добавьте следующую строку в файл Podfile вашего проекта:

  pod 'GoogleMobileAdsMediationBigo'
  

• В командной строке выполните:

  pod install --repo-update

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

Быстрый

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

Objective-C

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

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

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

Внедрить SKAdNetwork

Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации BIGO Ads SDK .

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

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

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

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

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

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

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

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

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

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

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

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

коды ошибок

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

GADMediationAdapterBigo

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

Код ошибки	Домен	Причина
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 .

Список изменений адаптера медиации BIGO Ads для iOS

Версия 5.2.1.0

• Подтверждена совместимость с SDK BIGO Ads версии 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

• Подтверждена совместимость с SDK BIGO Ads версии 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 в API COPPA SDK BIGO Ads.

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

• Версия Google Mobile Ads SDK: 13.3.0.
• BIGO Ads SDK версии 5.1.2.

Версия 5.1.2.0

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

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

• Версия Google Mobile Ads SDK: 13.2.0.
• BIGO Ads SDK версии 5.1.2.

Версия 5.1.1.0

• Подтверждена совместимость с SDK BIGO Ads версии 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

• Подтверждена совместимость с SDK BIGO Ads версии 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

• Первый релиз!
• Добавлена ​​поддержка торгов для форматов рекламы: открытие приложения, баннерная реклама (включая MREC), межстраничная реклама, реклама с вознаграждением и нативная реклама.
• Подтверждена совместимость с SDK BIGO Ads версии 5.0.6.

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

• Версия Google Mobile Ads SDK: 12.14.0.
• BIGO Ads SDK версия 5.0.6.