Как интегрировать BidMachine с медиацией

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

Поддерживаемые интеграции и форматы объявлений

Адаптер для медиации BidMachine поддерживает следующие функции:

¹ Интеграция каскада находится на этапе бета-версии с ограниченным доступом. Чтобы получить доступ, обратитесь к менеджеру аккаунта.

Требования

Прежде чем продолжить, убедитесь, что:

• Целевая версия iOS – 13.0 или более поздняя.

• Последняя версия Google Mobile Ads SDK.

• Настройте медиацию.

Шаг 1. Задайте настройки в интерфейсе BidMachine

Войдите на панель управления аккаунта BidMachine.

Как создать места размещения

Перейдите на вкладку Источник и в таблице Источники нажмите кнопку Изменить.

Вы увидите список всех мест размещения. Чтобы создать место размещения, нажмите кнопку Добавить место размещения в диалоговом окне.

В качестве типа места размещения выберите Назначение ставок. Заполните форму и нажмите Сохранить.

Запишите идентификатор места размещения.

Как обновить файл app-ads.txt

Решение Authorized Sellers for Apps, или app-ads.txt, разработанное IAB Tech Lab, позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё не создали файл app-ads.txt для Менеджера рекламы, сделайте это.

Чтобы реализовать app-ads.txt для BidMachine, перейдите на вкладку app-ads.txt на панели управления. Затем скопируйте список и добавьте его в файл app-ads.txt на своем сайте.

Шаг 2. Настройте спрос BidMachine в интерфейсе Менеджера рекламы

Войдите в аккаунт Менеджера рекламы.

Добавьте BidMachine в разделе "Компании"

Как включить передачу защищенных сигналов

Как передавать защищенные сигналы в запросах ставок

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Как настроить назначение ставок в BidMachine

Как настроить сопоставление рекламных блоков

Добавьте BidMachine в список рекламных партнеров, соблюдающих GDPR и законы штатов США

Следуйте инструкциям в статьях Настройки, обеспечивающие соблюдение европейских регламентов и Настройки, обеспечивающие соблюдение законов штатов США, чтобы добавить BidMachine в список рекламных партнеров, соблюдающих европейские регламенты и законы штатов США, в интерфейсе Менеджера рекламы.

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

Как использовать Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 3.6.0.0.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

2. В появившемся окне введите следующий URL пакета:

   https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
   

3. В разделе Правило зависимости выберите Ветвь.

4. В текстовом поле введите main.

Через CocoaPods

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

  pod 'GoogleMobileAdsMediationBidMachine'
  

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

  pod install --repo-update

Интеграция вручную

1. Скачайте последнюю версию BidMachine SDK для iOS и свяжите все файлы .xcframework и пакеты в своем проекте.

2. Скачайте последнюю версию адаптера BidMachine по ссылке для скачивания в списке изменений и свяжите BidMachineAdapter.xcframework со своим проектом.

Шаг 4. Реализуйте настройки конфиденциальности в BidMachine SDK

