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

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

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

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

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

Требования

  • Новейший SDK для мобильной рекламы Google
  • 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.

Зарегистрируйте аккаунт в InMobi.

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

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

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

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

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

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

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

Стажировки

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

Торги

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

Водопад

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

После создания рекламного места отобразятся его подробные сведения. Запишите идентификатор рекламного места (Placement ID), который будет использоваться для настройки рекламного блока в вашем Ad Manager.

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

Идентификатор вашей учетной записи 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 для Ad Manager .

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

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

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

Шаг 2: Настройте запрос InMobi в пользовательском интерфейсе Ad Manager.

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_inmobi: ^2.0.0

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

Интеграция SKAdNetwork

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в Ad Manager и включили тестовый режим в пользовательском интерфейсе InMobi.

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

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

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

Android

Разрешения

Для оптимальной производительности 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 из следующих разделов:

Android 

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

iOS 

GADMAdapterInMobi
GADMediationAdapterInMobi

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

Android

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

iOS

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

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

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

Версия 1.1.4

Версия 1.1.3

Версия 1.1.2

Версия 1.1.1

Версия 1.1.0

Версия 1.0.0