В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из LINE Ads Network с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить LINE Ads Network в конфигурацию медиации рекламного блока, а также как интегрировать LINE Ads Network SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации Ad Manager для LINE Ads Network обладает следующими возможностями:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Интерстициальный | |
Награжден |
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 в пользовательском интерфейсе Менеджера рекламы
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 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: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в Ad Manager.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от рекламной сети 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.6
- Поддерживает адаптер Line Android версии 2.9.20250718.0 .
- Поддерживает адаптер Line iOS версии 2.9.20250512.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.3.0.
Версия 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.