В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из BIGO Ads SDK с помощью AdMob Mediation , включая интеграцию с системой назначения ставок. В нем рассматривается, как добавить BIGO Ads SDK в конфигурацию медиации рекламного блока, а также как интегрировать BIGO Ads SDK и адаптер в iOS-приложение.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации для BIGO Ads SDK обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | 1 |
| Водопад | |
| Форматы | |
| Приложение открыто | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
1. Интеграция системы назначения ставок находится в закрытой бета-версии. Для получения доступа свяжитесь со своим менеджером по работе с клиентами.
Требования
- Целевая версия iOS для развертывания — 13.0 или выше.
Новейший 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 для своего приложения .
Для интеграции 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.