Интеграция nend с посредничеством

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

В интерфейсе информационной панели nend для меток, кнопок и описаний используется текст на японском языке, а снимки экрана, представленные ниже, не были переведены. В этом руководстве метки и кнопки обозначаются английскими эквивалентами. Например, «URL スキーム» — это «Схема URL» и так далее.

Поддерживаемые интеграции и форматы объявлений

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

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

Требования

  • Android API уровня 21 или выше

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

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

Чтобы добавить свое приложение на панель мониторинга nend, сначала нажмите вкладку «Управление размещением» , а затем выберите «Сайт/Приложение» . Нажмите кнопку «Добавить приложение» , чтобы добавить свое приложение в nend.

Создать заявку

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

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

Ваше приложение будет отображаться на панели управления после его создания.

Создать место размещения

После регистрации приложения можно переходить к созданию места размещения. Чтобы создать место размещения для баннерной рекламы, перейдите на вкладку «Управление местами размещения» и нажмите « Размещение» . Затем нажмите кнопку «Создать новое место размещения» .

Выберите свое приложение в раскрывающемся меню. Затем следуйте приведенным ниже инструкциям, соответствующим предпочитаемому вами формату объявления.

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

Межстраничный

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

Для межстраничных видеообъявлений выберите «Видео» в качестве типа объявления и «Межстраничное» в качестве типа инвентаря . После этого введите «Название места размещения» , заполните «Введение в инвентарь » и выберите подходящую категорию из раскрывающегося списка. По завершении нажмите кнопку «Создать» , чтобы создать место размещения.

Награжден

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

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

Родной

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

Для нативной видеорекламы выберите «Видео» в качестве типа объявления и «Нативная (индивидуальная)» в качестве типа инвентаря . После этого введите «Название места размещения» , заполните «Введение в инвентарь » и выберите подходящую категорию из раскрывающегося списка.

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

Чтобы настроить рекламный блок Ad Manager в следующем разделе, вам понадобятся APIKey и SpotID для каждого места размещения. Чтобы найти их, перейдите на вкладку «Управление размещением » и нажмите кнопку SDK под названием вашего приложения.

Обратите внимание на apiKey и SpotID .

Вам также понадобится ваш ключ API для API отчетов nend, который они называют ключом API для парсинга . Вы можете найти его во вкладке «Инструменты» .

Шаг 2. Настройте запрос nend в пользовательском интерфейсе Ad Manager

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

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

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

Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря «Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.

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

Если у вас уже есть партнер по доходности дляnend, вы можете выбрать его. В противном случае выберите Создать нового партнера по доходности .

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

Включите Автоматический сбор данных и введитеReporting API Key from the API Key for Scrapingполученный в предыдущем разделе.

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Активный в качестве статуса . ВведитеSlot ID and API Key полученный в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Когда закончите, нажмите «Сохранить» внизу страницы.

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

В файле settings.gradle.kts уровня проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

Затем в файл build.gradle.kts уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии nend SDK и адаптера:

l10n
dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.1")
}

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

  1. Загрузите последнюю версию nend Android SDK и добавьте ее в свой проект.

  2. Перейдите к артефактам адаптера nend в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера nend и добавьте его в свой проект.

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

Для интеграции nend не требуется никакого дополнительного кода.

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager.Чтобы получить тестовые объявления для баннеров, межстраничных объявлений и вознаграждений, nend рекомендует использовать ключи API и идентификаторы спотов, указанные на странице nend тестовых рекламных блоков . Их можно ввести в качестве ключей API и идентификаторов спотов для ваших рекламных блоков AdMob во время тестирования, а затем заменить их фактическим ключом API и идентификатором спота, когда ваше приложение будет готово к выпуску.

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

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

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

Сетевые параметры

