Интегрируйте рекламную сеть LINE с медиацией

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

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

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

Адаптер медиации для LINE Ads Network имеет следующие возможности:

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

1 Интеграция торгов находится на стадии закрытого бета-тестирования. Обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.

Требования

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

Шаг 1: Настройте конфигурации в пользовательском интерфейсе LINE Ads Network

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

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

Нажмите広告枠管理 (Управление рекламными местами) >メディア (Медиа) . Затем нажмите新規作成 (Создать новый) .

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

Запишите идентификатор приложения.

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

Нажмите на идентификатор приложения, для которого вы хотите добавить рекламное место. Затем выберите «Подробнее» (詳細) .

Нажмитеスロット 追加 (Добавить слот) .

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

Запишите идентификатор слота .

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

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

Чтобы реализовать app-ads.txt для рекламной сети LINE, см. раздел «О файле app-ads.txt» .

Шаг 2: Настройте спрос на рекламную сеть LINE в пользовательском интерфейсе AdMob

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

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

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

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

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

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

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

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

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

Торги

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите рекламную сеть LINE .

Нажмите «Как подписать соглашение о партнерстве» и настроить партнерство по торгам с LINE Ads Network.



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



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



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



Водопад


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

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



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

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


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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:line:2.9.20250519.0")
}

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

  1. Загрузите последнюю версию файла .aar LINE Ads Network SDK и добавьте его в свой проект.

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

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

Для интеграции LINE Ads Network дополнительный код не требуется.

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob.

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

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

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

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

Адаптер LINE Ads Network поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса LineExtras . Этот конструктор класса включает следующие параметры:

enableAdSound
boolean , определяющее начальное состояние звука по умолчанию для баннеров, полноэкранной рекламы и рекламы с вознаграждением.

Вот пример кода, как создать запрос объявления, который задает эти параметры:

Ява

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

Котлин

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

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

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

Адаптер LINE Ads Network заполняет следующие расширенные описания полей нативной рекламы для NativeAd .

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

1 Для нативной рекламы LINE Ads Network SDK не предоставляет ресурс значка приложения. Вместо этого адаптер LINE Ads Network заполняет значок приложения прозрачным изображением.

Коды ошибок

Если адаптеру не удается получить рекламу от LINE Ads Network, вы можете проверить основную ошибку в ответе на рекламу с помощью ResponseInfo.getAdapterResponses() в следующих классах:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

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

Код ошибки Домен Причина
1-10 com.five_corp.ad LINE Ads Network SDK вернул ошибку, специфичную для SDK. Подробнее см. в документации LINE Ads Network.
101 com.google.ads.mediation.line Отсутствует или недействителен идентификатор приложения.
102 com.google.ads.mediation.line Отсутствует или недействителен идентификатор слота.
103 com.google.ads.mediation.line Запрошенный размер объявления не соответствует поддерживаемому размеру баннерной рекламы LINE Ads Network.
104 com.google.ads.mediation.line Не удалось загрузить промежуточную или вознагражденную рекламу из-за отсутствия контекста активности.
105 com.google.ads.mediation.line LINE Ads Network SDK не смог отобразить промежуточную или вознагражденную рекламу.
106 com.google.ads.mediation.line Не удалось загрузить нативное объявление из-за отсутствия ресурсов.

Журнал изменений адаптера-медиатора Android LINE

Версия 2.9.20250718.0 (В разработке)

Версия 2.9.20250519.0

  • Проверенная совместимость с FiveAd SDK версии 2.9.20250519.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.3.0.
  • FiveAd SDK версии 2.9.20250519.0.

Версия 2.9.20250317.1

  • Исправлены размеры загрузки баннера для объявлений с торгами с помощью нового API FiveAd

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.1.0.
  • FiveAd SDK версии 2.9.20250317.0

Версия 2.9.20250317.0

  • Проверенная совместимость с FiveAd SDK версии 2.9.20250317.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.1.0.
  • FiveAd SDK версии 2.9.20250317.0

Версия 2.9.20250110.1

  • Минимально требуемый уровень API Android обновлен до 23.
  • Обновлена минимально требуемая версия Google Mobile Ads SDK до 24.0.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 24.0.0.
  • FiveAd SDK версии 2.9.20250110.0

Версия 2.9.20250110.0

  • Удален устаревший класс UnifiedNativeAdMapper в пользу NativeAdMapper
  • Исправлен процесс сбора сигналов.
  • Исправлен процесс инициализации для каскадных форматов полноэкранной и вознагражденной рекламы.
  • Проверенная совместимость с FiveAd SDK версии 2.9.20250110.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.6.0.
  • FiveAd SDK версии 2.9.20250110.0

Версия 2.9.20241129.0

  • Добавлена поддержка ставок для форматов баннерной, полноэкранной, вознагражденной и нативной рекламы.
  • Проверенная совместимость с FiveAd SDK версии 2.9.20241129.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.5.0.
  • FiveAd SDK версии 2.9.20241129.0

Версия 2.8.20240827.0

  • Проверенная совместимость с FiveAd SDK версии 2.8.20240827.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.3.0.
  • FiveAd SDK версии 2.8.20240827.0

Версия 2.8.20240808.0

  • Проверенная совместимость с FiveAd SDK версии 2.8.20240808.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.2.0.
  • FiveAd SDK версии 2.8.20240808.0

Версия 2.8.20240722.0

  • Проверенная совместимость с FiveAd SDK версии 2.8.20240722.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.2.0.
  • FiveAd SDK версии 2.8.20240722.0

Версия 2.7.20240515.0

  • Проверенная совместимость с FiveAd SDK версии 2.7.20240515.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.1.0.
  • FiveAd SDK версии 2.7.20240515.0

Версия 2.7.20240214.1

  • Обновлена минимально требуемая версия Google Mobile Ads SDK до 23.0.0.
  • Проверенная совместимость с FiveAd SDK версии 2.7.20240214.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 23.0.0.
  • FiveAd SDK версии 2.7.20240214.0.

Версия 2.7.20240214.0

  • Проверенная совместимость с FiveAd SDK версии 2.7.20240214.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 22.6.0.
  • FiveAd SDK версии 2.7.20240214.0.

Версия 2.7.20240126.0

  • Проверенная совместимость с FiveAd SDK версии 2.7.20240126.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 22.6.0.
  • FiveAd SDK версии 2.7.20240126.0.

Версия 2.7.20240112.0

  • Удален устаревший FiveAdViewEventListener в пользу FiveAdCustomLayoutEventListener , FiveAdVideoRewardEventListener , FiveAdInterstitialEventListener и FiveAdNativeEventListener .
  • Проверенная совместимость с FiveAd SDK версии 2.7.20240112.
  • Обновлена минимально требуемая версия Google Mobile Ads SDK до 22.6.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 22.6.0.
  • FiveAd SDK версии 2.7.20240112.

Версия 2.6.20230607.1

  • Добавлен класс LineExtras , позволяющий издателям определять настройки звука по умолчанию для форматов баннеров, полноэкранной рекламы и рекламы с вознаграждением.
  • Обновлена минимально требуемая версия Google Mobile Ads SDK до 22.4.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 22.4.0.
  • FiveAd SDK версии 2.6.20230607.

Версия 2.6.20230607.0

  • Первоначальный выпуск.
  • Добавляет поддержку форматов баннерной, полноэкранной, вознагражденной и нативной рекламы.
  • Проверенная совместимость с FiveAd SDK версии 2.6.20230607.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 22.1.0.
  • FiveAd SDK версии 2.6.20230607.