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

В этом руководстве рассказывается, как использовать GMA Next-Gen SDK для загрузки и показа объявлений из BidMachine с помощью медиации AdMob, а также описывается интеграция назначения ставок. В ней рассказывается, как добавить BidMachine в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер BidMachine в приложение для Android.

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

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

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

Требования

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

• Android API уровня 24 или более поздней версии.

• [Для назначения ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер BidMachine версии 3.4.0.1 или более поздней (рекомендуется последняя версия).

• Последняя версия GMA Next-Gen SDK.

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

Шаг 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 в интерфейсе AdMob

Как настроить медиацию для рекламного блока

Добавьте BidMachine в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Перейдите на вкладку Медиация. Если вы хотите изменить существующую группу медиации, нажмите на ее название и перейдите к разделу Как добавить BidMachine в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат объявления и платформу, а затем нажмите Продолжить.

Укажите название группы медиации и выберите местоположения для таргетинга. Затем установите для статуса группы медиации значение Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово.

Вы увидите карточку с выбранными рекламными блоками:

Как добавить BidMachine в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и выберите Добавить источник объявлений. Затем выберите BidMachine.

Нажмите Как подписать партнерское соглашение и установите партнерскую связь с назначением ставок с BidMachine.



Нажмите Подтвердить и согласиться, а затем – Продолжить.



Если у вас уже есть сопоставление для BidMachine, вы можете выбрать его. В противном случае нажмите Добавить сопоставление.



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

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите BidMachine. Затем введите значение эффективной цены за тысячу показов для BidMachine и нажмите Продолжить.




Если у вас уже есть сопоставление для BidMachine, вы можете выбрать его. В противном случае нажмите Добавить сопоставление.



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

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

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

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

Интеграция с Android Studio (рекомендуется)

В файле settings.gradle (или settings.gradle.kts) на уровне проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifactory.bidmachine.io/bidmachine")
    }
  }
}

В файле gradle на уровне приложения добавьте следующие зависимости и конфигурации:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:bidmachine:3.8.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:bidmachine:3.8.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Шаг 4. Настройте параметры конфиденциальности в BidMachine SDK

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

Адаптер BidMachine для Android версии 3.3.0.0 и более поздних поддерживает передачу сигналов согласия по GDPR от платформ для запросов согласия, интегрированных со спецификацией Transparency and Consent Framework (TCF) от IAB, в BidMachine SDK. Дополнительную информацию можно найти в статье Генеральный регламент ЕС о защите персональных данных (GDPR).

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

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

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

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

Для интеграции с BidMachine не требуется дополнительный код.

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

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

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

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

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

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

Необязательные действия

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

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

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

Коды ошибок

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

io.bidmachine
com.google.ads.mediation.bidmachine

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

Журнал изменений адаптера BidMachine Android Mediation

Следующая версия

• Адаптер обновлен для использования InitializationCompleteCallback.onInitializationFailed(AdError) API.
• Минимальный уровень Android API изменен на 24.

Версия 3.8.0.1

• Закрепите зависимость адаптера от Kotlin на версии 1.9.0 (минимальная версия Kotlin, поддерживаемая GMA NextGen SDK).

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

• Google Mobile Ads SDK версии 25.4.0.
• Google Mobile Ads Next-Gen SDK версии 1.4.0.
• BidMachine SDK версии 3.8.0.

Версия 3.8.0.0

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

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

• Google Mobile Ads SDK версии 25.4.0.
• Google Mobile Ads Next-Gen SDK версии 1.4.0.
• BidMachine SDK версии 3.8.0.

Версия 3.7.1.1

• Сопоставляет AgeRestrictedTreatment с COPPA API BidMachine.

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

• Google Mobile Ads SDK версии 25.4.0.
• Google Mobile Ads Next-Gen SDK версии 1.2.1.
• BidMachine SDK версии 3.7.1.

Версия 3.7.0.0

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

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

• Google Mobile Ads SDK версии 25.1.0.
• Google Mobile Ads Next-Gen SDK версии 1.1.0.
• BidMachine SDK версии 3.7.0.

Версия 3.6.1.0

• Добавлено свойство для создания адаптера с зависимостью GMA Next-Gen SDK.
• Подтверждена совместимость с BidMachine SDK версии 3.6.1.

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

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

Версия 3.5.1.2

• В адаптере BidMachine теперь используется AdPlacementConfig.

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

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

Версия 3.5.1.1

• Добавлена поддержка передачи параметра tagForUnderAgeOfConsent Google Mobile Ads SDK в BidMachine SDK.

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

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

Версия 3.5.1.0

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

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

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

Версия 3.5.0.0

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

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

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

Версия 3.4.0.1

• Удалены ссылки на уровне класса на объекты Context, чтобы устранить проблемы с утечкой памяти.
• Обновлен адаптер для поддержки запросов объявлений баннеров, размер которых близок к поддерживаемым форматам, вместо требования точного соответствия размера.

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

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

Версия 3.4.0.0

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

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

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

Версия 3.3.0.0

• Первый выпуск.

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

• Google Mobile Ads SDK версии 24.5.0.
• BidMachine SDK версии 3.3.0.