Интегрируйте InMobi с медиацией

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

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

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

1 Поддерживается только для каскадной модели посредничества.

Требования

  • Последняя версия Google Mobile Ads SDK
  • Flutter 3.7.0 или выше
  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы объявлений в торги, используйте плагин медиации Google Mobile Ads для InMobi 4.5.0 или выше ( рекомендуется последняя версия ).
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 10.0 или выше
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
  • Завершить посредничество . Руководство по началу работы.

Шаг 1: Настройте конфигурации в InMobi UI

Зарегистрируйте учётную запись InMobi. При создании учётной записи не устанавливайте флажок «Использовать InMobi SSP с Google Open Bidding» .

После подтверждения вашей учетной записи войдите в систему .

Добавить приложение

Чтобы добавить свое приложение на панель управления InMobi, нажмите Инвентарь > Настройки инвентаря .

Нажмите «Добавить инвентарь» и выберите канал мобильного приложения из раскрывающегося меню.

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

Если ваше приложение ещё не опубликовано, нажмите «Связать вручную» и введите необходимые данные. Нажмите «Продолжить» .

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

Размещения

После настройки инвентаря система перенаправит вас к процессу создания места размещения.

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

После создания места размещения отобразятся его подробные данные. Запишите идентификатор места размещения, который будет использоваться для настройки вашего рекламного блока в Менеджере рекламы.

Идентификатор учетной записи

Идентификатор вашего аккаунта InMobi доступен в разделе «Финансы» > «Настройки платежей» > «Информация о платежах» .

Найдите ключ API для отчетов InMobi

Перейдите в раздел «Моя учётная запись» > «Настройки учётной записи» . Перейдите на вкладку «Ключ API» и нажмите «Сгенерировать ключ API» .

Выберите адрес электронной почты пользователя, для которого требуется ключ, и нажмите «Сгенерировать ключ API» . Будет сгенерирован файл, содержащий ключ API и имя пользователя/логин.

Только администратор аккаунта издателя сможет сгенерировать ключ API для всех пользователей. Если вы забыли ранее сгенерированный ключ API, сбросьте его, наведя курсор на свой адрес электронной почты на вкладке «Ключ API» .

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

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

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

Включить тестовый режим

Включите тестовый режим для вашего места размещения на всех показах в реальном времени или только на определенных тестовых устройствах.

Шаг 2: Настройте спрос InMobi в пользовательском интерфейсе Менеджера рекламы

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

Андроид

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

iOS

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

Добавьте InMobi в список рекламных партнеров, соответствующих GDPR и государственным нормам США

Следуйте инструкциям в настройках европейских и государственных нормативных актов США, чтобы добавить InMobi в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе Менеджера рекламы.

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

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

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

dependencies:
  gma_mediation_inmobi: ^

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

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

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

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

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

Плагин медиации Google Mobile Ads для InMobi не поддерживает передачу информации о согласии в InMobi SDK.

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

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

Плагин медиации Google Mobile Ads для InMobi не поддерживает передачу информации о согласии в InMobi SDK.

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

Андроид

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

iOS

Интеграция SKAdNetwork

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в InMobi UI.

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

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

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

Андроид

Разрешения

Для оптимальной производительности InMobi рекомендует добавить следующие необязательные разрешения в файл AndroidManifest.xml вашего приложения.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

При желании вы можете добавить эти разрешения в файл Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml .

iOS

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

Коды ошибок

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

Андроид 

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

iOS 

GADMAdapterInMobi
GADMediationAdapterInMobi

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

Андроид

Код ошибки Причина
0-99 Ошибки InMobi SDK. Подробнее см. в коде .
100 Параметры сервера InMobi, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют или недействительны.
101 Не удалось инициализировать InMobi SDK.
102 Запрошенный размер объявления не соответствует поддерживаемому размеру баннера InMobi.
103 Запрос рекламы не является унифицированным запросом нативной рекламы.
104 Попытка запросить рекламу InMobi без инициализации InMobi SDK. Теоретически этого не должно происходить, поскольку адаптер инициализирует InMobi SDK до запроса рекламы InMobi.
105 Реклама InMobi еще не готова к показу.
106 InMobi не удалось отобразить рекламу.
107 InMobi вернул нативное объявление, в котором отсутствует требуемый актив.
108 В исходных рекламных изображениях InMobi содержится неверный URL-адрес.
109 Адаптеру не удалось загрузить собственные рекламные изображения InMobi.

iOS

Код ошибки Причина
101 Параметры сервера InMobi, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют или недействительны.
102 Адаптер InMobi не поддерживает запрашиваемый формат рекламы.
103 Реклама InMobi уже загружена для этой конфигурации сети.
Другой InMobi SDK вернул ошибку. Подробнее см. в IMRequestStatus.h .

Журнал изменений адаптера-посредника Flutter InMobi

Версия 1.1.1

Версия 1.1.0

Версия 1.0.0