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

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

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

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

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

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

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

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

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

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

Требования

Целевая версия iOS для развертывания — 13.0 или выше.

Новейший Google Mobile Ads SDK
Заполните руководство по началу медиации.

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

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

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

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

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

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

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

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

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

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

Подробности размещения

Обновите файл 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.

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

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

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас уже есть группа медиации, которую вы хотите изменить, щелкните по ее названию, чтобы отредактировать ее, и перейдите к разделу «Добавить BidMachine в качестве источника рекламы» .

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

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте BidMachine в качестве источника рекламы.

Торги

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите BidMachine .

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

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

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

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

Водопад

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Выберите BidMachine . Затем введите значение eCPM для BidMachine и нажмите «Продолжить» .

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

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

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

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

CocoaPods (рекомендуется)

Добавьте следующую строку в файл Podfile вашего проекта:
```
pod 'GoogleMobileAdsMediationBidMachine'
```
В командной строке выполните:
```
pod install --repo-update
```

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

Загрузите последнюю версию BidMachine SDK для iOS и подключите все файлы .xcframework и пакеты в свой проект.
Загрузите последнюю версию адаптера BidMachine по ссылке для скачивания в журнале изменений и подключите файл BidMachineAdapter.xcframework к вашему проекту.

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

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

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

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

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

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

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

Интеграция SKAdNetwork

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

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

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

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

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

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

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

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

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

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

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

Поле	Активы всегда включаются адаптером BidMachine.
Заголовок
Изображение
Тело
Икона
Призыв к действию
Звездный рейтинг
Магазин
Цена
Рекламодатель

коды ошибок

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

GADMediationAdapterBidMachine

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

Код ошибки	Домен	Причина
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 iOS Mediation