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

Выберите платформу: Android (бета-версия)Новый Android iOS Unity Flutter

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

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

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

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

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

2. Нативный формат рекламы находится в стадии альфа-тестирования. Все остальные поддерживаемые форматы рекламы находятся в стадии бета-тестирования. Обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.

Требования

  • Новейший Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 или выше
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Целевая версия iOS для развертывания — 13.0 или выше.
  • Рабочий проект Flutter, настроенный с использованием Google Mobile Ads Flutter Plugin . Подробности см. в разделе «Начало работы» .
  • Заполните руководство по началу медиации.

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

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

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

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

Панель источников

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

Диалог редактирования источника

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

Android

Создать размещение Android

iOS

Создать размещение iOS

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

Android

Информация о размещении Android

iOS

Информация о размещении iOS

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

Файл 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.

Настройте параметры медиации для вашего рекламного блока.

Android

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

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

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

Интеграция через pub.dev

Добавьте следующую зависимость с последними версиями BidMachine SDK и адаптера в файл pubspec.yaml вашего пакета:

dependencies:
  gma_mediation_bidmachine: ^1.3.0

Ручная интеграция

Загрузите последнюю версию плагина медиации Google Mobile Ads для BidMachine , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

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

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

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

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

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

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

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

Android

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

iOS

Интеграция SKAdNetwork

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

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

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

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

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

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

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

коды ошибок

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

Android 

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

iOS 

GADMediationAdapterBidMachine

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

Android

Код ошибки Домен Причина
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 данными объявления.

iOS

Код ошибки Домен Причина
101 com.google.mediation.bidmachine В конфигурации сервера отсутствует обязательный идентификатор издателя.
102 com.google.mediation.bidmachine Запрос на сбор сигналов для торгов не удался, поскольку параметры RTB не содержат формат объявления или указанный формат не поддерживается.
103 com.google.mediation.bidmachine Неверные настройки объявления для его загрузки.
104 com.google.mediation.bidmachine BidMachine SDK вернул небаннерное объявление в метод делегата BidMachineAdProtocol didLoadAd баннерного объявления. Такого никогда не должно происходить.
105 com.google.mediation.bidmachine Полноэкранная реклама не готова к показу.
106 com.google.mediation.bidmachine SDK Bid Machine вернул не нативное объявление в метод делегата BidMachineAdProtocol didLoadAd нативного объявления. Такого никогда не должно происходить.
107 com.google.mediation.bidmachine Не удалось загрузить один из источников изображений для нативной рекламы.

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

Версия 1.3.1 (в разработке)

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0