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

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

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

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из InMobi с помощью AdMob Mediation , охватывая интеграцию каскадной модели и назначения ставок. В нём также рассказывается, как добавить 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 и «Партнер» соответственно, а затем заполните оставшуюся часть формы. После завершения нажмите «Создать плейсмент-место» .

Водопад

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

После создания места размещения отобразятся его данные. Запишите идентификатор места размещения, который будет использоваться для настройки вашего рекламного блока 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: Импортируйте 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: Проверьте свою реализацию

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления от 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 = 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
Медиа-просмотр
Тело
Значок приложения
Призыв к действию
Звездный рейтинг
Магазин
Цена

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

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

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

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

Коды ошибок

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

GADMAdapterInMobi
GADMediationAdapterInMobi

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

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