Адаптер nend поддерживает дополнительные параметры запроса, которые можно передать адаптеру с помощью класса NendExtrasBundleBuilder . Этот класс включает в себя следующие методы:

  • setInterstitialType(InterstitialType) : Nend предоставляет возможность выбора либо TYPE_NORMAL для обычных межстраничных объявлений, либо TYPE_VIDEO для межстраничных видеообъявлений. Nend по умолчанию использует TYPE_NORMAL в качестве промежуточного типа, если этот дополнительный параметр не добавлен.

  • setNativeAdsType(nativeAdsType) : Nend предоставляет возможность выбора либо TYPE_NORMAL для обычной нативной рекламы, либо TYPE_VIDEO для нативной видеорекламы. Если этот дополнительный параметр не добавлен, Nend по умолчанию использует TYPE_NORMAL в качестве типа собственного объявления.

Джава

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

Котлин

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

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

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

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

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

1 Nend предоставляет ресурс изображения только для собственных мест размещения , в которых для параметра «Изображение объявления» установлено значение «Горизонтальное (5:3) большое рекламное изображение» .

2 Nend не предоставляет ресурс «Значок» для собственных мест размещения , в которых для параметра «Изображение объявления» установлено значение «Без изображения» (только текст) .

Коды ошибок

Если адаптеру не удается получить объявление от nend, издатели могут проверить основную ошибку из ответа на объявление, используяResponseInfo.getAdapterResponse() в следующих классах:

Формат Имя класса
Баннер com.google.ads.mediation.nend.NendAdapter
Межстраничный com.google.ads.mediation.nend.NendAdapter
Награжден com.google.ads.mediation.nend.NendRewardedAdapter
Родной com.google.ads.mediation.nend.NendMediationAdapter

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

Код ошибки Домен Причина
101 com.google.ads.mediation.nend nend требует контекста активности для загрузки и показа рекламы.
102 com.google.ads.mediation.nend Параметры сервера nend, настроенные в пользовательском интерфейсе Ad Manager отсутствуют/недействительны.
103 com.google.ads.mediation.nend Объявление nend еще не готово к показу.
104 com.google.ads.mediation.nend nend не смог воспроизвести рекламу.
105 com.google.ads.mediation.nend Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому nend.
106 com.google.ads.mediation.nend Ссылка на объект Context имеет null и/или была недавно освобождена из памяти.
200-299 net.nend.android nend SDK возвратил ошибку загрузки межстраничного объявления. См. код для более подробной информации.
300-399 net.nend.android nend SDK возвратил ошибку межстраничного показа объявления. См. код для более подробной информации.
400-499 net.nend.android nend SDK возвратил ошибку объявления. См. код для более подробной информации.

Список изменений адаптера-посредника nend Android

Версия 10.0.0.1

  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 23.0.0.
  • Проверена совместимость с nend SDK 10.0.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 23.0.0.
  • Nend SDK версии 10.0.0.

Версия 10.0.0.0

  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 22.3.0.
  • Проверена совместимость с nend SDK 10.0.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 22.3.0.
  • Nend SDK версии 10.0.0.

Версия 9.0.1.0

  • Обновлен адаптер для использования нового класса VersionInfo .
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 22.0.0.
  • Проверена совместимость с nend SDK 9.0.1.

Создан и протестирован с

  • Google Mobile Ads SDK версии 22.0.0.
  • Nend SDK версии 9.0.1.

Версия 9.0.0.0

  • Проверена совместимость с nend SDK 9.0.0.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.2.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 21.2.0.
  • Nend SDK версии 9.0.0.

Версия 8.2.0.0

  • Проверена совместимость с nend SDK 8.2.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 21.0.0.
  • Nend SDK версии 8.2.0.

Версия 8.1.0.1

  • compileSdkVersion и targetSdkVersion обновлены до API 31.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.0.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 21.0.0.
  • Nend SDK версии 8.1.0.

Версия 8.1.0.0

  • Проверена совместимость с nend SDK 8.1.0.
  • Исправлен сбой NullPointerException , когда nend возвращает null изображение объявления или URL-адрес логотипа.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.5.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 20.5.0.
  • Nend SDK версии 8.1.0.

Версия 8.0.1.0

  • Проверена совместимость с nend SDK 8.0.1.
  • Исправлена ​​ошибка, из-за которой некоторые объекты AdError возвращались с использованием неправильного домена.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.4.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 20.4.0.
  • Nend SDK версии 8.0.1.

