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