В этом руководстве показано, как использовать Google Mobile Ads Flutter Plugin для загрузки и отображения объявлений из рекламной сети LY Ads Network с помощью медиации , включая интеграцию по принципу водопада. В нем рассматривается, как добавить LY Ads Network в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер LY Ads Network в приложение Flutter.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации Ad Manager для рекламной сети LY Ads Network обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Родной | |
Требования
- Новейший Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Целевая версия iOS для развертывания — 13.3 или выше.
- Рабочий Flutter-проект, настроенный с использованием Google Mobile Ads Flutter Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Flutter Plugin .
- Организуйте посредничество .
Шаг 1: Настройка параметров в пользовательском интерфейсе рекламной сети LY.
Зарегистрируйтесь и войдите в свой аккаунт в рекламной сети LY Ads Network.
Добавить новое приложение
Перейдите во вкладку «Приложение» и нажмите кнопку «Новая регистрация» .

Заполните форму и нажмите кнопку регистрации .

Запишите идентификатор приложения .
Android

iOS

Создать рекламный блок
На вкладке «Приложение» выберите свое приложение, чтобы просмотреть его подробную информацию. В разделе «Слот» нажмите «Добавить ».

Заполните форму, чтобы получить подробную информацию о слоте. В поле «Тип торгов» выберите «Стандартный» , чтобы настроить этот слот для каскадной медиации, или «Торги через Google SDK» , чтобы настроить этот слот для обычных торгов. После заполнения формы нажмите «Создать» .

Запишите идентификатор слота .

После создания первого рекламного места нажмите кнопку «Проверить» на странице с подробной информацией о вашем приложении, чтобы получить одобрение от LY Ads Network. Это может занять некоторое время. Если у вас возникнут вопросы, свяжитесь с представителем LY Ads Network.

Создайте ключ API для создания отчетов.
Перейдите на вкладку «Управление ключами API для создания отчетов» и нажмите кнопку «Создать ключ API» .

Заполните форму и нажмите «Сохранить» .

Запишите свой идентификатор API-ключа и секретный ключ API-ключа .

Обновите файл app-ads.txt.
Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .
Для внедрения файла app-ads.txt в рекламную сеть LY см. раздел «О файле app-ads.txt» .
Шаг 2: Настройте параметры рекламной сети LY Ads Network в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3: Импортируйте SDK и адаптер рекламной сети LY.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями SDK и адаптера LY Ads Network в файл pubspec.yaml вашего пакета:
dependencies:
gma_mediation_line: ^2.1.0
Ручная интеграция
Загрузите последнюю версию плагина Google Mobile Ads Mediation для рекламной сети LY Ads Network , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_line:
path: path/to/local/package
Шаг 4: Добавьте необходимый код
Android
Для интеграции с рекламной сетью LY Ads Network дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации LY Ads Network .
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от рекламной сети LY Ads Network, включите тестирование по одному источнику объявлений в инспекторе объявлений, используя источник(и) объявлений LY Ads Network .
Дополнительные шаги
Параметры, специфичные для сети
Плагин медиации Flutter для рекламной сети LY Ads Network поддерживает следующий дополнительный параметр запроса, который можно передать адаптеру через класс LineMediationExtras :
-
enableAdSound: Задает состояние начала воспроизведения звука по умолчанию для баннерной, межстраничной и рекламной рекламы с вознаграждением.
Вот пример кода, демонстрирующий, как создать запрос на показ рекламы, который устанавливает эти параметры:
LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [lineExtras],
);
коды ошибок
Если адаптер не получает объявление от рекламной сети LY Ads Network, издатели могут проверить основную причину ошибки в ответе на объявление, используя класс ResponseInfo из следующих разделов:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Вот коды и соответствующие сообщения, которые выдает адаптер рекламной сети LY Ads Network, когда реклама не загружается:
Android
| Код ошибки | Домен | Причина |
|---|---|---|
| 1-10 | com.five_corp.ad | SDK рекламной сети LY вернул ошибку, специфичную для SDK. Для получения более подробной информации см. документацию LY Ads Network. |
| 101 | com.google.ads.mediation.line | Отсутствует или недействителен идентификатор приложения. |
| 102 | com.google.ads.mediation.line | Отсутствует или недействителен идентификатор слота. |
| 103 | com.google.ads.mediation.line | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому рекламной сетью LY Ads Network. |
| 104 | com.google.ads.mediation.line | Не удалось загрузить межстраничную или рекламную заставку из-за отсутствия контекста активности. |
| 105 | com.google.ads.mediation.line | SDK LY Ads Network не смог показать промежуточную или платную рекламу. |
| 106 | com.google.ads.mediation.line | Не удалось загрузить нативную рекламу из-за отсутствия необходимых ресурсов. |
iOS
| Код ошибки | Домен | Причина |
|---|---|---|
| 1-10 | Отправлено с помощью SDK рекламной сети LY | SDK рекламной сети LY вернул ошибку, специфичную для SDK. Для получения более подробной информации см. документацию LY Ads Network. |
| 101 | com.google.ads.mediation.line | Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор слота). |
| 102 | com.google.ads.mediation.line | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому рекламной сетью LY Ads Network. |
| 103 | com.google.ads.mediation.line | Не удалось загрузить изображение информационного значка в нативной рекламе. |
Список изменений адаптера Line Flutter Mediation
Версия 2.1.1 (в разработке)
Версия 2.1.0
- Обновлена минимальная версия Flutter до 3.38.1.
- Обновлено для поддержки плагина Google Mobile Ads Flutter версии 8.0.0.
- Поддерживает адаптер Line для Android версии 3.1.0.0 .
- Поддерживает адаптер Line для iOS версии 3.0.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 8.0.0.
Версия 2.0.0
- Обновлена минимальная версия Flutter до 3.35.1.
- Обновлено для поддержки плагина Google Mobile Ads Flutter версии 7.0.0.
- Поддерживает адаптер Line для Android версии 3.0.1.0 .
- Поддерживает адаптер Line для iOS версии 3.0.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 7.0.0.
Версия 1.0.6
- Поддерживает адаптер Line Android версии 2.9.20251028.0 .
- Поддерживает адаптер Line для iOS версии 2.9.20251119.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.5
- Поддерживает адаптер Line для Android версии 2.9.20250924.1 .
- Поддерживает адаптер Line для iOS версии 2.9.20250930.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.4
- Поддерживает адаптер Line для Android версии 2.9.20250718.0 .
- Поддерживает адаптер Line для iOS версии 2.9.20250512.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.3
- Поддерживает адаптер Line для Android версии 2.9.20250519.0 .
- Поддерживает адаптер Line для iOS версии 2.9.20250512.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.2
- Поддерживает адаптер Line для Android версии 2.9.20250317.1 .
- Поддерживает адаптер Line для iOS версии 2.9.20241106.3 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.1
- Поддерживает адаптер Line Android версии 2.9.20250110.1 .
- Поддерживает адаптер Line для iOS версии 2.9.20241106.2 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.
Версия 1.0.0
- Первый релиз.
- Поддерживает адаптер Line Android версии 2.9.20250110.0 .
- Поддерживает адаптер Line для iOS версии 2.9.20241106.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.