В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из LINE Ads Network с помощью медиации , охватывая каскадные интеграции. В нем описывается, как добавить LINE Ads Network в конфигурацию медиации рекламного блока и как интегрировать LINE Ads Network SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации Ad Manager для LINE Ads Network имеет следующие возможности:
Интеграция | |
---|---|
Торги | 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.
Добавить новое приложение
Нажмите広告枠管理 (Управление рекламными местами) >メディア (Медиа) . Затем нажмите新規作成 (Создать новый) .
Заполните форму и нажмите登録 (Зарегистрироваться) .
Запишите идентификатор приложения.
Создать рекламное место размещения
Нажмите на идентификатор приложения, в которое вы хотите добавить размещение рекламы. Затем выберите詳細 (Подробно) .
Нажмитеスロット 追加 (Добавить слот) .
Заполните форму для получения подробной информации о слоте. Для типа торгов выберите Standard , чтобы настроить этот слот для каскадной медиации, или Google SDK Bidding, чтобы настроить этот слот для торгов. Нажмите登録 (Register) после заполнения формы.
Обратите внимание на идентификатор слота .
Обновите свой app-ads.txt
Авторизованные продавцы приложений app-ads.txt — это инициатива IAB Tech Lab, которая помогает гарантировать, что ваш рекламный инвентарь приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам нужно будет внедрить файл app-ads.txt
. Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .
Чтобы реализовать app-ads.txt
для LINE Ads Network, см. раздел О файле app-ads.txt .
Шаг 2: Настройте спрос на рекламную сеть LINE Ads в пользовательском интерфейсе Менеджера объявлений
Настройте параметры медиации для вашего рекламного блока
андроид
Инструкции см. в шаге 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 .
На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM как реестр с ограниченной областью действия со следующими данными:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
- Область(ы):
com.google
Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.
Выберите пакет Google Mobile Ads Line Mediation и нажмите «Установить» .
Пакет «Единство»
Загрузите последнюю версию плагина-медиатора Google Mobile Ads для LINE Ads Network по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsLineMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный вами файл GoogleMobileAdsLineMediation.unitypackage
. Убедитесь, что выбраны все файлы, и нажмите Import .
Затем выберите 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 Ads Network, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений 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 | SDK LINE Ads Network не смог отобразить промежуточную или вознагражденную рекламу. |
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.