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

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

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

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

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

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

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

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

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

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

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

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

Размещения

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

Торги

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

Водопад

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

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

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

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

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

Добавить InMobi в компании

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Затем введите свое имя пользователя и нажмите кнопку «Сохранить» .

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите InMobi и включите опцию «Включить интеграцию с приложением» .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Настройте ставки InMobi

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите InMobi в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для InMobi.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

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

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» . Выберите мобильное приложение .

Прокрутите вниз и нажмите «Добавить партнера по доходности» .

Выберите компанию, созданную для InMobi в предыдущем разделе. Выберите Mobile SDK mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса .

Введите идентификатор аккаунта и идентификатор места размещения, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

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

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

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

Использование 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: Реализуйте настройки конфиденциальности в InMobi SDK

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

Чтобы соответствовать Политике Google в отношении согласия пользователей из ЕС , вы должны предоставить пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определённую информацию и получить их согласие на использование файлов cookie или других локальных хранилищ в случаях, предусмотренных законодательством, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эта политика отражает требования Директивы ЕС о конфиденциальности в электронном виде и Общего регламента по защите данных (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 из NSUserDefaults . Следуйте инструкциям в документации по законам США о конфиденциальности , чтобы задать строку конфиденциальности США в NSUserDefaults .

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

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

Интеграция SKAdNetwork

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

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

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

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

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

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

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

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

Адаптер 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 = GAMRequest()
let extras = GADInMobiExtras()
extras.ageGroup = kIMSDKAgeGroupBetween35And54
extras.areaCode = "12345"
request.registerAdNetworkExtras(extras)

Objective-C

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

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

Рендеринг рекламы

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

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

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

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

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

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

Коды ошибок

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

GADMAdapterInMobi
GADMediationAdapterInMobi

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

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