В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Line с помощью медиации , включая каскадную интеграцию. В нем рассказывается, как добавить Line в конфигурацию медиации рекламного блока и как интегрировать Line SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы объявлений
Ad Manager Адаптер-посредник для Line имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | 1 |
Форматы | |
Баннер | |
Межстраничный | |
Награжден |
1Интеграция Waterfall находится на стадии закрытого бета-тестирования. Обратитесь к менеджеру своего аккаунта, чтобы запросить доступ.
Требования
- Юнити 4 или выше
- Последняя версия Google Mobile Ads SDK
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Line.
Войдите в свою учетную запись Line.
Добавить новое приложение
Нажмите広告枠管理 (Управление рекламными местами) >メディア (Медиа) . Затем нажмите新規作成 (Создать новый) .
Заполните форму и нажмите登録 (Зарегистрироваться) .
Обратите внимание на идентификатор приложения.
Создать место размещения рекламы
Нажмите на идентификатор приложения, в которое вы хотите добавить место размещения рекламы. Затем выберите詳細 (Детали) .
Нажмитеスロット 追加 (Добавить слот) .
Заполните форму и нажмите (登録) Зарегистрироваться .
Обратите внимание на идентификатор слота.
Шаг 2. Настройте потребность в линии в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Шаг 3. Импортируйте Line SDK и адаптер.
Загрузите последнюю версию подключаемого модуля медиации Google Mobile Ads для Line по ссылке для скачивания в журнале изменений и извлеките GoogleMobileAdsLineMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsLineMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Ресурсы» > «Resolver служб Play» > «Android Resolver» > «Принудительное разрешение» . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Добавьте необходимый код
Андроид
Для линейной интеграции не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации Line , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager.
Следуйте инструкциям в документации Line для Android и iOS о том, как включить тестовые объявления 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.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.