В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из BIGO Ads SDK с помощью медиации , включая интеграцию с системой назначения ставок. В нем рассматривается, как добавить BIGO Ads SDK в конфигурацию медиации рекламного блока, а также как интегрировать BIGO Ads SDK и адаптер в iOS-приложение.
Поддерживаемые интеграции и форматы рекламы
The mediation adapter for BIGO Ads SDK has the following capabilities:
| Интеграция | |
|---|---|
| Торги | 1 |
| Водопад | |
| Форматы | |
| Приложение открыто | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
1 Bidding integration is in closed beta, reach out to your account manager to request access.
Требования
- Целевая версия iOS для развертывания — 13.0 или выше.
Новейший Google Mobile Ads SDK
Заполните руководство по началу медиации.
Шаг 1: Настройка параметров в пользовательском интерфейсе BIGO Ads SDK.
Войдите в свою панель управления BIGO Ads.
Создайте приложение
Navigate to the Inventory tab and under the Apps and Sites table, select the + Add button.

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

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

Создать рекламный блок
Once your application has been reviewed, navigate to the Ad Slots table and select the + Add button.

Select Server Bidding for the Auction Type , fill out the rest of the form and click Submit .

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

Обновите файл app-ads.txt.
Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .
To implement app-ads.txt for BIGO Ads SDK, navigate to the APP-ads.txt tab from the Dashboard and follow the instructions located in the tab.

Step 2: Set up BIGO Ads SDK demand in Ad Manager UI
Войдите в свой аккаунт в Ad Manager .
Добавьте SDK BIGO Ads в раздел «Компании».
Торги
Этот шаг не требуется для интеграции с системами торгов.
Водопад
Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Select BIGO Ads SDK as the Ad network , enter a unique Name and enable Mediation .
You don't need to enter a Username or Password . Click Save when done.

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

Водопад
Этот шаг не требуется для интеграций с каскадной моделью распределения.
Передайте защищенный сигнал в запросах на участие в торгах.
Торги
Navigate to Inventory > Secure Signals . Under Secure signals , search for BIGO TECHNOLOGY PTE LTD and toggle on Enable app integration .

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

Нажмите « Сохранить ».
Водопад
Этот шаг не требуется для интеграций с каскадной моделью распределения.
Configure BIGO Ads SDK bidding
Торги
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

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

Нажмите «Готово» .
Водопад
Этот шаг не требуется для интеграций с каскадной моделью распределения.
Настройка сопоставления рекламных блоков
Торги
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter Slot ID obtained in the previous section.
Наконец, нажмите «Сохранить» .

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

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

Select the company you created for BIGO Ads SDK in the previous section. Choose Mobile SDK mediation as the Integration type , iOS as the Platform , and Active as the Status .
Enter the obtained in the previous section, and the Default CPM value. Click Save .

Add BIGO TECHNOLOGY PTE LTD to GDPR and US state regulations ad partners list
Чтобы добавить компанию BIGO TECHNOLOGY PTE LTD в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейского и американского нормативных актов .
Шаг 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 automatically reads GDPR consent set by consent management platforms including the UMP SDK . For more information, see BIGO Ads SDK's integration guide on GDPR .
Законы штатов США о защите частной жизни
Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.
The following sample code shows how to pass the consent flag to BIGO Ads SDK. Call this method before requesting ads through Google Mobile Ads SDK .
Быстрый
BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)
Objective-C
[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];
For more information, see BIGO Ads SDK's integration guide on CCPA .
Шаг 5: Добавьте необходимый код
Внедрить SKAdNetwork
Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации BIGO Ads SDK .
Шаг 6: Протестируйте свою реализацию.
Включить тестовые объявления
Make sure you register your test device for Ad Manager.
BIGO Ads предоставляет тестовые идентификаторы приложений и идентификаторы рекламных мест для iOS , что помогает в тестировании и интеграции.
Проверить тестовые объявления
To verify that you are receiving test ads from BIGO Ads SDK, enable single ad source testing in ad inspector using the BIGO Ads SDK (Bidding) ad source(s).
Дополнительные шаги
Нативная реклама
Отображение рекламы
The BIGO Ads SDK adapter returns its native ads as GADNativeAd objects. It populates the following fields for a GADNativeAd .
| Поле | Assets always included by BIGO Ads SDK adapter |
|---|---|
| Заголовок | |
| Изображение | |
| Тело | |
| Икона | |
| Призыв к действию | |
| Звездный рейтинг | |
| Магазин | |
| Цена | |
| Рекламодатель |
коды ошибок
If the adapter fails to receive an ad from BIGO Ads SDK, you can check the underlying error from the ad response using GADResponseInfo.adNetworkInfoArray under the following classes:
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.3.0.0
- Подтверждена совместимость с SDK BIGO Ads версии 5.3.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 13.6.0.
- BIGO Ads SDK version 5.3.0.
Версия 5.2.1.0
- Подтверждена совместимость с SDK BIGO Ads версии 5.2.1.
- Для использования новых API обеспечения конфиденциальности обновите минимальную версию зависимостей Google Mobile Ads SDK до 13.3.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 13.4.0.
- BIGO Ads SDK версии 5.2.1.
Версия 5.2.0.0
- Подтверждена совместимость с SDK BIGO Ads версии 5.2.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 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 version 5.1.2.
Version 5.1.2.0
- Подтверждена совместимость с SDK BIGO Ads версии 5.1.2.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.2.0.
- BIGO Ads SDK версии 5.1.2.
Version 5.1.1.0
- Подтверждена совместимость с SDK BIGO Ads версии 5.1.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 13.2.0.
- BIGO Ads SDK version 5.1.1.
Version 5.1.0.1
- Обновлен адаптер для предотвращения сбоев при запросе рекламы в случае загрузки баннерной рекламы с неподдерживаемым размером.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 13.1.0.
- BIGO Ads SDK версии 5.1.0.
Version 5.1.0.0
- Подтверждена совместимость с SDK BIGO Ads версии 5.1.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 13.1.0.
- BIGO Ads SDK version 5.1.0.
Version 5.0.6.2
- Обновлена зависимость Google Mobile Ads SDK до версии 13.0.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 13.0.0.
- BIGO Ads SDK version 5.0.6.
Version 5.0.6.1
- Обновлена минимальная версия iOS для CocoaPods до
13.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 13.0.0.
- BIGO Ads SDK version 5.0.6.
Version 5.0.6.0
- Initial release!
- Добавлена поддержка торгов для форматов рекламы: открытие приложения, баннерная реклама (включая MREC), межстраничная реклама, реклама с вознаграждением и нативная реклама.
- Подтверждена совместимость с SDK BIGO Ads версии 5.0.6.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 12.14.0.
- BIGO Ads SDK version 5.0.6.