Интегрированная линия с посредничеством (бета),Интегрированная линия с посредничеством (бета)

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

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

Ad Manager Адаптер-посредник для Line имеет следующие возможности:

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Андроид

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

iOS

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

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

OpenUPM-CLI

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

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Line 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 Mediation и нажмите «Установить» .

Пакет Единства

Загрузите последнюю версию плагина медиации Google Mobile Ads для Line по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsLineMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsLineMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .

Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Шаг 4. Добавьте необходимый код

Андроид

Для линейной интеграции не требуется никакого дополнительного кода.

iOS

Интеграция со SKAdNetwork

Следуйте документации Line , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

Шаг 5. Проверьте свою реализацию

Включить тестовые объявления

Обязательно зарегистрируйте тестовое устройство в AdMob.

Следуйте инструкциям в документации Line для Android и iOS о том, как включить тестовую рекламу Line.

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

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

Чтобы убедиться, что вы получаете тестовые объявления от Line, включите тестирование одного источника объявлений в Инспекторе объявлений, используя источники объявлений Line (Waterfall) .

Дополнительные шаги

Сетевые параметры

Плагин-посредник Line 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, когда объявление не загружается:

Андроид

Код ошибки	Домен	Причина
1-10	com.five_corp.ad	Line SDK вернул ошибку, специфичную для SDK. Дополнительную информацию см. в документации Line.
101	com.google.ads.mediation.line	Идентификатор приложения отсутствует или недействителен.
102	com.google.ads.mediation.line	Отсутствует или недействителен идентификатор слота.
103	com.google.ads.mediation.line	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Line.
104	com.google.ads.mediation.line	Не удалось загрузить межстраничное объявление или объявление с вознаграждением из-за отсутствия контекста активности.
105	com.google.ads.mediation.line	Line SDK не смог показать межстраничную рекламу или рекламу с вознаграждением.
106	com.google.ads.mediation.line	Не удалось загрузить нативное объявление из-за отсутствия ресурсов.

iOS

Код ошибки	Домен	Причина
1-10	Отправлено Line SDK	Line SDK вернул ошибку, специфичную для SDK. Дополнительную информацию см. в документации Line.
101	com.google.ads.mediation.line	Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор слота).
102	com.google.ads.mediation.line	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Line.
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.