Эта страница переведена с помощью 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.

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

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

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

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

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

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

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

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

Размещения

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

Торги

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

Водопад

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

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

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

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

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

Торги

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

Водопад

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

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

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

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

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

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

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

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

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

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

Введите формат объявления и платформу, затем нажмите «Продолжить» .

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

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

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

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

Торги

В карточке «Ставки» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите InMobi (SDK) .
Нажмите «Как подписать партнерское соглашение и организовать тендерное партнерство с InMobi».

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

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

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

Водопад

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

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

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

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

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

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

Использование CocoaPods (рекомендуется)

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

Цель-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 принимает в этом объекте согласия, см. в деталях реализации InMobi GDPR .

Законы о конфиденциальности штатов США

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

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

Кроме того, см. документацию InMobi CCPA , где приведены рекомендации по включению настроек 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)

Цель-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` .