Чтобы соблюдать правила Google в отношении согласия пользователей из ЕС, вы должны предоставлять пользователям из Европейской экономической зоны (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других средств локального хранения данных, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эти правила отражают требования, изложенные в Директиве ЕС о конфиденциальности и электронных средствах связи и Генеральном регламенте ЕС о защите персональных данных (GDPR). Вы должны убедиться, что согласие передается каждому источнику объявлений в цепочке медиации.

BidMachine автоматически считывает согласие по GDPR, заданное платформами для запросов согласия, включая UMP SDK. Дополнительную информацию можно найти в статье Генеральный регламент ЕС о защите персональных данных (GDPR).

Законы штатов США о конфиденциальности

Законы штатов США о конфиденциальности требуют предоставлять пользователям право запретить "продажу" их "личной информации" (эти термины определены в тексте закона). Компания, подпадающая под действие закона, обязана разместить на главной странице "продавца" ссылку с текстом "Запретить продажу личных данных". В руководстве по соблюдению законов штатов США о конфиденциальности рассказывается, как включить ограничение обработки данных для показа рекламы Google. Однако Google не может применить эту настройку ко всем рекламным сетям в вашей цепочке медиации. Поэтому вы должны определить, какие рекламные сети в вашей цепочке медиации могут участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.

BidMachine автоматически считывает согласие GPP, заданное платформами для управления согласием, в том числе UMP SDK. Подробнее GPP…

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

Как реализовать SKAdNetwork

Добавьте идентификаторы SKAdNetwork в файл Info.plist проекта, следуя инструкциям в документации BidMachine.

Шаг 6. Проверьте реализацию

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

Убедитесь, что вы зарегистрировали тестовое устройство в Менеджере рекламы.

Чтобы включить тестовый режим для BidMachine, следуйте инструкциям в документации BidMachine для iOS.

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

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

Необязательные шаги

Нативные объявления

Отображение объявлений

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

Коды ошибок

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

GADMediationAdapterBidMachine

Ниже приведены коды и сообщения, которые адаптер BidMachine возвращает, когда не удается загрузить объявление:

Журнал изменений адаптера для медиации BidMachine для iOS

Версия 3.8.2.0 (в процессе)

Версия 3.8.1.0

• Подтверждена совместимость с BidMachine SDK версии 3.8.1.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.10.0.
• BidMachine SDK версии 3.8.1.

Версия 3.8.0.0

• Подтверждена совместимость с BidMachine SDK версии 3.8.0.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.9.0.
• BidMachine SDK версии 3.8.0.

Версия 3.7.1.1

• Минимальная версия Google Mobile Ads iOS SDK изменена на 13.3, чтобы разрешить использование промежуточных версий.
• Теперь при сборе сигналов и загрузке объявлений в BidMachine SDK передается идентификатор места размещения.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.8.0.
• BidMachine SDK версии 3.7.1.

Версия 3.7.1.0

• Подтверждена совместимость с BidMachine SDK версии 3.7.1.
• Запросы объявлений с фиксированными ставками для баннеров не передают размер объявления должным образом.

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

• Google Mobile Ads SDK версии 13.4.0.
• BidMachine SDK версии 3.7.1.

Версия 3.7.0.0

• Подтверждена совместимость с BidMachine SDK версии 3.7.0.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.4.0.
• BidMachine SDK версии 3.7.0.

Версия 3.6.1.1

• Теперь адаптер пересылает флаг ageRestrictedTreatment из Google Mobile Ads SDK в COPPA API из BidMachine SDK.
• Обновите адаптер BidMachine и модульные тесты до Swift 6.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.3.0.
• BidMachine SDK версии 3.6.1.

Версия 3.6.1.0

• Подтверждена совместимость с BidMachine SDK версии 3.6.1.

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

• Google Mobile Ads SDK версии 13.2.0.
• BidMachine SDK версии 3.6.1.

Версия 3.6.0.0

• Подтверждена совместимость с BidMachine SDK версии 3.6.0.
• Проведен рефакторинг загрузки баннеров BidMachine и обработки изображений нативных объявлений.

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

• Google Mobile Ads SDK версии 13.1.0.
• BidMachine SDK версии 3.6.0.

Версия 3.5.1.2

• Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.

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

• Google Mobile Ads SDK версии 13.0.0.
• BidMachine SDK версии 3.5.1.

Версия 3.5.1.1

• Минимальная версия iOS для CocoaPods изменена на 13.0.
• Добавлена поддержка передачи параметра tagForUnderAgeOfConsent Google Mobile Ads SDK в BidMachine SDK.
• Изменены разделы о соответствии BidMachineAdDelegate, чтобы привести их в соответствие с поведением обратного вызова BidMachine SDK.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.0.0.
• BidMachine SDK версии 3.5.1.

Версия 3.5.1.0

• Подтверждена совместимость с BidMachine SDK версии 3.5.1.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 12.14.0.
• BidMachine SDK версии 3.5.1.

Версия 3.5.0.0

• Подтверждена совместимость с BidMachine SDK версии 3.5.0.

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

• Google Mobile Ads SDK версии 12.12.0.
• BidMachine SDK версии 3.5.0.

Версия 3.4.0.2

• Добавлена поддержка каскада для баннеров, межстраничных и нативных объявлений, а также объявлений с вознаграждением.
• Из BidMachineAdapterExtras удалено статическое свойство isTestMode.
• Добавлена проверка размера баннеров для каскадных баннеров.

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

• Google Mobile Ads SDK версии 12.12.0.
• BidMachine SDK версии 3.4.0.

Версия 3.4.0.1

• Теперь режим тестирования доступен в Objective-C через свойство GADMediationAdapterBidMachineExtras.isTestMode.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 12.0.0.
• BidMachine SDK версии 3.4.0.

Версия 3.4.0.0

• Первый выпуск.
• Добавлена поддержка назначения ставок для баннеров, межстраничных, нативных объявлений и объявлений с вознаграждением.
• Подтверждена совместимость с BidMachine SDK версии 3.4.0.

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

• Google Mobile Ads SDK версии 12.8.0.
• BidMachine SDK версии 3.4.0.