Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

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

Интеграция
Торги
Водопад	¹
Форматы
Приложение открыто
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный
Родной

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

Предварительные требования

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

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

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

Последняя версия GMA Next-Gen 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 в раздел «Компании»

Торги

Этот шаг не требуется для интеграции с системами торгов.

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

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

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

Торги

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите BidMachine и включите «Включить интеграцию с приложением» .

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

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

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

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

Нажмите «Готово» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, тип инвентаря — «Мобильное приложение» , и ваше мобильное приложение . Затем введите идентификатор источника и идентификатор размещения, полученные в предыдущем разделе.

Наконец, нажмите «Сохранить» .

Водопад

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

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

Select the company you created for BidMachine in the previous section. Choose Mobile SDK mediation as the Integration type , Android as the Platform , and Active as the Status .

Введите идентификатор размещения, полученный в предыдущем разделе, и значение CPM по умолчанию . Нажмите «Сохранить» .

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

Follow the steps in European regulations settings and US state regulations settings to add BidMachine to the European and US state regulations ad partners list in the Ad Manager UI.

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

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

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

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1")
    implementation("com.google.ads.mediation:bidmachine:3.7.1.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.3.1'
    implementation 'com.google.ads.mediation:bidmachine:3.7.1.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: Внедрите настройки конфиденциальности в 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.
Заголовок
Изображение
Тело
Икона
Призыв к действию
Звездный рейтинг
Магазин
Цена
Рекламодатель

коды ошибок

If the adapter fails to receive an ad from BidMachine, you can check the underlying error from the ad response using ResponseInfo.getAdSourceResponses() under the following classes:

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

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

Код ошибки	Домен	Причина
100	com.google.ads.mediation.bidmachine	Получен недействительный или пустой идентификатор размещения.
101	com.google.ads.mediation.bidmachine	Ошибка при сборе сигнала: конфигурация данных сигнала не найдена.
102	com.google.ads.mediation.bidmachine	В процессе сбора сигнала получен недопустимый формат объявления.
103	com.google.ads.mediation.bidmachine	Запрошенный размер объявления не удалось сопоставить с `bidmachine.BannerSize`
104	com.google.ads.mediation.bidmachine	Запрос на размещение объявления в BidMachine истек.
105	com.google.ads.mediation.bidmachine	Полноэкранная реклама не может быть показана.
106	com.google.ads.mediation.bidmachine	BidMachine SDK вернул функцию обратного вызова `onAdLoaded()` с `null` данными объявления.