Интеграция BidMachine с посредничеством

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

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

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

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

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

Требования

• Android API уровня 23 или выше

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

• Новейший Google Mobile Ads SDK

• Заполните руководство по началу медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе BidMachine.

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

Создать новые вакансии

Перейдите на вкладку «Источники» и в таблице «Источники» выберите кнопку «Редактировать» .

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

Заполните форму и нажмите «Сохранить» .

Наконец, обратите внимание на идентификатор места размещения (Placement ID) .

Обновите файл app-ads.txt.

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

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

Шаг 2: Настройте параметры BidMachine в пользовательском интерфейсе Ad Manager.

Войдите в свой аккаунт в Ad Manager .

Добавить BidMachin в раздел «Компании»

Включить безопасный обмен сигналами

Передайте защищенный сигнал в запросах на участие в торгах.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Настройка системы торгов BidMachine

Настройка сопоставления рекламных блоков

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

Чтобы добавить BidMachine в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований .

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.3.0")
    implementation("com.google.ads.mediation:bidmachine:3.7.0.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:bidmachine:3.7.0.0'
}

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

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

BidMachine автоматически считывает согласия, установленные в соответствии с GDPR платформами управления согласиями, включая UMP SDK . Для получения дополнительной информации см. GDPR .

Законы штатов США о защите частной жизни

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

BidMachine автоматически считывает настройки согласия GPP, заданные платформами управления согласием, включая UMP SDK . Для получения дополнительной информации см. GPP .

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

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

Шаг 6: Протестируйте свою реализацию.

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

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

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

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

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

Дополнительные шаги

Нативная реклама

Отображение рекламы

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

коды ошибок

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

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

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

Список изменений адаптера BidMachine Android Mediation

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

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

Версия 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.
• Версия SDK BidMachine: 3.7.0.

Версия 3.6.1.0

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

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

• Версия Google Mobile Ads SDK: 25.1.0.
• Версия SDK BidMachine: 3.6.1.

Версия 3.5.1.2

• Обновлен адаптер BidMachine для использования AdPlacementConfig.

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

• Версия Google Mobile Ads SDK: 24.9.0.
• Версия SDK BidMachine: 3.5.1.

Версия 3.5.1.1

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

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

• Версия Google Mobile Ads SDK: 24.9.0.
• Версия SDK BidMachine: 3.5.1.

Версия 3.5.1.0

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

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

• Версия Google Mobile Ads SDK: 24.9.0.
• Версия SDK BidMachine: 3.5.1.

Версия 3.5.0.0

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

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

• Версия Google Mobile Ads SDK: 24.7.0.
• Версия SDK BidMachine: 3.5.0.

Версия 3.4.0.1

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

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

• Версия Google Mobile Ads SDK: 24.7.0.
• Версия SDK BidMachine: 3.4.0

Версия 3.4.0.0

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

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

• Версия Google Mobile Ads SDK: 24.6.0.
• Версия SDK BidMachine: 3.4.0.

Версия 3.3.0.0

• Первый релиз.

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

• Версия Google Mobile Ads SDK: 24.5.0.
• Версия SDK BidMachine: 3.3.0.