Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

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

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

Android iOS Unity Flutter

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

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

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

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

Требования

Целевая версия iOS для развертывания — 10.0 или выше.
[Для участия в торгах]: Для интеграции всех поддерживаемых форматов объявлений в систему торгов используйте адаптер InMobi версии 10.6.0.0 или выше ( рекомендуется последняя версия ).

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

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

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

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

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

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

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

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

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

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

Стажировки

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

Торги

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

Водопад

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

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

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

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

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

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

Водопад

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

Выберите InMobi и включите переключатель «Оптимизировать» . Введите имя пользователя и ключ API , полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для InMobi. Затем введите значение eCPM для InMobi и нажмите «Продолжить» .

Примечание : Оптимизация источника рекламы занимает несколько дней, чтобы собрать достаточно данных для точного расчета eCPM для сети медиации. В это время статус оптимизации источника рекламы — PENDING , поэтому вам необходимо вручную установить значение eCPM для сети. Как только eCPM будет рассчитан, источник рекламы автоматически начнет обновлять значение eCPM от вашего имени.

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

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

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

Используйте менеджер пакетов Swift.

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

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

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

Используйте CocoaPods

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

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

Загрузите последнюю версию InMobi iOS SDK и подключите файл InMobiSDK.framework к своему проекту.

Загрузите последнюю версию адаптера InMobi по ссылке для скачивания в списке изменений и подключите файл InMobiAdapter.framework к вашему проекту.
Добавьте следующие фреймворки в свой проект.
- libsqlite3.0.tbd
- libz.tbd
- WebKit.framework

Настройки проекта

Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» в меню «Целевая платформа приложения» > «Параметры сборки» .

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

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

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

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

Быстрый

import InMobiAdapter
// ...

var consentObject = Dictionary<String, String>()
consentObject["gdpr"] = "1"
consentObject[IM_GDPR_CONSENT_AVAILABLE] = "true"

GADMInMobiConsent.updateGDPRConsent(consentObject)

Objective-C

#import <InMobiAdapter/InMobiAdapter.h>
// ...

NSMutableDictionary *consentObject = [[NSMutableDictionary alloc] init];
[consentObject setObject:@"1" forKey:@"gdpr"];
[consentObject setObject:@"true" forKey:IM_GDPR_CONSENT_AVAILABLE];

[GADMInMobiConsent updateGDPRConsent:consentObject];

Для получения более подробной информации о возможных ключах и значениях, которые InMobi принимает в этом объекте согласия, см. подробности реализации GDPR в InMobi .

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

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

В версии 10.5.6.0 адаптер InMobi добавил поддержку чтения строки конфиденциальности IAB US из NSUserDefaults . Следуйте инструкциям в документации по законам о конфиденциальности штатов США, чтобы установить строку конфиденциальности США в NSUserDefaults .

Кроме того, ознакомьтесь с документацией InMobi по CCPA , где содержатся инструкции по включению настроек CCPA в панели управления InMobi.

Шаг 5: Требуется дополнительный код

Интеграция SKAdNetwork

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

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

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

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

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

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

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

Параметры, специфичные для сети

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

Запрос параметров и значений
`setAgeGroup` Возрастная группа пользователя.	`kIMSDKAgeGroupBelow18` `kIMSDKAgeGroupBetween18And24` `kIMSDKAgeGroupBetween25And29` `kIMSDKAgeGroupBetween30And34` `kIMSDKAgeGroupBetween35And44` `kIMSDKAgeGroupBetween45And54` `kIMSDKAgeGroupBetween55And64` `kIMSDKAgeGroupAbove65`
`setEducationType` Уровень образования пользователя.	`kIMSDKEducationHighSchoolOrLess` `kIMSDKEducationCollegeOrGraduate` `kIMSDKEducationPostGraduateOrAbove`
`setLogLevel`	`kIMSDKLogLevelNone` `kIMSDKLogLevelError` `kIMSDKLogLevelDebug`
`setAge`	Целое число. Возраст пользователя.
`setYearOfbirth`	Целое число. Год рождения пользователя.
`setPostalCode`	Строка . Почтовый индекс пользователя. Обычно пятизначное число.
`setAreaCode`	Строка . Телефонный код города пользователя (часть телефонного номера).
`setLanguage`	Строка . Родной язык пользователя (если известен).
`setLoginId`	Строка . Идентификатор входа в систему в домене издателя.
`setSessionId`	Строка . Идентификатор сессии в домене издателя.
`setLocationWithCityStateCountry`	Строка . Местоположение с указанием города, штата и страны в качестве параметров.
`setKeywords`	Строка . Любые контекстно релевантные ключевые слова, которые будут переданы в запросе объявления.
`setInterests`	Строка . Любые контекстно релевантные строки, которые будут переданы в запросе на показ рекламы.
`setAdditionalParameters`	Словарь . Любые дополнительные значения, которые необходимо передать в запросе объявления.

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

Быстрый

let request = GADRequest()
let extras = GADInMobiExtras()
extras.ageGroup = kIMSDKAgeGroupBetween35And54
extras.areaCode = "12345"
request.registerAdNetworkExtras(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADInMobiExtras *extras = [[GADInMobiExtras alloc] init];
extras.ageGroup = kIMSDKAgeGroupBetween35And54;
extras.areaCode = @"12345";
[request registerAdNetworkExtras:extras];

Использование нативной рекламы

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

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

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

^1. Адаптер InMobi не предоставляет прямого доступа к основному графическому ресурсу для своей нативной рекламы. Вместо этого адаптер заполняет GADMediaView видео или изображением.

Отслеживание показов и кликов

Клики отслеживаются SDK Google Mobile Ads и передаются в InMobi, поэтому отчеты о кликах будут синхронизированы.

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

коды ошибок

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

GADMAdapterInMobi
GADMediationAdapterInMobi

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

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