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

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

Интегрируйте i-mobile с медиацией

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

Android iOS Unity Flutter

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

В интерфейсе панели управления i-mobile для надписей, кнопок и описаний используется японский текст. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства надписи и кнопки переведены, а их английские эквиваленты указаны в скобках.

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

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

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

Требования

Целевая версия iOS для развертывания — 12.0 или выше.

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

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

Зарегистрируйтесь или войдите в свою учетную запись i-mobile.

Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト／アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.

Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .

Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .

Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .

create_ad_spot

Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .

новая_рекламная_форма

Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .

список рекламных мест

Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов рекламы в приложениях , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для своего приложения .

Чтобы внедрить app-ads.txt в i-mobile, ознакомьтесь с разделом часто задаваемых вопросов .

Шаг 2: Настройте запрос i-mobile в пользовательском интерфейсе AdMob.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Загрузите последнюю версию i-mobile SDK и подключите файл ImobileSdkAds.framework к своему проекту.
Загрузите последнюю версию адаптера i-mobile по ссылке для скачивания в Changelog и подключите файл IMobileAdapter.framework к вашему проекту.

Шаг 4: Добавьте необходимый код

Интеграция SKAdNetwork

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob. i-mobile предоставляет тестовые идентификаторы Spot ID , Media ID и Publisher ID для тестирования, вы можете найти их здесь .

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

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

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

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

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

Адаптер i-mobile заполняет следующие расширенные поля описания нативных объявлений для GADNativeAd .

Поле	Все ресурсы всегда включены в адаптер i-mobile.
Заголовок
Изображение
Тело
значок приложения	¹
Призыв к действию
Звездный рейтинг
Магазин
Цена

^1. Для нативной рекламы SDK i-mobile не предоставляет значок приложения. Вместо этого адаптер i-mobile заполняет значок приложения прозрачным изображением.

коды ошибок

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

Формат	Название класса
Баннер	IMobileAdapter
Интерстициальный	IMobileAdapter
Родной	GADMediationAdapterIMobile

Вот коды ошибок и соответствующие сообщения, которые выдает адаптер i-mobile, когда реклама не загружается:

Код ошибки	Причина
0-10	SDK i-mobile вернул ошибку. Подробности см. в коде .
101	Параметры сервера iMob, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
102	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile.
103	i-mobile не удалось показать рекламу.
104	i-mobile вернул пустой массив нативных рекламных объявлений.
105	i-mobile не удалось загрузить рекламные материалы.
106	i-mobile не поддерживает запрос на показ нескольких межстраничных объявлений с использованием одного и того же идентификатора Spot ID.