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

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

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

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

¹ Интеграция назначения ставок находится на стадии открытого бета-тестирования.

² Поддерживается только для каскадной медиации.

Требования

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

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

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

Как только ваша учетная запись будет подтверждена, войдите в систему .

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

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

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

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

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

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

Размещения

После того как вы настроите свой инвентарь, система перенаправит вас к рабочему процессу создания места размещения.

Примечание. Если система не перенаправляет вас к рабочему процессу создания места размещения, выберите «Инвентаризация» > «Настройки инвентаря» . Затем найдите приложение или веб-сайт, для которого вы хотите создать место размещения. Нажмите Добавить место размещения .

Торги

Примечание. Обратитесь к своему менеджеру по работе с клиентами, чтобы получить доступ к настройке ставок на панели управления InMobi.

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

Водопад

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

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

Примечание. Идентификатор места размещения InMobi указан под названием места размещения.

Идентификатор аккаунта

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

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

Торги

Этот шаг не требуется для интеграции ставок.

Водопад

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

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

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

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

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

Примечание. Тестовый режим по умолчанию отключен для всех мест размещения. Однако тестовый режим можно включить для мест размещения во всех экземплярах приложения или только для указанных вами устройств.

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

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

Андроид

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

iOS

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

Добавлять InMobi в соответствии с GDPR и списком рекламных партнеров США.

Важно! Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС, GDPR, CPRA и платформы обмена сообщениями пользователей. Подробности см. в разделе Управление доступом пользователей к вашей учетной записи .

Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить InMobi в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе AdMob.

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

Примечание. Невозможность интеграции совместимых версий InMobi и Google Mobile Ads SDK может привести к проблемам при сборке.

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

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

dependencies:
  gma_mediation_inmobi: ^1.0.0

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

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

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

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

Согласие ЕС и GDPR

В соответствии с Политикой согласия пользователей 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. Проверьте свою реализацию

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

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

Важно: отключите тестовый режим для AdMob и InMobi перед выпуском приложения.

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

Чтобы убедиться, что вы получаете тестовые объявления от 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, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен.
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, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен.
102	Адаптер InMobi не поддерживает запрошенный формат объявления.
103	Для этой конфигурации сети реклама InMobi уже загружена.
Другой	InMobi SDK вернул ошибку. Дополнительную информацию см. в IMRequestStatus.h .

Журнал изменений адаптера InMobi Flutter Mediation

Следующая версия

• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.

1.1.0

• Подтверждена совместимость с адаптером InMobi Android версии 10.7.5.0.
• Проверенная совместимость с адаптером InMobi iOS версии 10.7.5.0.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.

1.0.0

• Первоначальный выпуск.
• Проверенная совместимость с адаптером InMobi Android версии 10.6.7.1.
• Подтверждена совместимость с адаптером InMobi iOS версии 10.7.2.0.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.