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

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

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

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

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

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

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

Требования

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

Шаг 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, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .



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



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

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

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

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

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

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления от 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.