В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из сети LINE Ads с помощью медиации , включая каскадную интеграцию. В нем рассказывается, как добавить LINE Ads Network в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер LINE Ads Network в приложение Unity.
Поддерживаемые интеграции и форматы объявлений
Адаптер медиации AdMob для рекламной сети LINE обладает следующими возможностями:
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден |
1 Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.
Требования
- Юнити 4 или выше
- Последняя версия Google Mobile Ads SDK
- [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для LINE Ads SDK 1.5.1 или более поздней версии ( рекомендуется последняя версия ).
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе сети LINE Ads.
Войдите в свою учетную запись LINE Ads Network.
Добавить новое приложение
Нажмите広告枠管理 (Управление рекламными местами) >メディア (Медиа) . Затем нажмите新規作成 (Создать новый) .
Заполните форму и нажмите登録 (Зарегистрироваться) .
Обратите внимание на идентификатор приложения.
Создать место размещения рекламы
Нажмите на идентификатор приложения, в которое вы хотите добавить место размещения рекламы. Затем выберите詳細 (Детали) .
Нажмитеスロット 追加 (Добавить слот) .
Заполните форму и нажмите (登録) Зарегистрироваться .
Обратите внимание на идентификатор слота.
Шаг 2. Настройте спрос в рекламной сети LINE в пользовательском интерфейсе AdMob.
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3. Импортируйте SDK и адаптер LINE Ads Network.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads LINE Ads Network Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.line
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
- Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads LINE Ads Network Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина посредничества Google Mobile Ads для сети LINE Ads по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsLineMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsLineMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Добавьте необходимый код
Андроид
Для интеграции LINE Ads Network не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации LINE Ads Network , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в AdMob.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления из сети LINE Ads Network, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений LINE Ads Network (Waterfall ).
Дополнительные шаги
Сетевые параметры
Плагин посредничества LINE Ads Network Unity поддерживает следующий дополнительный параметр запроса, который можно передать адаптеру через класс 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, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Вот коды и сопутствующие сообщения, выдаваемые адаптером LINE Ads Network, когда объявление не загружается:
Андроид
Код ошибки | Домен | Причина |
---|---|---|
1-10 | com.five_corp.ad | SDK LINE Ads Network вернул ошибку, специфичную для 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 | SDK LINE Ads Network вернул ошибку, специфичную для 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.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.