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

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

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

Ad Manager Адаптер медиации для LINE Ads Network обладает следующими возможностями:

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

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

Требования

• Юнити 4 или выше
• Последняя версия Google Mobile Ads SDK
• Развертывание на Android
  • Android API уровня 21 или выше
• Развертывание на iOS
  • Цель развертывания iOS 12.0 или выше
• Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
• Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

OpenUPM-CLI

Важно! Если вы переходите с использования пакета .unitypackage на использование OpenUPM-CLI, вам необходимо вручную удалить ресурсы из старого местоположения, удалив все файлы из папки Assets/GoogleMobileAds/Mediation/Line .

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads LINE Ads Network Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.line

ОпенУПМ

Важно! Если вы переходите с использования пакета .unitypackage на использование OpenUPM, вам необходимо вручную удалить ресурсы из старого местоположения, удалив все файлы из папки Assets/GoogleMobileAds/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.

Важно: отключите тестовый режим для AdMob и рекламной сети LINE перед выпуском приложения.

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

Чтобы убедиться, что вы получаете тестовые объявления из сети 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.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.