Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

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

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

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

Интеграция
Ставки
Водопад	¹
Форматы
Запуск приложения
Баннер
Межстраничное объявление
Бонус предоставлен
Межстраничное объявление с вознаграждением
Стандартное

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

Требования

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

Целевая версия iOS – 13.0 или более поздняя.

Последняя версия Google Mobile Ads 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 в список рекламных партнеров для GDPR и законов штатов США

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

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

Как использовать Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 3.6.0.0.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне введите следующий URL пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
```
В разделе Правило зависимостей выберите Ветвь.
В текстовом поле введите main.

Через CocoaPods

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

Настраиваемые вручную интеграции

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

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

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

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

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

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

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

Шаг 5. Добавьте обязательный код

Как реализовать SKAdNetwork

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

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

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

Зарегистрируйте тестовое устройство в AdMob.

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

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

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

Необязательные шаги

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

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

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

Поле	Объекты, всегда включаемые адаптером BidMachine
Заголовок
Изображение
Body
Значок
Призыв к действию
Star rating
Магазин
Цена
Рекламодатель

Коды ошибок

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

GADMediationAdapterBidMachine

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

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