Интеграция линии с медиацией (бета-версия)

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

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

Поддерживаемые интеграции и форматы объявлений

Адаптер-посредник для Line имеет следующие возможности:

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

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

Требования

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

• Последняя версия Google Mobile Ads SDK

• Пройдите руководство по началу работы с медиацией

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

Войдите в свою учетную запись Line.

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

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

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

Обратите внимание на идентификатор приложения.

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

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

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

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

Примечание. Обратитесь к менеджеру своего аккаунта в сети Line Ads, чтобы получить доступ к созданию собственных мест размещения рекламы в пользовательском интерфейсе Line.

Обратите внимание на идентификатор слота.

Шаг 2. Настройте потребность в линии в Ad Manager пользовательский интерфейс

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

Войдите в свою учетную запись Менеджера рекламы .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» .

Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря « Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.

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

Если у вас уже есть партнер по доходности дляLine, вы можете выбрать его. В противном случае выберите Создать нового партнера по доходности .

ВыбиратьLine В качестве рекламной сети введите уникальное имя и включите посредничество .

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции .Android как Платформа и Активный как Статус . ВведитеApplication ID and Slot ID полученное в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Важно : Application ID должен быть связан с целевым приложением, как вLine Пользовательский интерфейс.

Когда закончите, нажмите «Сохранить» внизу страницы.

Шаг 3. Импортируйте Line SDK и адаптер.

Примечание. Невозможность интеграции совместимых версий Line и Google Mobile Ads 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")
}

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

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

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

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

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

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

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

Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.

Следуйте инструкциям в документации Line о том, как включить тестовые объявления Line.

Важно! Отключите тестовый режим для Менеджера рекламы и Line перед выпуском приложения.

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

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

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

Сетевые параметры

Адаптер Line поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса 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()

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

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

Линейный адаптер заполняет следующиеполядляNativeAd .

Поле	Ресурсы всегда включены в линейный адаптер
Заголовок
Изображение
Тело
Значок приложения	^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.