В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из LINE Ads Network с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить LINE Ads Network в конфигурацию медиации рекламного блока, а также как интегрировать LINE Ads Network SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер-медиатор AdMob для рекламной сети LINE обладает следующими возможностями:
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Баннер | |
Интерстициальный | |
Награжден |
1 Интеграция торгов находится на стадии закрытого бета-тестирования. Обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.
Требования
- Последняя версия Google Mobile Ads SDK
- Unity 4 или выше
- [Для торгов]: Чтобы интегрировать все поддерживаемые форматы объявлений в торги, используйте плагин медиации Google Mobile Ads для LINE Ads SDK 1.5.0 или выше ( рекомендуется последняя версия ).
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с использованием 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 в пользовательском интерфейсе AdMob
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3: Импортируйте LINE Ads Network SDK и адаптер
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads LINE Ads Network Mediation Plugin для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.line
OpenUPM
В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .
На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
- Область(ы):
com.google
Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.
Выберите пакет Google Mobile Ads Line Mediation и нажмите «Установить» .
Пакет Unity
Загрузите последнюю версию плагина медиации Google Mobile Ads для рекламной сети LINE по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsLineMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsLineMediation.unitypackage
. Убедитесь, что выбраны все файлы, и нажмите «Импорт» .
Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4: Добавьте необходимый код
Андроид
Для интеграции LINE Ads Network дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Следуйте документации LINE Ads Network , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от рекламной сети LINE, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений LINE Ads Network (Waterfall ).
Дополнительные шаги
Параметры, специфичные для сети
Плагин-медиатор Unity LINE Ads Network поддерживает следующий дополнительный параметр запроса, который можно передать адаптеру через класс LineMediationExtras
:
-
SetEnableAdSound(boolean)
: определяет начальное состояние звука по умолчанию для баннеров, межстраничной рекламы и рекламы с вознаграждением.
Вот пример кода, как создать запрос объявления, который задает эти параметры:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
Коды ошибок
Если адаптеру не удается получить рекламу от LINE Ads Network, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo
в следующих классах:
Андроид
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Ниже приведены коды и сопутствующие сообщения, выдаваемые адаптером 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 | Не удалось загрузить нативное объявление из-за отсутствия ресурсов. |
iOS
Код ошибки | Домен | Причина |
---|---|---|
1-10 | Отправлено LINE Ads Network SDK | LINE Ads Network SDK вернул ошибку, специфичную для SDK. Подробнее см. в документации LINE Ads Network. |
101 | com.google.ads.mediation.line | Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор слота). |
102 | com.google.ads.mediation.line | Запрошенный размер объявления не соответствует поддерживаемому размеру баннерной рекламы LINE Ads Network. |
103 | com.google.ads.mediation.line | Не удалось загрузить изображение информационного значка в нативное объявление. |
Журнал изменений плагина Line Unity Mediation
Версия 1.5.5
- Исправлена ошибка, из-за которой при установке через OpenUPM плагин не мог корректно импортировать пакеты.
Версия 1.5.4
- Поддерживает адаптер Line Android версии 2.9.20250519.0 .
- Поддерживает адаптер Line iOS версии 2.9.20250512.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.1.0.
Версия 1.5.3
- Плагин Unity теперь создан с использованием Android SDK 35.
- Поддерживает адаптер Line Android версии 2.9.20250317.1 .
- Поддерживает адаптер Line iOS версии 2.9.20241106.3 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.1.0.
Версия 1.5.2
- Поддерживает адаптер Line Android версии 2.9.20250110.0 .
- Поддерживает адаптер Line iOS версии 2.9.20241106.2 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.0.0.
Версия 1.5.1
- Поддерживает адаптер Line Android версии 2.9.20250110.0 .
- Поддерживает адаптер Line iOS версии 2.9.20241106.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.5.0.
Версия 1.5.0
- Поддерживает адаптер Line Android версии 2.9.20241129.0 .
- Поддерживает адаптер Line iOS версии 2.9.20241106.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.5.0.
Версия 1.4.0
- Поддерживает Line Android адаптер версии 2.8.20240827.0 .
- Поддерживает адаптер Line iOS версии 2.9.20241106.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.4.0.
Версия 1.3.1
- Поддерживает Line Android адаптер версии 2.8.20240808.0 .
- Поддерживает адаптер Line iOS версии 2.8.20240612.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.3.0
- Поддерживает адаптер Line Android версии 2.8.20240722.0 .
- Поддерживает адаптер Line iOS версии 2.8.20240612.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.2.0
- Поддерживает адаптер Line Android версии 2.7.20240515.0 .
- Поддерживает адаптер Line iOS версии 2.8.20240612.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 1.1.2
- Поддерживает адаптер Line Android версии 2.7.20240515.0 .
- Поддерживает адаптер Line iOS версии 2.7.20240411.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.1.1
- Поддерживает адаптер Line Android версии 2.7.20240214.1 .
- Поддерживает адаптер Line iOS версии 2.7.20240411.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.1.0
- Добавлен класс
LineMediationExtras
со следующими методами для поддержки передачи дополнительных посреднических данных.-
SetEnabledAdSound(bool)
-
- Поддерживает адаптер Line Android версии 2.7.20240214.1 .
- Поддерживает адаптер Line iOS версии 2.7.20240318.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 1.0.0
- Первоначальный выпуск.
- Поддерживает адаптер Line Android версии 2.6.20230607.0 .
- Поддерживает адаптер Line iOS версии 2.6.20230609.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.5.1.