В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Line с помощью медиации , включая каскадную интеграцию. В нем рассказывается, как добавить Line в конфигурацию медиации рекламного блока и как интегрировать Line SDK и адаптер в приложение Android.
Интерфейс информационной панели рекламной сети LINE использует текст на японском языке для меток, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки переведены, а их английские эквиваленты указаны в скобках.
Поддерживаемые интеграции и форматы объявлений
Адаптер медиации для LINE Ads Network обладает следующими возможностями:
Интеграция | |
---|---|
Торги | |
Водопад | 1 |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Родной |
Требования
- Android API уровня 21 или выше
Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе сети LINE Ads.
Войдите в свою учетную запись LINE Ads Network.
Добавить новое приложение
Нажмите広告枠管理 (Управление рекламными местами) >メディア (Медиа) . Затем нажмите新規作成 (Создать новый) .
Заполните форму и нажмите登録 (Зарегистрироваться) .
Обратите внимание на идентификатор приложения.
Создать место размещения рекламы
Нажмите на идентификатор приложения, в которое вы хотите добавить место размещения рекламы. Затем выберите詳細 (Детали) .
Нажмитеスロット 追加 (Добавить слот) .
Заполните форму и нажмите (登録) Зарегистрироваться .
Обратите внимание на идентификатор слота.
Шаг 2. Настройте спрос в рекламной сети LINE в пользовательском интерфейсе Менеджера рекламы.
Войдите в свою учетную запись Менеджера рекламы .
Добавьте рекламную сеть LINE в компании
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Перейдите в «Администратор» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите Рекламную сеть .
Выберите LINE Ads Network в качестве рекламной сети , введите уникальное имя и включите посредничество .
Вам не нужно вводить имя пользователя или пароль . Нажмите «Сохранить», когда закончите.
Включить безопасный обмен сигналами
Торги
Перейдите в «Администратор» > «Глобальные настройки» . Перейдите на вкладку настроек аккаунта Ad Exchange , проверьте и включите параметр «Безопасный обмен сигналами» . Нажмите Сохранить .
Водопад
Этот шаг не требуется для каскадной интеграции.
Настройка ставок в рекламной сети LINE
Торги
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите «Новый участник торгов» на вкладке «Ставки SDK» .
Выберите рекламную сеть LINE в качестве участника торгов.
Включите параметр «Добавить библиотеку сигналов этой системы назначения ставок в список разрешенных сигналов» и «Разрешить передачу сигналов этой системе назначения ставок» . Затем нажмите Продолжить .
Нажмите Продолжить .
Нажмите Готово .
Водопад
Этот шаг не требуется для каскадной интеграции.
Настройка сопоставления рекламных блоков
Торги
Перейдите в раздел «Доставка» > «Покупатели» и выберите компанию для рекламной сети LINE на вкладке «Ставки SDK» .
Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Новое сопоставление рекламных блоков» .
Выберите Конкретный рекламный блок . Выберите рекламный блок и формат, Мобильное приложение в качестве типа инвентаря и свое мобильное приложение . Затем введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе. Наконец, нажмите «Сохранить» .
Водопад
Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» . Выберите свое мобильное приложение .
Прокрутите вниз и нажмите «Добавить партнера по доходности» .
Выберите компанию, которую вы создали для рекламной сети LINE в предыдущем разделе. Выберите «Медиация Mobile SDK» в качестве типа интеграции , Android в качестве платформы и «Активный» в качестве статуса .
Введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе, а также значение цены за тысячу показов по умолчанию . Нажмите Сохранить .
Шаг 3. Импортируйте SDK и адаптер LINE Ads Network.
Интеграция с Android Studio (рекомендуется)
В файле build.gradle.kts
уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии SDK и адаптера LINE Ads Network:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:line:2.9.20241129.0")
}
Ручная интеграция
Загрузите последнюю версию файла
.aar
LINE Ads Network SDK и добавьте его в свой проект.Перейдите к артефактам адаптера LINE Ads Network в репозитории Google Maven. Выберите последнюю версию, загрузите файл
.aar
адаптера LINE Ads Network и добавьте его в свой проект.
Шаг 4. Добавьте необходимый код
Для интеграции LINE Ads Network не требуется никакого дополнительного кода.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления из сети LINE Ads Network, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений 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 заполняет следующие поля для NativeAd
.
Поле | Ресурсы, всегда включенные в сетевой адаптер LINE Ads Network |
---|---|
Заголовок | |
Изображение | |
Тело | |
Значок приложения | 1 |
Призыв к действию | |
Звездный рейтинг | |
Магазин | |
Цена |
1 Для нативной рекламы SDK LINE Ads Network не предоставляет ресурс значка приложения. Вместо этого адаптер LINE Ads Network заполняет значок приложения прозрачным изображением.
Коды ошибок
Если адаптеру не удается получить объявление из рекламной сети LINE, вы можете проверить основную ошибку из ответа на объявление, используя ResponseInfo.getAdapterResponses()
в следующих классах:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
Вот коды и сопутствующие сообщения, выдаваемые адаптером LINE Ads Network, когда объявление не загружается:
Код ошибки | Домен | Причина |
---|---|---|
1-10 | com.five_corp.ad | SDK LINE Ads Network вернул ошибку, связанную с 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 | SDK LINE Ads Network не смог показать межстраничную рекламу или рекламу с вознаграждением. |
106 | com.google.ads.mediation.line | Не удалось загрузить нативное объявление из-за отсутствия ресурсов. |
Журнал изменений адаптера LINE Android Mediation
Следующая версия
- Исправлен процесс сбора сигналов.
Версия 2.9.20241129.0
- Добавлена поддержка ставок для форматов баннеров, межстраничных объявлений, объявлений с вознаграждением и нативной рекламы.
- Проверенная совместимость с FiveAd SDK версии 2.9.20241129.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.5.0.
- FiveAd SDK версии 2.9.20241129.0
Версия 2.8.20240827.0
- Проверенная совместимость с FiveAd SDK версии 2.8.20240827.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.3.0.
- FiveAd SDK версии 2.8.20240827.0
Версия 2.8.20240808.0
- Проверенная совместимость с FiveAd SDK версии 2.8.20240808.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.2.0.
- FiveAd SDK версии 2.8.20240808.0
Версия 2.8.20240722.0
- Проверенная совместимость с FiveAd SDK версии 2.8.20240722.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.2.0.
- FiveAd SDK версии 2.8.20240722.0
Версия 2.7.20240515.0
- Проверенная совместимость с FiveAd SDK версии 2.7.20240515.0.
Создан и протестирован с использованием:
- 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.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.0.0.
- FiveAd SDK версии 2.7.20240214.0.
Версия 2.7.20240214.0
- Проверена совместимость с FiveAd SDK версии 2.7.20240214.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.6.0.
- FiveAd SDK версии 2.7.20240214.0.
Версия 2.7.20240126.0
- Проверена совместимость с FiveAd SDK версии 2.7.20240126.0.
Создан и протестирован с использованием:
- 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.