В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из LINE Ads Network с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить LINE Ads Network в конфигурацию медиации рекламного блока, а также как интегрировать LINE Ads Network SDK и адаптер в приложение для Android.
В интерфейсе панели управления LINE Ads Network надписи, кнопки и описания выполнены на японском языке. Скриншоты в данном руководстве не переведены. Однако в описаниях и инструкциях данного руководства надписи и кнопки переведены, а их эквиваленты на английском языке указаны в скобках.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации для LINE Ads Network имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Интерстициальный | |
Награжден | |
Родной | 1 |
1 Нативная реклама (для торгов) находится в стадии закрытого бета-тестирования. Обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.
Требования
- Android API уровня 23 или выше
Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.
Шаг 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 в пользовательском интерфейсе Менеджера рекламы
Войдите в свою учетную запись Менеджера рекламы .
Добавьте рекламную сеть LINE в компании
Торги
Этот шаг не требуется для интеграции торгов.
Водопад
Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .
Выберите рекламную сеть LINE Ads Network , введите уникальное имя и включите посредничество . Включите автоматический сбор данных и введите имя пользователя и пароль, полученные в предыдущем разделе.
Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.
Включить безопасный обмен сигналами
Торги
Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .
Водопад
Этот шаг не является обязательным для каскадной интеграции.
Поделиться защищенным сигналом в запросах ставок
Торги
Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите LINE и включите опцию «Включить интеграцию с приложением» .
Нажмите «Сохранить» .
Водопад
Этот шаг не является обязательным для каскадной интеграции.
Разрешить безопасный обмен сигналами для SDK Bidding
Торги
Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .
Нажмите «Сохранить» .
Водопад
Этот шаг не является обязательным для каскадной интеграции.
Настройка ставок в рекламной сети LINE
Торги
Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .
Нажмите кнопку «Новый участник торгов» .
Выберите LINE Ads Network в качестве поставщика ставок.
Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.
Нажмите Готово .
Водопад
Этот шаг не является обязательным для каскадной интеграции.
Настроить сопоставление рекламных блоков
Торги
Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .
Выберите компанию для рекламной сети LINE.
Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .
Выберите конкретный рекламный блок . Выберите рекламный блок и формат, выберите «Мобильное приложение» в качестве типа инвентаря и ваше мобильное приложение . Затем введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе. Нажмите «Сохранить» .
Водопад
Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» . Выберите мобильное приложение .
Прокрутите вниз и нажмите «Добавить партнера по доходности» .
Выберите компанию, созданную для рекламной сети LINE в предыдущем разделе. Выберите Mobile SDK mediation в качестве типа интеграции , Android в качестве платформы и Active в качестве статуса .
Введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .
Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.
Шаг 3: Импортируйте LINE Ads Network SDK и адаптер
Интеграция с Android Studio (рекомендуется)
В файл build.gradle.kts
уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии LINE Ads Network SDK и адаптера:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:line:2.9.20250718.0")
}
Ручная интеграция
Загрузите последнюю версию файла
.aar
LINE Ads Network SDK и добавьте его в свой проект.Перейдите к артефактам адаптера LINE Ads Network в репозитории Maven от Google. Выберите последнюю версию, скачайте
.aar
файл адаптера LINE Ads Network и добавьте его в свой проект.
Шаг 4: Добавьте необходимый код
Для интеграции LINE Ads Network дополнительный код не требуется.
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в Ad Manager.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от рекламной сети LINE, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений LINE Ads Network (Waterfall ).
Дополнительные шаги
Параметры, специфичные для сети
Адаптер LINE Ads Network поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса LineExtras
. Этот конструктор класса включает следующие параметры:
-
enableAdSound
-
boolean
, определяющее начальное состояние звука по умолчанию для баннеров, полноэкранной рекламы и рекламы с вознаграждением.
Вот пример кода, как создать запрос объявления, который задает эти параметры:
Ява
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Котлин
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.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
- Проверенная совместимость с 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
- Минимально требуемый уровень 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.