Версия 7.1.0.0

  • Проверена совместимость с nend SDK 7.1.0.
  • Обновлены коды ошибок для регистрации ошибки nend UNSUPPORTED_DEVICE .
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.2.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 20.2.0.
  • Nend SDK версии 7.1.0.

Версия 7.0.3.0

  • Проверена совместимость с nend SDK 7.0.3.
  • Добавлены описательные коды ошибок и причины сбоев загрузки/отображения адаптера.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.0.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 20.0.0.
  • Nend SDK версии 7.0.3.

Версия 7.0.0.0

  • Проверена совместимость с nend SDK 7.0.0.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.4.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 19.4.0.
  • Nend SDK версии 7.0.0.

Версия 6.0.1.0

  • Проверена совместимость с nend SDK 6.0.1.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.3.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 19.3.0.
  • Nend SDK версии 6.0.1.

Версия 6.0.0.0

  • Проверена совместимость с nend SDK 6.0.0.
  • Минимальная версия Android SDK обновлена ​​до API 19.

Создан и протестирован с

  • Google Mobile Ads SDK версии 19.2.0.
  • Nend SDK версии 6.0.0.

Версия 5.4.2.1

  • Обновлен адаптер для поддержки запросов встроенных адаптивных баннеров.
  • Исправлен редкий сбой в условиях гонки, который мог произойти при уничтожении смарт-баннеров.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.2.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 19.2.0.
  • Nend SDK версии 5.4.2.

Версия 5.4.2.0

  • Добавлена ​​поддержка нативной рекламы.
  • Проверена совместимость с nend SDK 5.4.2.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.0.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 19.0.0.
  • Nend SDK версии 5.4.2.

Версия 5.3.0.0

  • Проверена совместимость с nend SDK 5.3.0.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.2.0.

Создан и протестирован с

  • Google Mobile Ads SDK версии 18.2.0.
  • Nend SDK версии 5.3.0.

Версия 5.2.0.0

  • Проверена совместимость с nend SDK 5.2.0.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.1.1.

Версия 5.1.0.4

  • Исправлена ​​проблема, из-за которой баннерные и межстраничные объявления не пересылали событие onAdClicked() .
  • Исправлена ​​проблема, из-за которой возникало NullPointerException при уничтожении рекламного баннера nend.
  • Перенес адаптер на AndroidX.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.0.0.

Версия 5.1.0.3

  • Добавлена ​​реализация отображения части баннера nend в SmartBanner. Подходящий размер для SmartBanner
    • Портрет и Пейзаж
      • Телефоны: 320×50
      • Таблетки: 728×90 или 320×50.

Версия 5.1.0.2

  • Добавлена ​​поддержка гибких размеров баннерной рекламы.

Версия 5.1.0.1

  • Обновлен адаптер для поддержки нового API Rewarded открытой бета-версии.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 17.2.0.

Версия 5.1.0.0

  • Проверена совместимость с nend SDK 5.1.0.

Версия 5.0.2.1

  • Удалена функция, перенаправляющая функции пользователя, поскольку следующие методы в AdRequest.Builder устарели.
    • setGender()
    • setBirthday()
    • setIsDesignedForFamiles()

Версия 5.0.2.0

  • Проверена совместимость с nend SDK 5.0.2.

Версия 5.0.1.0

  • Проверена совместимость с nend SDK 5.0.1.

Версия 5.0.0.0

  • Проверена совместимость с nend SDK 5.0.0.

Версия 4.0.5.0

  • Проверена совместимость с nend SDK 4.0.5.

Версия 4.0.4.1

  • Поддерживается метод onRewardedVideoCompleted() для RewardedVideoAdListener.

Версия 4.0.4.0

  • Проверена совместимость с nend SDK 4.0.4.

Версия 4.0.2.1

  • Добавлена ​​возможность создать Bundle дополнений медиации с помощью класса NendExtrasBundleBuilder .

Версия 4.0.2.0

  • Первый выпуск проекта с открытым исходным кодом Google Mobile Ads Mediation.
  • Добавлена ​​поддержка баннеров, межстраничных объявлений и видеообъявлений с вознаграждением.