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

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

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

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

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

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

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

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

Требования

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

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

Зарегистрируйтесь и войдите в свой аккаунт в рекламной сети LINE.

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

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

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

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

Создать рекламное место

Щёлкните по идентификатору приложения, в которое хотите добавить рекламное место. Затем выберите «Подробности» .

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

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

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

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

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

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

Шаг 2: Настройте параметры рекламной сети LINE в пользовательском интерфейсе менеджера рекламы.

Войдите в свой аккаунт в Ad Manager .

Добавить рекламную сеть LINE в раздел «Компании».

Торги

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

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Выберите рекламную сеть LINE Ads Network , введите уникальное имя и включите медиацию . Включите автоматический сбор данных и введите имя пользователя и пароль, полученные в предыдущем разделе.

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

Включить безопасный обмен сигналами

Торги

Перейдите в раздел Администрирование > Глобальные настройки . Перейдите на вкладку настроек учетной записи Ad Exchange , просмотрите и включите параметр «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите LINE и включите интеграцию с приложением .

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

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

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка ставок в рекламной сети LINE

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

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

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

Нажмите «Готово» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Выберите компанию для рекламной сети LINE.

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

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

Водопад

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

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

Выберите компанию, которую вы создали для рекламной сети LINE в предыдущем разделе. В качестве типа интеграции выберите «Посредничество мобильного SDK» , в качестве платформы«Android» , а в качестве статуса«Активный» .

Введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматический сбор данных занимает несколько дней, прежде чем система сможет точно рассчитать значение динамического CPM для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

Шаг 3: Импортируйте SDK и адаптер рекламной сети LINE.

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

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

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

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

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

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

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

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

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

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

Адаптер рекламной сети LINE содержит вспомогательный метод для включения тестового режима для рекламной сети LINE. Необходимо установить этот параметр до инициализации SDK мобильной рекламы Google, чтобы обеспечить корректную переадресацию рекламы в SDK рекламной сети LINE.

Java

LineMediationAdapter.Companion.setTestMode(true);

Котлин

LineMediationAdapter.setTestMode(true)

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

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

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

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

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

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

Вот пример кода, демонстрирующий, как создать запрос на показ рекламы, который устанавливает эти параметры:

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

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

Котлин

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

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

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

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

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

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

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

коды ошибок

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

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

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

Код ошибки Домен Причина
1-10 com.five_corp.ad SDK рекламной сети LINE вернул ошибку, специфичную для SDK. Для получения более подробной информации см. документацию рекламной сети LINE.
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 SDK LINE Ads Network не смог показать промежуточную или платную рекламу.
106 com.google.ads.mediation.line Не удалось загрузить нативную рекламу из-за отсутствия необходимых ресурсов.

Список изменений адаптера LINE для медиации на Android

Версия 2.9.20251028.0

  • Подтверждена совместимость с версией FiveAd SDK 2.9.20251028.

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

  • Версия Google Mobile Ads SDK: 24.7.0.
  • Версия FiveAd SDK: 2.9.20251028.0

Версия 2.9.20250924.1

  • Удалены ссылки на Context на уровне класса. Это может помочь уменьшить проблемы с утечками памяти.

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

  • Версия Google Mobile Ads SDK: 24.7.0.
  • Версия FiveAd SDK 2.9.20250924.1.

Версия 2.9.20250924.0

  • Подтверждена совместимость с версией FiveAd SDK 2.9.20250924.

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

  • Версия Google Mobile Ads SDK: 24.6.0.
  • Версия FiveAd SDK: 2.9.20250924.0

Версия 2.9.20250718.0

  • Подтверждена совместимость с версией FiveAd SDK 2.9.20250718.

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

  • Версия Google Mobile Ads SDK: 24.3.0.
  • Версия FiveAd SDK 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

  • Обновлен минимально необходимый уровень Android API до 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.